A file-like interface for vector-backed storage in memory. More...

#include <InMemoryFile.h>

Inheritance diagram for esp32_psram::InMemoryFile< 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
	InMemoryFile ()
	Default constructor - initializes with internal vector.

	InMemoryFile (const char *filename, FileMode mode)
	Constructor with filename and mode. More...

virtual	~InMemoryFile ()
	Destructor - ensures proper cleanup.

int	available () override
	Get the number of bytes available to read. More...

virtual int	availableForWrite ()
	Get the number of bytes available in the write buffer. More...

size_t	capacity () const
	Get the number of bytes that can be held in current storage. Please note that this might dynamically grow! More...

void	clearWriteError ()
	Clear the write error state.

void	close ()
	Close the file.

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
	Ensure all data is committed to the storage No-op for this implementation since data is in memory.

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

unsigned long	getTimeout () const
	Get the current timeout setting. 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	isOpen () const
	Check if file is open. More...

String	name () const
	Get the name of the file. More...

bool	open (FileMode mode)
	Open the file with the specified mode. More...

	operator bool () const

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
	Peek at the next byte without advancing the position. 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	position () const
	Get the current position in the file. 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 single byte from the file. 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 file. More...

virtual size_t	readBytes (uint8_t *buffer, size_t length)
	Read bytes from the stream into a buffer (uint8_t variant) 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...

bool	reserve (size_t new_cap)
	Reserve storage. More...

bool	seek (size_t pos)
	Set the current position in the file. 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	setName (const char *name)
	Set the name of this file. More...

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

void	setVector (VectorType *vec)
	Set the vector to use for this file. More...

size_t	size () const
	Get the size of the file. More...

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

void	truncate ()
	Truncate the file to the current position.

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 *buffer, size_t size) override
	Write multiple bytes to the file. 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 b) override
	Write a single byte to the file. 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::InMemoryFile< VectorType >

A file-like interface for vector-backed storage in memory.

This class provides a file-like interface (compatible with Arduino's Stream) for reading and writing data to vector-backed storage. It can use either standard PSRAM or ESP32's HIMEM (high memory beyond the 4MB boundary) as its underlying storage mechanism through the VectorPSRAM and VectorHIMEM implementations.

InMemoryFile offers familiar file operations like open, close, read, write, seek, and truncate while managing the data in memory rather than on disk. This makes it useful for temporary storage, data processing, or situations where file operations are needed but filesystem access is not available or desirable.

The class can either manage its own internal vector or reference an external vector supplied by another component (like PSRAMClass or HIMEMClass).

Template Parameters

VectorType The vector implementation to use for storage (typically VectorPSRAM<uint8_t> or VectorHIMEM<uint8_t>)

Note: The performance characteristics will depend on the underlying vector implementation. HIMEM operations are generally slower than regular PSRAM operations but allow for larger storage capacity.

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

◆ InMemoryFile()

template<typename VectorType >

esp32_psram::InMemoryFile< VectorType >::InMemoryFile	(	const char *	filename,
		FileMode	mode
	)

inline

Constructor with filename and mode.

Parameters

filename	Name of the file
mode	Mode to open the file in

Member Function Documentation

◆ available()

template<typename VectorType >

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

inlineoverridevirtual

Get the number of bytes available to read.

Returns: Number of bytes available

Implements Stream.

◆ availableForWrite()

virtual int Print::availableForWrite ( )

inlinevirtualinherited

Get the number of bytes available in the write buffer.

Returns: The number of bytes available in the write buffer (0 by default)

Note: Subclasses should override this if they implement buffering

Reimplemented in esp32_psram::RingBufferStream< VectorType >.

◆ capacity()

template<typename VectorType >

size_t esp32_psram::InMemoryFile< VectorType >::capacity ( ) const

inline

Get the number of bytes that can be held in current storage. Please note that this might dynamically grow!

Returns: The capacity of the file

◆ 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

◆ 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

◆ 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

◆ isOpen()

template<typename VectorType >

bool esp32_psram::InMemoryFile< VectorType >::isOpen ( ) const

inline

Check if file is open.

Returns: true if open, false otherwise

◆ name()

template<typename VectorType >

String esp32_psram::InMemoryFile< VectorType >::name ( ) const

inline

Get the name of the file.

Returns: File name

◆ open()

template<typename VectorType >

bool esp32_psram::InMemoryFile< VectorType >::open ( FileMode mode )

inline

Open the file with the specified mode.

Parameters

mode	Mode to open the file in

Returns: true if opened successfully, 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::InMemoryFile< VectorType >::peek ( )

inlineoverridevirtual

Peek at the next byte without advancing the position.

Returns: The next byte, or -1 if no data is available

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

◆ position()

template<typename VectorType >

size_t esp32_psram::InMemoryFile< VectorType >::position ( ) const

inline

Get the current position in the file.

Returns: Current position

◆ 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::InMemoryFile< VectorType >::read ( )

inlineoverridevirtual

Read a single byte from the file.

Returns: The next byte, or -1 if no data is available

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::InMemoryFile< VectorType >::readBytes	(	char *	buffer,
		size_t	size
	)

inlineoverridevirtual

Read multiple bytes from the file.

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]

