A circular buffer implementation that extends Arduino's Stream. More...

#include <RingBufferStream.h>

Inheritance diagram for esp32_psram::RingBufferStream< VectorType >:

Public Types
using	oneShotMs = esp8266::polledTimeout::oneShotFastMs
	Time management for stream operations.

enum class	Report { Success = 0 , TimedOut , ReadError , WriteError , ShortOperation }
	Status codes for stream transfer operations. More...

Public Member Functions
	RingBufferStream (size_t size)
	Constructor with specified buffer size. More...

int	available () override
	Get the number of bytes available for reading. More...

int	availableForWrite () override
	Get the number of bytes that can be written without blocking. More...

void	clearWriteError ()
	Clear the write error state.

bool	find (char target)
	Search for a single character in the stream. More...

bool	find (const char *target)
	Search for a string in the stream. More...

bool	find (const char *target, size_t length)
	Search for a string of given length in the stream. More...

bool	find (const uint8_t *target, size_t length)
	Search for a string of given length in the stream (uint8_t variant) More...

bool	find (uint8_t *target)
	Search for a string in the stream (uint8_t variant) More...

bool	findUntil (const char target, const char terminator)
	Search for a string until a terminator is found. More...

bool	findUntil (const char target, size_t targetLen, const char terminate, size_t termLen)
	Search for a string of given length until a terminator is found. More...

bool	findUntil (const uint8_t target, const char terminator)
	Search for a string until a terminator is found (uint8_t variant) More...

bool	findUntil (const uint8_t target, size_t targetLen, const char terminate, size_t termLen)
	Search for a string of given length until a terminator is found (uint8_t variant) More...

void	flush () override
	Clear the buffer, removing all content.

size_t	free () const
	Get the number of bytes still available in the buffer. More...

Report	getLastSendReport () const
	Get the result of the last send operation. More...

unsigned long	getTimeout () const
	Get the current timeout setting. More...

VectorType &	getVector ()
	Get direct access to the underlying vector. More...

const VectorType &	getVector () const
	Get const access to the underlying vector. More...

int	getWriteError ()
	Get the current write error state. More...

virtual bool	hasPeekBufferAPI () const
	Check if this stream implements the peek buffer API. More...

virtual bool	inputCanTimeout ()
	Check if input operations can timeout. More...

bool	isEmpty () const
	Check if the buffer is empty. More...

bool	isFull () const
	Check if the buffer is full. More...

virtual bool	outputCanTimeout ()
	Check if the output can timeout. More...

float	parseFloat ()
	Parse a float from the stream. More...

long	parseInt ()
	Parse an integer from the stream. More...

int	peek () override
	Look at the next byte in the buffer without removing it. More...

virtual size_t	peekAvailable ()
	Get the number of bytes available in the peek buffer. More...

virtual const char *	peekBuffer ()
	Get a pointer to the peek buffer. More...

virtual void	peekConsume (size_t consume)
	Consume bytes from the peek buffer. More...

size_t	print (char)
	Print a single character. More...

size_t size_t size_t	print (const __FlashStringHelper *)
	Print a flash string. More...

size_t	print (const char[])
	Print a null-terminated string. More...

size_t	print (const Printable &)
	Print a Printable object. More...

size_t	print (const String &)
	Print a String object. More...

size_t	print (double, int=2)
	Print a floating point value. More...

size_t	print (int, int=DEC)
	Print an integer value. More...

size_t	print (long long, int=DEC)
	Print a long long integer value. More...

size_t	print (long, int=DEC)
	Print a long integer value. More...

size_t	print (unsigned char, int=DEC)
	Print an unsigned byte value. More...

size_t	print (unsigned int, int=DEC)
	Print an unsigned integer value. More...

size_t	print (unsigned long long, int=DEC)
	Print an unsigned long long integer value. More...

size_t	print (unsigned long, int=DEC)
	Print an unsigned long integer value. More...

