Base Stream class. More...

#include <Stream.h>

Inheritance diagram for Stream:
[legend]
Collaboration diagram for Stream:
[legend]

Public Member Functions

virtual int available ()=0
 
virtual int peek ()=0
 
virtual int read ()=0
 
virtual void flush ()=0
 
 Stream ()
 
void setTimeout (unsigned long timeout)
 
bool find (char *target)
 
bool find (char *target, size_t length)
 
bool findUntil (char *target, char *terminator)
 
bool findUntil (char *target, size_t targetLen, char *terminate, size_t termLen)
 
long parseInt ()
 
float parseFloat ()
 
size_t readBytes (char *buffer, size_t length)
 
size_t readBytesUntil (char terminator, char *buffer, size_t length)
 
String readString ()
 
String readStringUntil (char terminator)
 
virtual int indexOf (char c)
 
int getWriteError ()
 Gets last error. More...
 
void clearWriteError ()
 Clears the last write error. More...
 
virtual size_t write (uint8_t)=0
 Writes a single character to output stream. More...
 
size_t write (const char *str)
 Writes a c-string to output stream. More...
 
virtual size_t write (const uint8_t *buffer, size_t size)
 Writes characters from a buffer to output stream. More...
 
size_t write (const char *buffer, size_t size)
 Writes characters from a buffer to output stream. More...
 
size_t print (char c)
 Prints a single character to output stream. More...
 
size_t print (const char str[])
 Prints a c-string to output stream. More...
 
size_t print (double num, int digits=2)
 Print a floating-point number to output stream. More...
 
size_t print (const Printable &p)
 Prints a Printable object to output stream. More...
 
size_t print (const String &s)
 Prints a String to output stream. More...
 
size_t println ()
 Prints a newline to output stream. More...
 
size_t println (const char str[])
 Prints a c-string to output stream, appending newline. More...
 
size_t println (char c)
 Prints a single character to output stream, appending newline. More...
 
size_t println (double num, int digits=2)
 Print a floating-point number to output stream, appending newline. More...
 
size_t println (const Printable &p)
 Prints a Printable object to output stream, appending newline. More...
 
size_t println (const String &s)
 Prints a String to output stream, appending newline. More...
 