virtual size_t Stream::readBytes	(	uint8_t *	buffer,
		size_t	length
	)

inlinevirtualinherited

Read bytes from the stream into a buffer (uint8_t variant)

Parameters

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

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

Reimplemented in esp32_psram::RingBufferStream< VectorType >.

◆ 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

◆ reserve()

template<typename VectorType >

bool esp32_psram::InMemoryFile< VectorType >::reserve ( size_t new_cap )

inline

Reserve storage.

Parameters

new_cap The new capacity of the file

◆ seek()

template<typename VectorType >

bool esp32_psram::InMemoryFile< VectorType >::seek ( size_t pos )

inline

Set the current position in the file.

Parameters

pos	The position to seek to

Returns: true if successful, false otherwise

◆ 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

◆ setName()

template<typename VectorType >

void esp32_psram::InMemoryFile< VectorType >::setName ( const char * name )

inline

Set the name of this file.

Parameters

name	The name to set

◆ 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

◆ setVector()

template<typename VectorType >

void esp32_psram::InMemoryFile< VectorType >::setVector ( VectorType * vec )

inline

Set the vector to use for this file.

Parameters

vec	Pointer to the vector to use

◆ 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::InMemoryFile< VectorType >::size ( ) const

inline

Get the size of the file.

Returns: File size 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

◆ 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::InMemoryFile< VectorType >::write	(	const uint8_t *	buffer,
		size_t	size
	)

inlineoverridevirtual

Write multiple bytes to the file.

Parameters

buffer	Buffer containing the data to write
size	Number of bytes to write

Returns: Number of bytes actually 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::InMemoryFile< VectorType >::write ( uint8_t b )

inlineoverridevirtual

Write a single byte to the file.

Parameters

b	The byte to write

Returns: 1 if the byte was written, 0 otherwise

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/InMemoryFile.h

Public Types

Public Member Functions

Static Public Attributes

Protected Member Functions

Protected Attributes

Detailed Description

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

Member Enumeration Documentation

◆ Report

Constructor & Destructor Documentation

◆ InMemoryFile()

Member Function Documentation

◆ available()

◆ availableForWrite()

◆ capacity()

◆ 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]

◆ getLastSendReport()

◆ getTimeout()

◆ getWriteError()

◆ hasPeekBufferAPI()

◆ inputCanTimeout()

◆ isOpen()

◆ name()

◆ open()

◆ outputCanTimeout()

◆ parseFloat() [1/2]

◆ parseFloat() [2/2]

◆ parseInt() [1/2]

◆ parseInt() [2/2]

◆ peek()

◆ peekAvailable()

◆ peekBuffer()

◆ peekConsume()

◆ peekNextDigit()

◆ position()

◆ 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::InMemoryFile< VectorType >