size_t	printf (const char *format,...) __attribute__((format(printf
	Print formatted data (printf style) More...

size_t size_t	printf_P (PGM_P format,...) __attribute__((format(printf
	Print formatted data from program memory (printf style) More...

size_t	println (char)
	Print a single character followed by a newline. More...

size_t	println (const __FlashStringHelper *)
	Print a flash string followed by a newline. More...

size_t	println (const char[])
	Print a null-terminated string followed by a newline. More...

size_t	println (const Printable &)
	Print a Printable object followed by a newline. More...

size_t	println (const String &s)
	Print a String object followed by a newline. More...

size_t	println (double, int=2)
	Print a floating point value followed by a newline. More...

size_t	println (int, int=DEC)
	Print an integer value followed by a newline. More...

size_t	println (long long, int=DEC)
	Print a long long integer value followed by a newline. More...

size_t	println (long, int=DEC)
	Print a long integer value followed by a newline. More...

size_t	println (unsigned char, int=DEC)
	Print an unsigned byte value followed by a newline. More...

size_t	println (unsigned int, int=DEC)
	Print an unsigned integer value followed by a newline. More...

size_t	println (unsigned long long, int=DEC)
	Print an unsigned long long integer value followed by a newline. More...

size_t	println (unsigned long, int=DEC)
	Print an unsigned long integer value followed by a newline. More...

size_t	println (void)
	Print just a newline. More...

template<>
size_t	printNumber (double number, uint8_t digits)
	Specialized template for printing floating point numbers. More...

int	read () override
	Read a byte from the buffer. More...

int	read (char *buffer, size_t len)
	Read multiple bytes from the stream (char variant) More...

virtual int	read (uint8_t *buffer, size_t len)
	Read multiple bytes from the stream. More...

size_t	readBytes (char *buffer, size_t size) override
	Read multiple bytes from the buffer. More...

size_t	readBytes (uint8_t *buffer, size_t size)
	Read multiple bytes from the buffer. More...

size_t	readBytesUntil (char terminator, char *buffer, size_t length)
	Read bytes until a terminator character is found. More...

size_t	readBytesUntil (char terminator, uint8_t *buffer, size_t length)
	Read bytes until a terminator character is found (uint8_t variant) More...

virtual String	readString ()
	Read a string from the stream. More...

String	readStringUntil (char terminator)
	Read a string until a terminator character is found. More...

String	readStringUntil (const char *terminator, uint32_t untilTotalNumberOfOccurrences=1)
	Read a string until a terminator string is found a specific number of times. More...

size_t	sendAll (Print &to, const oneShotMs::timeType timeoutMs=oneShotMs::neverExpires)
	Transfer all data with timeout (deprecated) More...

size_t	sendAll (Print *to, const oneShotMs::timeType timeoutMs=oneShotMs::neverExpires)
	Transfer all data with timeout (deprecated) More...

size_t	sendAll (Stream &&to, const oneShotMs::timeType timeoutMs=oneShotMs::neverExpires)
	Transfer all data with timeout. More...

size_t	sendAll (Stream &to, const oneShotMs::timeType timeoutMs=oneShotMs::neverExpires)
	Transfer all data with timeout. More...

size_t	sendAll (Stream *to, const oneShotMs::timeType timeoutMs=oneShotMs::neverExpires)
	Transfer all data with timeout. More...

size_t	sendAvailable (Print &to)
	Transfer available data without waiting (deprecated) More...

size_t	sendAvailable (Print *to)
	Transfer available data without waiting (deprecated) More...

size_t	sendAvailable (Stream &&to)
	Transfer available data without waiting. More...

size_t	sendAvailable (Stream &to)
	Transfer available data without waiting. More...

size_t	sendAvailable (Stream *to)
	Transfer available data without waiting. More...

size_t	sendSize (Print &to, const ssize_t maxLen, const oneShotMs::timeType timeoutMs=oneShotMs::neverExpires)
	Transfer a specific amount of data with timeout (deprecated) More...

size_t	sendSize (Print *to, const ssize_t maxLen, const oneShotMs::timeType timeoutMs=oneShotMs::neverExpires)
	Transfer a specific amount of data with timeout (deprecated) More...

size_t	sendSize (Stream &&to, const ssize_t maxLen, const oneShotMs::timeType timeoutMs=oneShotMs::neverExpires)
	Transfer a specific amount of data with timeout. More...

size_t	sendSize (Stream &to, const ssize_t maxLen, const oneShotMs::timeType timeoutMs=oneShotMs::neverExpires)
	Transfer a specific amount of data with timeout. More...

size_t	sendSize (Stream *to, const ssize_t maxLen, const oneShotMs::timeType timeoutMs=oneShotMs::neverExpires)
	Transfer a specific amount of data with timeout. More...

size_t	sendUntil (Print &to, const int readUntilChar, const oneShotMs::timeType timeoutMs=oneShotMs::neverExpires)
	Transfer data until a specific character is found (deprecated) More...

size_t	sendUntil (Print *to, const int readUntilChar, const oneShotMs::timeType timeoutMs=oneShotMs::neverExpires)
	Transfer data until a specific character is found (deprecated) More...

size_t	sendUntil (Stream &&to, const int readUntilChar, const oneShotMs::timeType timeoutMs=oneShotMs::neverExpires)
	Transfer data until a specific character is found. More...

size_t	sendUntil (Stream &to, const int readUntilChar, const oneShotMs::timeType timeoutMs=oneShotMs::neverExpires)
	Transfer data until a specific character is found. More...

size_t	sendUntil (Stream *to, const int readUntilChar, const oneShotMs::timeType timeoutMs=oneShotMs::neverExpires)
	Transfer data until a specific character is found. More...

void	setTimeout (unsigned long timeout)
	Set the timeout for stream operations. More...

size_t	size () const
	Get the total capacity of the buffer. More...

virtual ssize_t	streamRemaining ()
	Get the number of bytes remaining in the stream. More...

size_t	used () const
	Get the number of bytes currently in the buffer. More...

size_t	write (char c)
	Write a char value as a byte. More...

size_t	write (const char *buffer, size_t size)
	Write a buffer of characters to the output. More...

size_t	write (const char *str)
	Write a null-terminated string to the output. More...

size_t	write (const uint8_t *data, size_t size)
	Write multiple bytes to the buffer. More...

size_t	write (int t)
	Write an int value as a byte. More...

size_t	write (int8_t c)
	Write a signed byte as an unsigned byte. More...

size_t	write (long long t)
	Write a long long value as a byte. More...

size_t	write (long t)
	Write a long value as a byte. More...

size_t	write (short t)
	Write a short value as a byte. More...

size_t	write (uint8_t value) override
	Write a byte to the buffer. More...

size_t	write (unsigned int t)
	Write an unsigned int value as a byte. More...

size_t	write (unsigned long long t)
	Write an unsigned long long value as a byte. More...

size_t	write (unsigned long t)
	Write an unsigned long value as a byte. More...

size_t	write (unsigned short t)
	Write an unsigned short value as a byte. More...

Static Public Attributes
static constexpr int	temporaryStackBufferSize = 64
	Size of temporary stack buffer for stream transfers.

Protected Member Functions
float	parseFloat (char skipChar)
	Parse a float with custom skip character. More...

long	parseInt (char skipChar)
	Parse an integer with custom skip character. More...

int	peekNextDigit (bool detectDecimal=false)
	Peek at the next digit in the stream. More...

size_t	sendGeneric (Print *to, const ssize_t len=-1, const int readUntilChar=-1, oneShotMs::timeType timeoutMs=oneShotMs::neverExpires)
	Generic transfer method for Print objects (deprecated) More...

size_t	sendGeneric (Stream *to, const ssize_t len=-1, const int readUntilChar=-1, oneShotMs::timeType timeoutMs=oneShotMs::neverExpires)
	Generic transfer method for Stream objects. More...

size_t	SendGenericPeekBuffer (Print *to, const ssize_t len, const int readUntilChar, const oneShotMs::timeType timeoutMs)
	Transfer using peek buffer API. More...

size_t	SendGenericRegular (Print *to, const ssize_t len, const oneShotMs::timeType timeoutMs)
	Transfer using regular read. More...

size_t	SendGenericRegularUntil (Print *to, const ssize_t len, const int readUntilChar, const oneShotMs::timeType timeoutMs)
	Transfer using regular read until character. More...

void	setReport (Report report)
	Set the result of a send operation. More...

void	setWriteError (int err=1)
	Set the write error flag. More...

int	timedPeek ()
	Peek at the next character with timeout. More...

int	timedRead ()
	Read a character with timeout. More...

Protected Attributes
unsigned long	_startMillis
	Used for timeout measurement.

unsigned long	_timeout = 1000
	Number of milliseconds to wait for the next char before aborting timed read.

Detailed Description

template<typename VectorType>
class esp32_psram::RingBufferStream< VectorType >

A circular buffer implementation that extends Arduino's Stream.

Template Parameters

VectorType The vector type to use as underlying storage

This class implements a ring buffer (circular buffer) that uses a vector container for storage. It extends Arduino's Stream class to provide standard stream functionality. The buffer can be used with any vector type, including VectorPSRAM and VectorHIMEM.

Member Enumeration Documentation

◆ Report

enum Stream::Report

stronginherited

Status codes for stream transfer operations.

Enumerator
Success	Operation completed successfully.
TimedOut	Operation timed out.
ReadError	Error reading from source.
WriteError	Error writing to destination.
ShortOperation	Operation completed but transferred less than requested.

Constructor & Destructor Documentation

◆ RingBufferStream()

template<typename VectorType >

esp32_psram::RingBufferStream< VectorType >::RingBufferStream ( size_t size )

inline

Constructor with specified buffer size.

Parameters

size	The size of the buffer in bytes

Member Function Documentation

◆ available()

template<typename VectorType >

int esp32_psram::RingBufferStream< VectorType >::available ( )

inlineoverridevirtual

Get the number of bytes available for reading.

Returns: Number of bytes available

Implements Stream.

◆ availableForWrite()

template<typename VectorType >

int esp32_psram::RingBufferStream< VectorType >::availableForWrite ( )

inlineoverridevirtual

Get the number of bytes that can be written without blocking.

Returns: Number of bytes available for writing

Reimplemented from Print.

◆ find() [1/5]

bool Stream::find ( char target )

inlineinherited

Search for a single character in the stream.

Parameters

target Character to search for

Returns: true if found, false if timed out

◆ find() [2/5]

bool Stream::find ( const char * target )

inherited

Search for a string in the stream.

Parameters

target The string to search for

Returns: true if found, false if timed out

◆ find() [3/5]

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

inherited

Search for a string of given length in the stream.

Parameters

target	The string to search for
length	Length of the target string

Returns: true if found, false if timed out

◆ find() [4/5]

bool Stream::find	(	const uint8_t *	target,
		size_t	length
	)

inlineinherited

Search for a string of given length in the stream (uint8_t variant)

Parameters

target	The string to search for
length	Length of the target string

Returns: true if found, false if timed out

◆ find() [5/5]

bool Stream::find ( uint8_t * target )

inlineinherited

Search for a string in the stream (uint8_t variant)

Parameters

target The string to search for

Returns: true if found, false if timed out

◆ findUntil() [1/4]

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

inherited

Search for a string until a terminator is found.

Parameters

target	The string to search for
terminator	String that terminates the search

Returns: true if target found, false if timed out or terminator found first

◆ findUntil() [2/4]

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

inherited

Search for a string of given length until a terminator is found.

Parameters

target	The string to search for
targetLen	Length of the target string
terminate	String that terminates the search
termLen	Length of the terminator string

Returns: true if target found, false if timed out or terminator found first

◆ findUntil() [3/4]

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

inlineinherited

Search for a string until a terminator is found (uint8_t variant)

Parameters

target	The string to search for
terminator	String that terminates the search

Returns: true if target found, false if timed out or terminator found first

◆ findUntil() [4/4]

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

inlineinherited

Search for a string of given length until a terminator is found (uint8_t variant)

Parameters

target	The string to search for
targetLen	Length of the target string
terminate	String that terminates the search
termLen	Length of the terminator string

Returns: true if target found, false if timed out or terminator found first

◆ free()

template<typename VectorType >

size_t esp32_psram::RingBufferStream< VectorType >::free ( ) const

inline

Get the number of bytes still available in the buffer.

Returns: Number of free bytes in the buffer

◆ getLastSendReport()

Report Stream::getLastSendReport ( ) const

inlineinherited

Get the result of the last send operation.

Returns: Status code indicating success or failure reason

◆ getTimeout()

unsigned long Stream::getTimeout ( ) const

inlineinherited

Get the current timeout setting.

Returns: Current timeout in milliseconds

◆ getVector() [1/2]

template<typename VectorType >

VectorType& esp32_psram::RingBufferStream< VectorType >::getVector ( )

inline

Get direct access to the underlying vector.

Returns: Reference to the underlying vector

◆ getVector() [2/2]

template<typename VectorType >

const VectorType& esp32_psram::RingBufferStream< VectorType >::getVector ( ) const

inline

Get const access to the underlying vector.

Returns: Const reference to the underlying vector

◆ getWriteError()

int Print::getWriteError ( )

inlineinherited

Get the current write error state.

Returns: Current error code (0 = no error)

◆ hasPeekBufferAPI()

virtual bool Stream::hasPeekBufferAPI ( ) const

inlinevirtualinherited

Check if this stream implements the peek buffer API.

Returns: true if peek buffer API is available, false otherwise

◆ inputCanTimeout()

virtual bool Stream::inputCanTimeout ( )

inlinevirtualinherited

Check if input operations can timeout.

Returns: true if input operations can timeout, false otherwise

◆ isEmpty()

template<typename VectorType >

bool esp32_psram::RingBufferStream< VectorType >::isEmpty ( ) const

inline

Check if the buffer is empty.

Returns: true if the buffer is empty, false otherwise

◆ isFull()

template<typename VectorType >

bool esp32_psram::RingBufferStream< VectorType >::isFull ( ) const

inline

Check if the buffer is full.

Returns: true if the buffer is full, false otherwise

◆ outputCanTimeout()

virtual bool Print::outputCanTimeout ( )

inlinevirtualinherited

Check if the output can timeout.

By default, write operations can timeout (like for network or serial). Child classes can override this to false (like String).

Returns: true if output operations can timeout, false otherwise

◆ parseFloat() [1/2]

float Stream::parseFloat ( )

inherited

Parse a float from the stream.

Returns: The first valid floating point value from the current position

Note: Skips non-digit characters and stops at first non-digit after a number

◆ parseFloat() [2/2]

float Stream::parseFloat ( char skipChar )

protectedinherited

Parse a float with custom skip character.

Parameters

skipChar Character to ignore during parsing

Returns: The parsed float value

◆ parseInt() [1/2]

long Stream::parseInt ( )

inherited

Parse an integer from the stream.

Returns: The first valid integer value from the current position

Note: Skips non-digit characters and stops at first non-digit after a number

◆ parseInt() [2/2]

long Stream::parseInt ( char skipChar )

protectedinherited

Parse an integer with custom skip character.

Parameters

skipChar Character to ignore during parsing

Returns: The parsed integer value

◆ peek()

template<typename VectorType >

int esp32_psram::RingBufferStream< VectorType >::peek ( )

inlineoverridevirtual

Look at the next byte in the buffer without removing it.

Returns: The next byte to be read, or -1 if the buffer is empty

Implements Stream.

◆ peekAvailable()

virtual size_t Stream::peekAvailable ( )

inlinevirtualinherited

Get the number of bytes available in the peek buffer.

Returns: Number of bytes available

◆ peekBuffer()

virtual const char* Stream::peekBuffer ( )

inlinevirtualinherited

Get a pointer to the peek buffer.

Returns: Pointer to the peek buffer, or nullptr if not available

Note: Don't call read() between peekBuffer() and peekConsume()

◆ peekConsume()

virtual void Stream::peekConsume ( size_t consume )

inlinevirtualinherited

Consume bytes from the peek buffer.

Parameters

consume Number of bytes to consume

◆ peekNextDigit()

int Stream::peekNextDigit ( bool detectDecimal = false )

protectedinherited

Peek at the next digit in the stream.

Parameters

detectDecimal Whether to consider decimal points as valid parts of numbers

Returns: The next numeric digit or -1 if timeout or non-digit

◆ print() [1/13]

size_t Print::print ( char )

inherited

Print a single character.

Parameters

c	Character to print

Returns: Number of bytes written

◆ print() [2/13]

size_t size_t size_t Print::print ( const __FlashStringHelper * )

inherited

Print a flash string.

Parameters

str	Flash string to print

Returns: Number of bytes written

◆ print() [3/13]

size_t Print::print ( const char [] )

inherited

Print a null-terminated string.

Parameters

str	String to print

Returns: Number of bytes written

◆ print() [4/13]

size_t Print::print ( const Printable & )

inherited

Print a Printable object.

Parameters

obj	Object to print

Returns: Number of bytes written

◆ print() [5/13]

size_t Print::print ( const String & )

inherited

Print a String object.

Parameters

s	String to print

Returns: Number of bytes written

◆ print() [6/13]

size_t Print::print	(	double	,
		int	= `2`
	)

inherited

Print a floating point value.

Parameters

n	Value to print
digits	Number of decimal places to display (default: 2)

Returns: Number of bytes written

◆ print() [7/13]

size_t Print::print	(	int	,
		int	= `DEC`
	)

inherited

Print an integer value.

Parameters

n	Value to print
base	Number base to use (default: DEC)

Returns: Number of bytes written

◆ print() [8/13]

size_t Print::print	(	long long	,
		int	= `DEC`
	)

inherited

Print a long long integer value.

Parameters

n	Value to print
base	Number base to use (default: DEC)

Returns: Number of bytes written

◆ print() [9/13]

size_t Print::print	(	long	,
		int	= `DEC`
	)

inherited

Print a long integer value.

Parameters

n	Value to print
base	Number base to use (default: DEC)

Returns: Number of bytes written

◆ print() [10/13]

size_t Print::print	(	unsigned char	,
		int	= `DEC`
	)

inherited

Print an unsigned byte value.

Parameters

b	Value to print
base	Number base to use (default: DEC)

Returns: Number of bytes written

◆ print() [11/13]

size_t Print::print	(	unsigned int	,
		int	= `DEC`
	)

inherited

Print an unsigned integer value.

Parameters

n	Value to print
base	Number base to use (default: DEC)

Returns: Number of bytes written

◆ print() [12/13]

size_t Print::print	(	unsigned long long	,
		int	= `DEC`
	)

inherited

Print an unsigned long long integer value.

Parameters

n	Value to print
base	Number base to use (default: DEC)

Returns: Number of bytes written

◆ print() [13/13]

size_t Print::print	(	unsigned long	,
		int	= `DEC`
	)

inherited

Print an unsigned long integer value.

Parameters

n	Value to print
base	Number base to use (default: DEC)

Returns: Number of bytes written

◆ printf()

size_t Print::printf	(	const char *	format,
			...
	)

inherited

Print formatted data (printf style)

Parameters

format	Format string
...	Variable arguments for format string

Returns: Number of bytes written

◆ printf_P()

size_t size_t Print::printf_P	(	PGM_P	format,
			...
	)

inherited

Print formatted data from program memory (printf style)

Parameters

format	Format string in program memory
...	Variable arguments for format string

Returns: Number of bytes written

◆ println() [1/14]

size_t Print::println ( char )

inherited

Print a single character followed by a newline.

Parameters

c	Character to print

Returns: Number of bytes written

◆ println() [2/14]

size_t Print::println ( const __FlashStringHelper * )

inherited

Print a flash string followed by a newline.

Parameters

str	Flash string to print

Returns: Number of bytes written

◆ println() [3/14]

size_t Print::println ( const char [] )

inherited

Print a null-terminated string followed by a newline.

Parameters

str	String to print

Returns: Number of bytes written

◆ println() [4/14]

size_t Print::println ( const Printable & )

inherited

Print a Printable object followed by a newline.

Parameters

obj	Object to print

Returns: Number of bytes written

◆ println() [5/14]

size_t Print::println ( const String & s )

inherited

Print a String object followed by a newline.

Parameters

s	String to print

Returns: Number of bytes written

◆ println() [6/14]

size_t Print::println	(	double	,
		int	= `2`
	)

inherited

Print a floating point value followed by a newline.

Parameters

n	Value to print
digits	Number of decimal places to display (default: 2)

Returns: Number of bytes written

◆ println() [7/14]

size_t Print::println	(	int	,
		int	= `DEC`
	)

inherited

Print an integer value followed by a newline.

Parameters

n	Value to print
base	Number base to use (default: DEC)

Returns: Number of bytes written

◆ println() [8/14]

size_t Print::println	(	long long	,
		int	= `DEC`
	)

inherited

Print a long long integer value followed by a newline.

Parameters

n	Value to print
base	Number base to use (default: DEC)

Returns: Number of bytes written

◆ println() [9/14]

size_t Print::println	(	long	,
		int	= `DEC`
	)

inherited

Print a long integer value followed by a newline.

Parameters

n	Value to print
base	Number base to use (default: DEC)

Returns: Number of bytes written

◆ println() [10/14]

size_t Print::println	(	unsigned char	,
		int	= `DEC`
	)

inherited

Print an unsigned byte value followed by a newline.

Parameters

b	Value to print
base	Number base to use (default: DEC)

Returns: Number of bytes written

◆ println() [11/14]

size_t Print::println	(	unsigned int	,
		int	= `DEC`
	)

inherited

Print an unsigned integer value followed by a newline.

Parameters

n	Value to print
base	Number base to use (default: DEC)

Returns: Number of bytes written

◆ println() [12/14]

size_t Print::println	(	unsigned long long	,
		int	= `DEC`
	)

inherited

Print an unsigned long long integer value followed by a newline.

Parameters

n	Value to print
base	Number base to use (default: DEC)

Returns: Number of bytes written

◆ println() [13/14]

size_t Print::println	(	unsigned long	,
		int	= `DEC`
	)

inherited

Print an unsigned long integer value followed by a newline.

Parameters

n	Value to print
base	Number base to use (default: DEC)

Returns: Number of bytes written

◆ println() [14/14]

size_t Print::println ( void )

inherited

Print just a newline.

Returns: Number of bytes written

◆ printNumber()

template<>

size_t Print::printNumber	(	double	number,
		uint8_t	digits
	)

inherited

Specialized template for printing floating point numbers.

Parameters

number	The floating point number to print
digits	The number of decimal places to display

Returns: Number of bytes written

◆ read() [1/3]

template<typename VectorType >

int esp32_psram::RingBufferStream< VectorType >::read ( )

inlineoverridevirtual

Read a byte from the buffer.

Returns: The byte read, or -1 if the buffer is empty

Implements Stream.

◆ read() [2/3]

int Stream::read	(	char *	buffer,
		size_t	len
	)

inlineinherited

Read multiple bytes from the stream (char variant)

Parameters

buffer	Buffer to store the data
len	Maximum number of bytes to read

Returns: Number of bytes read

◆ read() [3/3]

virtual int Stream::read	(	uint8_t *	buffer,
		size_t	len
	)

virtualinherited

Read multiple bytes from the stream.

Parameters

buffer	Buffer to store the data
len	Maximum number of bytes to read

Returns: Number of bytes read

◆ readBytes() [1/2]

template<typename VectorType >

size_t esp32_psram::RingBufferStream< VectorType >::readBytes	(	char *	buffer,
		size_t	size
	)

inlineoverridevirtual

Read multiple bytes from the buffer.

Parameters

buffer	Buffer to store the read data
size	Maximum number of bytes to read

Returns: Number of bytes actually read

Reimplemented from Stream.

◆ readBytes() [2/2]

template<typename VectorType >

size_t esp32_psram::RingBufferStream< VectorType >::readBytes	(	uint8_t *	buffer,
		size_t	size
	)

inlinevirtual

Read multiple bytes from the buffer.

Parameters

buffer	Buffer to store the read data
size	Maximum number of bytes to read

Returns: Number of bytes actually read

Reimplemented from Stream.

◆ readBytesUntil() [1/2]

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

inherited

Read bytes until a terminator character is found.

Parameters

terminator	Character that terminates the read
buffer	Buffer to store the data
length	Maximum number of bytes to read

Returns: Number of bytes read (0 means no valid data found)

◆ readBytesUntil() [2/2]

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

inlineinherited

Read bytes until a terminator character is found (uint8_t variant)

Parameters

terminator	Character that terminates the read
buffer	Buffer to store the data
length	Maximum number of bytes to read

Returns: Number of bytes read (0 means no valid data found)

◆ readString()

virtual String Stream::readString ( )

virtualinherited

Read a string from the stream.

Returns: String containing the data read

◆ readStringUntil() [1/2]

String Stream::readStringUntil ( char terminator )

inherited

Read a string until a terminator character is found.

Parameters

terminator Character that terminates the read

Returns: String containing the data read

◆ readStringUntil() [2/2]

String Stream::readStringUntil	(	const char *	terminator,
		uint32_t	untilTotalNumberOfOccurrences = `1`
	)

inherited

Read a string until a terminator string is found a specific number of times.

Parameters

terminator	String that terminates the read
untilTotalNumberOfOccurrences	Number of times the terminator must be found

Returns: String containing the data read

◆ sendAll() [1/5]

size_t Stream::sendAll	(	Print &	to,
		const oneShotMs::timeType	timeoutMs = `oneShotMs::neverExpires`
	)

inlineinherited

Transfer all data with timeout (deprecated)

Parameters

to	Destination stream
timeoutMs	Timeout in milliseconds

Returns: Number of bytes transferred

Deprecated:: Use the Stream* variant instead

◆ sendAll() [2/5]

size_t Stream::sendAll	(	Print *	to,
		const oneShotMs::timeType	timeoutMs = `oneShotMs::neverExpires`
	)

inlineinherited

Transfer all data with timeout (deprecated)

Parameters

to	Destination stream
timeoutMs	Timeout in milliseconds

Returns: Number of bytes transferred

Deprecated:: Use the Stream* variant instead

◆ sendAll() [3/5]

size_t Stream::sendAll	(	Stream &&	to,
		const oneShotMs::timeType	timeoutMs = `oneShotMs::neverExpires`
	)

inlineinherited

Transfer all data with timeout.

Parameters

to	Destination stream
timeoutMs	Timeout in milliseconds

Returns: Number of bytes transferred

◆ sendAll() [4/5]

size_t Stream::sendAll	(	Stream &	to,
		const oneShotMs::timeType	timeoutMs = `oneShotMs::neverExpires`
	)

inlineinherited

Transfer all data with timeout.

Parameters

to	Destination stream
timeoutMs	Timeout in milliseconds

Returns: Number of bytes transferred

◆ sendAll() [5/5]

size_t Stream::sendAll	(	Stream *	to,
		const oneShotMs::timeType	timeoutMs = `oneShotMs::neverExpires`
	)

inlineinherited

Transfer all data with timeout.

Parameters

to	Destination stream
timeoutMs	Timeout in milliseconds

Returns: Number of bytes transferred

◆ sendAvailable() [1/5]

size_t Stream::sendAvailable ( Print & to )

inlineinherited

Transfer available data without waiting (deprecated)

Parameters

to	Destination stream

Returns: Number of bytes transferred

Deprecated:: Use the Stream* variant instead

◆ sendAvailable() [2/5]

size_t Stream::sendAvailable ( Print * to )

inlineinherited

Transfer available data without waiting (deprecated)

Parameters

to	Destination stream

Returns: Number of bytes transferred

Deprecated:: Use the Stream* variant instead

◆ sendAvailable() [3/5]

size_t Stream::sendAvailable ( Stream && to )

inlineinherited

Transfer available data without waiting.

Parameters

to	Destination stream

Returns: Number of bytes transferred

◆ sendAvailable() [4/5]

size_t Stream::sendAvailable ( Stream & to )

inlineinherited

Transfer available data without waiting.

Parameters

to	Destination stream

Returns: Number of bytes transferred

◆ sendAvailable() [5/5]

size_t Stream::sendAvailable ( Stream * to )

inlineinherited

Transfer available data without waiting.

Parameters

to	Destination stream

Returns: Number of bytes transferred

◆ sendGeneric() [1/2]

size_t Stream::sendGeneric	(	Print *	to,
		const ssize_t	len = `-1`,
		const int	readUntilChar = `-1`,
		oneShotMs::timeType	timeoutMs = `oneShotMs::neverExpires`
	)

protectedinherited

Generic transfer method for Print objects (deprecated)

Parameters

to	Destination stream
len	Maximum number of bytes to transfer (-1 for unlimited)
readUntilChar	Character to stop at (-1 for none)
timeoutMs	Timeout in milliseconds

Returns: Number of bytes transferred

◆ sendGeneric() [2/2]

size_t Stream::sendGeneric	(	Stream *	to,
		const ssize_t	len = `-1`,
		const int	readUntilChar = `-1`,
		oneShotMs::timeType	timeoutMs = `oneShotMs::neverExpires`
	)

protectedinherited

Generic transfer method for Stream objects.

Parameters

to	Destination stream
len	Maximum number of bytes to transfer (-1 for unlimited)
readUntilChar	Character to stop at (-1 for none)
timeoutMs	Timeout in milliseconds

Returns: Number of bytes transferred

◆ SendGenericPeekBuffer()

size_t Stream::SendGenericPeekBuffer	(	Print *	to,
		const ssize_t	len,
		const int	readUntilChar,
		const oneShotMs::timeType	timeoutMs
	)

protectedinherited

Transfer using peek buffer API.

Parameters

to	Destination stream
len	Maximum number of bytes to transfer
readUntilChar	Character to stop at
timeoutMs	Timeout in milliseconds

Returns: Number of bytes transferred

◆ SendGenericRegular()

size_t Stream::SendGenericRegular	(	Print *	to,
		const ssize_t	len,
		const oneShotMs::timeType	timeoutMs
	)

protectedinherited

Transfer using regular read.

Parameters

to	Destination stream
len	Maximum number of bytes to transfer
timeoutMs	Timeout in milliseconds

Returns: Number of bytes transferred

◆ SendGenericRegularUntil()

size_t Stream::SendGenericRegularUntil	(	Print *	to,
		const ssize_t	len,
		const int	readUntilChar,
		const oneShotMs::timeType	timeoutMs
	)

protectedinherited

Transfer using regular read until character.

Parameters

to	Destination stream
len	Maximum number of bytes to transfer
readUntilChar	Character to stop at
timeoutMs	Timeout in milliseconds

Returns: Number of bytes transferred

◆ sendSize() [1/5]

size_t Stream::sendSize	(	Print &	to,
		const ssize_t	maxLen,
		const oneShotMs::timeType	timeoutMs = `oneShotMs::neverExpires`
	)

inlineinherited

Transfer a specific amount of data with timeout (deprecated)

Parameters

to	Destination stream
maxLen	Maximum number of bytes to transfer
timeoutMs	Timeout in milliseconds

Returns: Number of bytes transferred

Deprecated:: Use the Stream* variant instead

◆ sendSize() [2/5]

size_t Stream::sendSize	(	Print *	to,
		const ssize_t	maxLen,
		const oneShotMs::timeType	timeoutMs = `oneShotMs::neverExpires`
	)

inlineinherited

Transfer a specific amount of data with timeout (deprecated)

Parameters

to	Destination stream
maxLen	Maximum number of bytes to transfer
timeoutMs	Timeout in milliseconds

Returns: Number of bytes transferred

Deprecated:: Use the Stream* variant instead

◆ sendSize() [3/5]

size_t Stream::sendSize	(	Stream &&	to,
		const ssize_t	maxLen,
		const oneShotMs::timeType	timeoutMs = `oneShotMs::neverExpires`
	)

inlineinherited

Transfer a specific amount of data with timeout.

Parameters

to	Destination stream
maxLen	Maximum number of bytes to transfer
timeoutMs	Timeout in milliseconds

Returns: Number of bytes transferred

◆ sendSize() [4/5]

size_t Stream::sendSize	(	Stream &	to,
		const ssize_t	maxLen,
		const oneShotMs::timeType	timeoutMs = `oneShotMs::neverExpires`
	)

inlineinherited

Transfer a specific amount of data with timeout.

Parameters

to	Destination stream
maxLen	Maximum number of bytes to transfer
timeoutMs	Timeout in milliseconds

Returns: Number of bytes transferred

◆ sendSize() [5/5]

size_t Stream::sendSize	(	Stream *	to,
		const ssize_t	maxLen,
		const oneShotMs::timeType	timeoutMs = `oneShotMs::neverExpires`
	)

inlineinherited

Transfer a specific amount of data with timeout.

Parameters

to	Destination stream
maxLen	Maximum number of bytes to transfer
timeoutMs	Timeout in milliseconds

Returns: Number of bytes transferred

◆ sendUntil() [1/5]

size_t Stream::sendUntil	(	Print &	to,
		const int	readUntilChar,
		const oneShotMs::timeType	timeoutMs = `oneShotMs::neverExpires`
	)

inlineinherited

Transfer data until a specific character is found (deprecated)

Parameters

to	Destination stream
readUntilChar	Character to stop at
timeoutMs	Timeout in milliseconds

Returns: Number of bytes transferred

Deprecated:: Use the Stream* variant instead

◆ sendUntil() [2/5]

size_t Stream::sendUntil	(	Print *	to,
		const int	readUntilChar,
		const oneShotMs::timeType	timeoutMs = `oneShotMs::neverExpires`
	)

inlineinherited

Transfer data until a specific character is found (deprecated)

Parameters

to	Destination stream
readUntilChar	Character to stop at
timeoutMs	Timeout in milliseconds

Returns: Number of bytes transferred

Deprecated:: Use the Stream* variant instead

◆ sendUntil() [3/5]

size_t Stream::sendUntil	(	Stream &&	to,
		const int	readUntilChar,
		const oneShotMs::timeType	timeoutMs = `oneShotMs::neverExpires`
	)

inlineinherited

Transfer data until a specific character is found.

Parameters

to	Destination stream
readUntilChar	Character to stop at (the character is read but not transferred)
timeoutMs	Timeout in milliseconds

Returns: Number of bytes transferred

◆ sendUntil() [4/5]

size_t Stream::sendUntil	(	Stream &	to,
		const int	readUntilChar,
		const oneShotMs::timeType	timeoutMs = `oneShotMs::neverExpires`
	)

inlineinherited

Transfer data until a specific character is found.

Parameters

to	Destination stream
readUntilChar	Character to stop at (the character is read but not transferred)
timeoutMs	Timeout in milliseconds

Returns: Number of bytes transferred

◆ sendUntil() [5/5]

size_t Stream::sendUntil	(	Stream *	to,
		const int	readUntilChar,
		const oneShotMs::timeType	timeoutMs = `oneShotMs::neverExpires`
	)

inlineinherited

Transfer data until a specific character is found.

Parameters

to	Destination stream
readUntilChar	Character to stop at (the character is read but not transferred)
timeoutMs	Timeout in milliseconds

Returns: Number of bytes transferred

◆ setReport()

void Stream::setReport ( Report report )

inlineprotectedinherited

Set the result of a send operation.

Parameters

report Status code to set

◆ setTimeout()

void Stream::setTimeout ( unsigned long timeout )

inherited

Set the timeout for stream operations.

Parameters

timeout Maximum milliseconds to wait for stream data

◆ setWriteError()

void Print::setWriteError ( int err = 1 )

inlineprotectedinherited

Set the write error flag.

Parameters

err	Error code to set (default: 1)

◆ size()

template<typename VectorType >

size_t esp32_psram::RingBufferStream< VectorType >::size ( ) const

inline

Get the total capacity of the buffer.

Returns: Total buffer capacity in bytes

◆ streamRemaining()

virtual ssize_t Stream::streamRemaining ( )

inlinevirtualinherited

Get the number of bytes remaining in the stream.

Returns: Number of bytes remaining, or -1 if unknown

◆ timedPeek()

int Stream::timedPeek ( )

protectedinherited

Peek at the next character with timeout.

Returns: The next character or -1 if timeout

◆ timedRead()

int Stream::timedRead ( )

protectedinherited

Read a character with timeout.

Returns: The read character or -1 if timeout

◆ used()

template<typename VectorType >

size_t esp32_psram::RingBufferStream< VectorType >::used ( ) const

inline

Get the number of bytes currently in the buffer.

Returns: Number of bytes in the buffer

◆ write() [1/14]

size_t Print::write ( char c )

inlineinherited

Write a char value as a byte.

Parameters

c	Character to write

Returns: Number of bytes written

◆ write() [2/14]

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

inlineinherited

Write a buffer of characters to the output.

Parameters

buffer	Pointer to the character buffer
size	Number of characters to write

Returns: Number of bytes written

◆ write() [3/14]

size_t Print::write ( const char * str )

inlineinherited

Write a null-terminated string to the output.

Parameters

str	Pointer to the string to write

Returns: Number of bytes written

◆ write() [4/14]

template<typename VectorType >

size_t esp32_psram::RingBufferStream< VectorType >::write	(	const uint8_t *	data,
		size_t	size
	)

inlinevirtual

Write multiple bytes to the buffer.

Parameters

data	Pointer to the data to write
size	Number of bytes to write

Returns: Number of bytes written

Reimplemented from Print.

◆ write() [5/14]

size_t Print::write ( int t )

inlineinherited

Write an int value as a byte.

Parameters

t	Value to write

Returns: Number of bytes written

◆ write() [6/14]

size_t Print::write ( int8_t c )

inlineinherited

Write a signed byte as an unsigned byte.

Parameters

c	Byte to write

Returns: Number of bytes written

◆ write() [7/14]

size_t Print::write ( long long t )

inlineinherited

Write a long long value as a byte.

Parameters

t	Value to write

Returns: Number of bytes written

◆ write() [8/14]

size_t Print::write ( long t )

inlineinherited

Write a long value as a byte.

Parameters

t	Value to write

Returns: Number of bytes written

◆ write() [9/14]

size_t Print::write ( short t )

inlineinherited

Write a short value as a byte.

Parameters

t	Value to write

Returns: Number of bytes written

◆ write() [10/14]

template<typename VectorType >

size_t esp32_psram::RingBufferStream< VectorType >::write ( uint8_t value )

inlineoverridevirtual

Write a byte to the buffer.

Parameters

value The byte to write

Returns: 1 if the byte was written, 0 if the buffer is full

Implements Print.

◆ write() [11/14]

size_t Print::write ( unsigned int t )

inlineinherited

Write an unsigned int value as a byte.

Parameters

t	Value to write

Returns: Number of bytes written

◆ write() [12/14]

size_t Print::write ( unsigned long long t )

inlineinherited

Write an unsigned long long value as a byte.

Parameters

t	Value to write

Returns: Number of bytes written

◆ write() [13/14]

size_t Print::write ( unsigned long t )

inlineinherited

Write an unsigned long value as a byte.

Parameters

t	Value to write

Returns: Number of bytes written

◆ write() [14/14]

size_t Print::write ( unsigned short t )

inlineinherited

Write an unsigned short value as a byte.

Parameters

t	Value to write

Returns: Number of bytes written

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

src/esp32-psram/RingBufferStream.h

Public Types

Public Member Functions

Static Public Attributes

Protected Member Functions

Protected Attributes

Detailed Description

template<typename VectorType> class esp32_psram::RingBufferStream< VectorType >

Member Enumeration Documentation

◆ Report

Constructor & Destructor Documentation

◆ RingBufferStream()

Member Function Documentation

◆ available()

◆ availableForWrite()

◆ find() [1/5]

◆ find() [2/5]

◆ find() [3/5]

◆ find() [4/5]

◆ find() [5/5]

◆ findUntil() [1/4]

◆ findUntil() [2/4]

◆ findUntil() [3/4]

◆ findUntil() [4/4]

◆ free()

◆ getLastSendReport()

◆ getTimeout()

◆ getVector() [1/2]

◆ getVector() [2/2]

◆ getWriteError()

◆ hasPeekBufferAPI()

◆ inputCanTimeout()

◆ isEmpty()

◆ isFull()

◆ outputCanTimeout()

◆ parseFloat() [1/2]

◆ parseFloat() [2/2]

◆ parseInt() [1/2]

◆ parseInt() [2/2]

◆ peek()

◆ peekAvailable()

◆ peekBuffer()

◆ peekConsume()

◆ peekNextDigit()

◆ print() [1/13]

◆ print() [2/13]

◆ print() [3/13]

◆ print() [4/13]

◆ print() [5/13]

◆ print() [6/13]

◆ print() [7/13]

◆ print() [8/13]

◆ print() [9/13]

◆ print() [10/13]

◆ print() [11/13]

◆ print() [12/13]

◆ print() [13/13]

◆ printf()

◆ printf_P()

◆ println() [1/14]

◆ println() [2/14]

◆ println() [3/14]

◆ println() [4/14]

◆ println() [5/14]

◆ println() [6/14]

◆ println() [7/14]

◆ println() [8/14]

◆ println() [9/14]

◆ println() [10/14]

◆ println() [11/14]

◆ println() [12/14]

◆ println() [13/14]

◆ println() [14/14]

◆ printNumber()

◆ read() [1/3]

◆ read() [2/3]

◆ read() [3/3]

◆ readBytes() [1/2]

◆ readBytes() [2/2]

◆ readBytesUntil() [1/2]

◆ readBytesUntil() [2/2]

template<typename VectorType>
class esp32_psram::RingBufferStream< VectorType >