size_t printf (const char *fmt,...) __attribute__((format(printf
 Prints a formatted c-string to output stream. More...
 
Print an integral number to output stream
Parameters
numNumber to print
baseThe base for output (Default: Decimal (base 10))
Return values
size_tQuantity of characters written to stream
size_t print (unsigned long num, int base=DEC)
 
size_t print (const unsigned long long &num, int base=DEC)
 
size_t print (long, int base=DEC)
 
size_t print (const long long &, int base=DEC)
 
size_t print (unsigned int num, int base=DEC)
 
size_t print (unsigned char num, int base=DEC)
 
size_t print (int num, int base=DEC)
 
Print an integral number to output stream, appending newline
Parameters
numNumber to print
baseThe base for output (Default: Decimal (base 10))
Return values
size_tQuantity of characters written to stream
size_t println (unsigned char num, int base=DEC)
 
size_t println (unsigned int num, int base=DEC)
 
size_t println (unsigned long num, int base=DEC)
 
size_t println (const unsigned long long &num, int base=DEC)
 
size_t println (int num, int base=DEC)
 
size_t println (long num, int base=DEC)
 
size_t println (const long long &num, int base=DEC)
 

Protected Member Functions

int timedRead ()
 
int timedPeek ()
 
int peekNextDigit ()
 
long parseInt (char skipChar)
 
float parseFloat (char skipChar)
 
void setWriteError (int err=1)
 

Protected Attributes

unsigned long receiveTimeout = 1000
 
unsigned long startMillis = 0
 

Detailed Description

Base Stream class.

Constructor & Destructor Documentation

◆ Stream()

Stream::Stream ( )
inline

Member Function Documentation

◆ available()

◆ clearWriteError()

void Print::clearWriteError ( )
inlineinherited

Clears the last write error.

◆ find() [1/2]

bool Stream::find ( char *  target)

◆ find() [2/2]

bool Stream::find ( char *  target,
size_t  length 
)

◆ findUntil() [1/2]

bool Stream::findUntil ( char *  target,
char *  terminator 
)

◆ findUntil() [2/2]

bool Stream::findUntil ( char *  target,
size_t  targetLen,
char *  terminate,
size_t  termLen 
)

◆ flush()

virtual void Stream::flush ( )
pure virtual

◆ getWriteError()

int Print::getWriteError ( )
inlineinherited

Gets last error.

Return values
intError number of last write error

◆ indexOf()

virtual int Stream::indexOf ( char  c)
inlinevirtual

Reimplemented in HardwareSerial.

◆ parseFloat() [1/2]

float Stream::parseFloat ( )

◆ parseFloat() [2/2]

float Stream::parseFloat ( char  skipChar)
protected

◆ parseInt() [1/2]

long Stream::parseInt ( )

◆ parseInt() [2/2]

long Stream::parseInt ( char  skipChar)
protected

◆ peek()

virtual int Stream::peek ( )
pure virtual

Implemented in HardwareSerial, IDataSourceStream, and TwoWire.

◆ peekNextDigit()

int Stream::peekNextDigit ( )
protected

◆ print() [1/12]

size_t Print::print ( char  c)
inlineinherited

Prints a single character to output stream.

Parameters
cCharacter to print
Return values
size_tQuantity of characters written to stream

◆ print() [2/12]

size_t Print::print ( const char  str[])
inlineinherited

Prints a c-string to output stream.

Parameters
strc-string to print
Return values
size_tQuantity of characters written to output stream

◆ print() [3/12]

size_t Print::print ( unsigned long  num,
int  base = DEC 
)
inlineinherited

◆ print() [4/12]

size_t Print::print ( const unsigned long long &  num,
int  base = DEC 
)
inlineinherited

◆ print() [5/12]

size_t Print::print ( long  ,
int  base = DEC 
)
inherited

◆ print() [6/12]

size_t Print::print ( const long long &  ,
int  base = DEC 
)
inherited

◆ print() [7/12]

size_t Print::print ( unsigned int  num,
int  base = DEC 
)
inlineinherited

◆ print() [8/12]

size_t Print::print ( unsigned char  num,
int  base = DEC 
)
inlineinherited

◆ print() [9/12]

size_t Print::print ( int  num,
int  base = DEC 
)
inlineinherited

◆ print() [10/12]

size_t Print::print ( double  num,
int  digits = 2 
)
inlineinherited

Print a floating-point number to output stream.

Parameters
numNumber to print
digitsThe decimal places to print (Default: 2, e.g. 21.35)
Return values
size_tQuantity of characters written to stream

◆ print() [11/12]

size_t Print::print ( const Printable p)
inlineinherited

Prints a Printable object to output stream.

Parameters
pObject to print
Return values
size_tQuantity of characters written to stream

◆ print() [12/12]

size_t Print::print ( const String s)
inlineinherited

Prints a String to output stream.

Parameters
sString to print
Return values
size_tQuantity of characters written to stream

◆ printf()

size_t Print::printf ( const char *  fmt,
  ... 
)
inherited

Prints a formatted c-string to output stream.

Parameters
fmtPointer to formated c-string to print
...Parameters for placeholders within formated string
Return values
size_tQuantity of characters written to stream
Note
Use standard printf placeholders, e.g. d for integer, s for c-string, etc.

◆ println() [1/13]

size_t Print::println ( )
inlineinherited

Prints a newline to output stream.

Return values
size_tQuantity of characters written to stream

◆ println() [2/13]

size_t Print::println ( const char  str[])
inlineinherited

Prints a c-string to output stream, appending newline.

Parameters
strc-string to print
Return values
size_tQuantity of characters written to stream

◆ println() [3/13]

size_t Print::println ( char  c)
inlineinherited

Prints a single character to output stream, appending newline.

Parameters
cCharacter to print
Return values
size_tQuantity of characters written to stream

◆ println() [4/13]

size_t Print::println ( unsigned char  num,
int  base = DEC 
)
inlineinherited

◆ println() [5/13]

size_t Print::println ( unsigned int  num,
int  base = DEC 
)
inlineinherited

◆ println() [6/13]

size_t Print::println ( unsigned long  num,
int  base = DEC 
)
inlineinherited

◆ println() [7/13]

size_t Print::println ( const unsigned long long &  num,
int  base = DEC 
)
inlineinherited

◆ println() [8/13]

size_t Print::println ( int  num,
int  base = DEC 
)
inlineinherited

◆ println() [9/13]

size_t Print::println ( long  num,
int  base = DEC 
)
inlineinherited

◆ println() [10/13]

size_t Print::println ( const long long &  num,
int  base = DEC 
)
inlineinherited

◆ println() [11/13]

size_t Print::println ( double  num,
int  digits = 2 
)
inlineinherited

Print a floating-point number to output stream, appending newline.

Parameters
numNumber to print
digitsThe decimal places to print (Default: 2, e.g. 21.35)
Return values
size_tQuantity of characters written to stream

◆ println() [12/13]

size_t Print::println ( const Printable p)
inlineinherited

Prints a Printable object to output stream, appending newline.

Parameters
pObject to print
Return values
size_tQuantity of characters written to stream

◆ println() [13/13]

size_t Print::println ( const String s)
inlineinherited

Prints a String to output stream, appending newline.

Parameters
sString to print
Return values
size_tQuantity of characters written to stream

◆ read()

virtual int Stream::read ( )
pure virtual

Implemented in HardwareSerial, IDataSourceStream, and TwoWire.

◆ readBytes()

size_t Stream::readBytes ( char *  buffer,
size_t  length 
)

◆ readBytesUntil()

size_t Stream::readBytesUntil ( char  terminator,
char *  buffer,
size_t  length 
)

◆ readString()

String Stream::readString ( )

◆ readStringUntil()

String Stream::readStringUntil ( char  terminator)

◆ setTimeout()

void Stream::setTimeout ( unsigned long  timeout)

◆ setWriteError()

void Print::setWriteError ( int  err = 1)
inlineprotectedinherited

◆ timedPeek()

int Stream::timedPeek ( )
protected

◆ timedRead()

int Stream::timedRead ( )
protected

◆ write() [1/4]

virtual size_t Print::write ( uint8_t  )
pure virtualinherited

Writes a single character to output stream.

Parameters
uint8_tCharacter to write to output stream
Return values
size_tQuantity of characters written to output stream

Implemented in IDataSourceStream, DebugClass, CircularBuffer, TwoWire, ReadWriteStream, and CommandOutput.

◆ write() [2/4]

size_t Print::write ( const char *  str)
inlineinherited

Writes a c-string to output stream.

Parameters
strPointer to c-string
Return values
size_tQuantity of characters written to stream

◆ write() [3/4]

virtual size_t Print::write ( const uint8_t *  buffer,
size_t  size 
)
virtualinherited

Writes characters from a buffer to output stream.

Parameters
bufferPointer to character buffer
sizeQuantity of characters to write
Return values
size_tQuantity of characters written to stream

Reimplemented in HardwareSerial, CircularBuffer, OtaUpgrade::BasicStream, FileStream, MemoryDataStream, HostFileStream, LimitedMemoryStream, TwoWire, GdbFileStream, EndlessMemoryStream, ReadWriteStream, and OtaUpgrade::EncryptedStream.

◆ write() [4/4]

size_t Print::write ( const char *  buffer,
size_t  size 
)
inlineinherited

Writes characters from a buffer to output stream.

Parameters
bufferPointer to character buffer
sizeQuantity of characters to write
Return values
size_tQuantity of characters written to stream

Member Data Documentation

◆ receiveTimeout

unsigned long Stream::receiveTimeout = 1000
protected

◆ startMillis

unsigned long Stream::startMillis = 0
protected

The documentation for this class was generated from the following file: