StdioStream implements a minimal stdio stream. More...

#include <StdioStream.h>

Inheritance diagram for StdioStream:

Collaboration diagram for StdioStream:

Public Member Functions
void	clearerr ()

int	fclose ()

int	feof ()

int	ferror ()

int	fflush ()

int	fgetc ()

char *	fgets (char str, int num, size_t len=0)

bool	fopen (const char filename, const char mode)

int	fputc (int c)

int	fputs (const char *str)

int	fputs_P (PGM_P str)

size_t	fread (void *ptr, size_t size, size_t count)

int	fseek (int32_t offset, int origin)

int32_t	ftell ()

size_t	fwrite (const void *ptr, size_t size, size_t count)

int	getc ()

size_t	print (char c)

size_t	print (const char *str)

size_t	print (const __FlashStringHelper *str)

size_t	print (double val, uint8_t prec=2)

size_t	print (float val, uint8_t prec=2)

template<typename T >
size_t	print (T val)

int	printDec (char n)

int	printDec (signed char n)

int	printDec (unsigned char n)

int	printDec (int16_t n)

int	printDec (uint16_t n)

int	printDec (int32_t n)

int	printDec (uint32_t n)

int	printDec (double value, uint8_t prec)

int	printDec (float value, uint8_t prec)

int	printField (double value, char term, uint8_t prec=2)

int	printField (float value, char term, uint8_t prec=2)

template<typename T >
int	printField (T value, char term)

int	printHex (uint32_t n)

int	printHexln (uint32_t n)

size_t	println ()

size_t	println (double val, uint8_t prec=2)

size_t	println (float val, uint8_t prec=2)

template<typename T >
size_t	println (T val)

int	putc (int c)

int	putCRLF ()

bool	rewind ()

	StdioStream ()

int	ungetc (int c)

Private Member Functions
uint32_t	available ()

void	clearWriteError ()

bool	close ()

bool	contiguousRange (uint32_t bgnBlock, uint32_t endBlock)

bool	createContiguous (SdBaseFile dirFile, const char path, uint32_t size)

uint32_t	curCluster () const

uint32_t	curPosition () const

bool	dirEntry (dir_t *dir)

bool	exists (const char *name)

int16_t	fgets (char str, int16_t num, char delim=0)

uint32_t	fileSize () const

uint32_t	firstCluster () const

bool	getFilename (char *name)

void	getpos (FatPos_t *pos)

bool	getWriteError ()

bool	isDir () const

bool	isFile () const

bool	isOpen () const

bool	isRoot () const

bool	isSubDir () const

void	ls (Print *pr, uint8_t flags=0, uint8_t indent=0)

void	ls (uint8_t flags=0)

bool	mkdir (SdBaseFile dir, const char path, bool pFlag=true)

bool	open (SdBaseFile *dirFile, uint16_t index, uint8_t oflag)

bool	open (SdBaseFile dirFile, const char path, uint8_t oflag)

bool	open (const char *path, uint8_t oflag=O_READ)

bool	openNext (SdBaseFile *dirFile, uint8_t oflag)

bool	openRoot (SdVolume *vol)

int	peek ()

bool	printCreateDateTime (Print *pr)

int	printField (int16_t value, char term)

int	printField (uint16_t value, char term)

int	printField (int32_t value, char term)

int	printField (uint32_t value, char term)

size_t	printFileSize (Print *pr)

bool	printModifyDateTime (Print *pr)

size_t	printName ()

size_t	printName (Print *pr)

int16_t	read ()

int	read (void *buf, size_t nbyte)

int8_t	readDir (dir_t *dir)

bool	remove ()

bool	rename (SdBaseFile dirFile, const char newPath)

bool	rmdir ()

bool	rmRfStar ()

bool	seekCur (int32_t offset)

bool	seekEnd (int32_t offset=0)

bool	seekSet (uint32_t pos)

void	setpos (FatPos_t *pos)

bool	sync ()

bool	timestamp (SdBaseFile *file)

bool	timestamp (uint8_t flag, uint16_t year, uint8_t month, uint8_t day, uint8_t hour, uint8_t minute, uint8_t second)

bool	truncate (uint32_t size)

uint8_t	type () const

SdVolume *	volume () const

Static Private Member Functions
static SdBaseFile *	cwd ()

static void	dateTimeCallback (void(dateTime)(uint16_t date, uint16_t *time))

static void	dateTimeCallbackCancel ()

static void	dirName (const dir_t &dir, char *name)

static void	printFatDate (uint16_t fatDate)

static void	printFatDate (Print *pr, uint16_t fatDate)

static void	printFatTime (uint16_t fatTime)

static void	printFatTime (Print *pr, uint16_t fatTime)

static bool	remove (SdBaseFile dirFile, const char path)

Private Attributes
bool	writeError

Detailed Description

StdioStream implements a minimal stdio stream.

StdioStream does not support subdirectories or long file names.

Constructor & Destructor Documentation

StdioStream::StdioStream ( )

inline

Constructor

Member Function Documentation

void StdioStream::clearerr ( )

inline

Clear the stream's end-of-file and error indicators.

int StdioStream::fclose ( )

Close a stream.

A successful call to the fclose function causes the stream to be flushed and the associated file to be closed. Any unwritten buffered data is written to the file; any unread buffered data is discarded. Whether or not the call succeeds, the stream is disassociated from the file.

Returns: zero if the stream was successfully closed, or EOF if any any errors are detected.

int StdioStream::feof ( )

inline

Test the stream's end-of-file indicator.

Returns: non-zero if and only if the end-of-file indicator is set.

int StdioStream::ferror ( )

inline

Test the stream's error indicator.

Returns: return non-zero if and only if the error indicator is set.

int StdioStream::fflush ( )

Flush the stream.

If stream is an output stream or an update stream in which the most recent operation was not input, any unwritten data is written to the file; otherwise the call is an error since any buffered input data would be lost.

Returns: sets the error indicator for the stream and returns EOF if an error occurs, otherwise it returns zero.

int StdioStream::fgetc ( )

inline

Get a byte from the stream.

Returns: If the end-of-file indicator for the stream is set, or if the stream is at end-of-file, the end-of-file indicator for the stream is set and the fgetc function returns EOF. Otherwise, the fgetc function returns the next character from the input stream.

char * StdioStream::fgets	(	char *	str,
		int	num,
		size_t *	len = `0`
	)

Get a string from a stream.

The fgets function reads at most one less than the number of characters specified by num from the stream into the array pointed to by str. No additional characters are read after a new-line character (which is retained) or after end-of-file. A null character is written immediately after the last character read into the array.

Parameters

[out]	str	Pointer to an array of where the string is copied.
[in]	num	Maximum number of characters including the null character.
[out]	len	If len is not null and fgets is successful, the length of the string is returned.

Returns: str if successful. If end-of-file is encountered and no characters have been read into the array, the contents of the array remain unchanged and a null pointer is returned. If a read error occurs during the operation, the array contents are indeterminate and a null pointer is returned.

bool StdioStream::fopen	(	const char *	filename,
		const char *	mode
	)

Open a stream.

Open a file and associates the stream with it.

Parameters

[in]	filename	name of the file to be opened.
[in]	mode	a string that indicates the open mode.

"r" or "rb"	Open a file for reading. The file must exist.
"w" or "wb"	Truncate an existing to zero length or create an empty file for writing.
"wx" or "wbx"	Create a file for writing. Fails if the file already exists.
"a" or "ab"	Append; open or create file for writing at end-of-file.
"r+" or "rb+" or "r+b"	Open a file for update (reading and writing).
"w+" or "w+b" or "wb+"	Truncate an existing to zero length or create a file for update.
"w+x" or "w+bx" or "wb+x"	Create a file for update. Fails if the file already exists.
"a+" or "a+b" or "ab+"	Append; open or create a file for update, writing at end-of-file.

The character 'b' shall have no effect, but is allowed for ISO C standard conformance.

Opening a file with append mode causes all subsequent writes to the file to be forced to the then current end-of-file, regardless of intervening calls to the fseek function.

When a file is opened with update mode, both input and output may be performed on the associated stream. However, output shall not be directly followed by input without an intervening call to the fflush function or to a file positioning function (fseek, or rewind), and input shall not be directly followed by output without an intervening call to a file positioning function, unless the input operation encounters endof-file.

Returns: true for success or false for failure.

int StdioStream::fputc ( int c )

inline

Write a byte to a stream.

Parameters

[in] c the byte to be written (converted to an unsigned char).

Returns: Upon successful completion, fputc() returns the value it has written. Otherwise, it returns EOF and sets the error indicator for the stream.

int StdioStream::fputs ( const char * str )

Write a string to a stream.

Parameters

[in] str a pointer to the string to be written.

Returns: for success, fputs() returns a non-negative number. Otherwise, it returns EOF and sets the error indicator for the stream.

int StdioStream::fputs_P ( PGM_P str )

Write a string stored in flash.

Parameters

[in] str string to be written.

Returns: for success, fputs() returns a non-negative number. Otherwise, it returns EOF and sets the error indicator for the stream.

size_t StdioStream::fread	(	void *	ptr,
		size_t	size,
		size_t	count
	)

Binary input.

Reads an array of up to count elements, each one with a size of size bytes.

Parameters

[out]	ptr	pointer to area of at least (size*count) bytes where the data will be stored.
[in]	size	the size, in bytes, of each element to be read.
[in]	count	the number of elements to be read.

Returns: number of elements successfully read, which may be less than count if a read error or end-of-file is encountered. If size or count is zero, fread returns zero and the contents of the array and the state of the stream remain unchanged.

int StdioStream::fseek	(	int32_t	offset,
		int	origin
	)

Set the file position for the stream.

Parameters

[in]	offset	number of offset from the origin.
[in]	origin	position used as reference for the offset. It is specified by one of the following constants.

SEEK_SET - Beginning of file.

SEEK_CUR - Current position of the file pointer.

SEEK_END - End of file.

Returns: zero for success. Otherwise, it returns non-zero and sets the error indicator for the stream.

int32_t StdioStream::ftell ( )

Get the current position in a stream.

Returns: If successful, ftell return the current value of the position indicator. On failure, ftell returns −1L.

size_t StdioStream::fwrite	(	const void *	ptr,
		size_t	size,
		size_t	count
	)

Binary output.

Writes an array of up to count elements, each one with a size of size bytes.

Parameters

[in]	ptr	pointer to (size*count) bytes of data to be written.
[in]	size	the size, in bytes, of each element to be written.
[in]	count	the number of elements to be written.

Returns: number of elements successfully written. if this number is less than count, an error has occured. If size or count is zero, fwrite returns zero.

int StdioStream::getc ( )

inline

Get a byte from the stream.

getc and fgetc are equivalent but getc is inline so it is faster but require more flash memory.

Returns: If the end-of-file indicator for the stream is set, or if the stream is at end-of-file, the end-of-file indicator for the stream is set and the fgetc function returns EOF. Otherwise, the fgetc function returns the next character from the input stream.

size_t StdioStream::print ( char c )

inline

Write a character.

Parameters

[in] c the character to write.

Returns: the number of bytes written.

size_t StdioStream::print ( const char * str )

inline

Write a string.

Parameters

[in] str the string to be written.

Returns: the number of bytes written.

size_t StdioStream::print ( const __FlashStringHelper * str )

Print a string stored in flash memory.

Parameters

[in] str the string to print.

Returns: the number of bytes written.

size_t StdioStream::print	(	double	val,
		uint8_t	prec = `2`
	)

inline

Print a floating point number.

Parameters

[in]	prec	Number of digits after decimal point.
[in]	val	the number to be printed.

Returns: the number of bytes written.

size_t StdioStream::print	(	float	val,
		uint8_t	prec = `2`
	)

inline

Print a floating point number.

Parameters

[in]	prec	Number of digits after decimal point.
[in]	val	the number to be printed.

Returns: the number of bytes written.

template<typename T >

size_t StdioStream::print ( T val )

inline

Print a number.

Parameters

[in] val the number to be printed.

Returns: the number of bytes written.

int StdioStream::printDec ( char n )

inline

Print a char as a number.

Parameters

[in] n number to be printed.

Returns: The number of bytes written or -1 if an error occurs.

int StdioStream::printDec ( signed char n )

print a signed 8-bit integer

Parameters

[in] n number to be printed.

Returns: The number of bytes written or -1 if an error occurs.

int StdioStream::printDec ( unsigned char n )

inline

Print an unsigned 8-bit number.

Parameters

[in] n number to be print.

Returns: The number of bytes written or -1 if an error occurs.

int StdioStream::printDec ( int16_t n )

Print a int16_t

Parameters

[in] n number to be printed.

Returns: The number of bytes written or -1 if an error occurs.

int StdioStream::printDec ( uint16_t n )

print a uint16_t.

Parameters

[in] n number to be printed.

Returns: The number of bytes written or -1 if an error occurs.

int StdioStream::printDec ( int32_t n )

Print a signed 32-bit integer.

Parameters

[in] n number to be printed.

Returns: The number of bytes written or -1 if an error occurs.

int StdioStream::printDec ( uint32_t n )

Write an unsigned 32-bit number.

Parameters

[in] n number to be printed.

Returns: The number of bytes written or -1 if an error occurs.

int StdioStream::printDec	(	double	value,
		uint8_t	prec
	)

inline

Print a double.

Parameters

[in]	value	The number to be printed.
[in]	prec	Number of digits after decimal point.

Returns: The number of bytes written or -1 if an error occurs.

int StdioStream::printDec	(	float	value,
		uint8_t	prec
	)

Print a float.

Parameters

[in]	value	The number to be printed.
[in]	prec	Number of digits after decimal point.

Returns: The number of bytes written or -1 if an error occurs.

int StdioStream::printField	(	double	value,
		char	term,
		uint8_t	prec = `2`
	)

inline

Print a number followed by a field terminator.

Parameters

[in]	value	The number to be printed.
[in]	term	The field terminator.
[in]	prec	Number of digits after decimal point.

Returns: The number of bytes written or -1 if an error occurs.

int StdioStream::printField	(	float	value,
		char	term,
		uint8_t	prec = `2`
	)

inline

Print a number followed by a field terminator.

Parameters

[in]	value	The number to be printed.
[in]	term	The field terminator.
[in]	prec	Number of digits after decimal point.

Returns: The number of bytes written or -1 if an error occurs.

template<typename T >

int StdioStream::printField	(	T	value,
		char	term
	)

inline

Print a number followed by a field terminator.

Parameters

[in]	value	The number to be printed.
[in]	term	The field terminator.

Returns: The number of bytes written or -1 if an error occurs.

int StdioStream::printHex ( uint32_t n )

Print HEX

Parameters

[in] n number to be printed as HEX.

Returns: The number of bytes written or -1 if an error occurs.

int StdioStream::printHexln ( uint32_t n )

inline

Print HEX with CRLF

Parameters

[in] n number to be printed as HEX.

Returns: The number of bytes written or -1 if an error occurs.

size_t StdioStream::println ( )

inline

Write a CR/LF.

Returns: two, the number of bytes written, for success or zero for failure.

size_t StdioStream::println	(	double	val,
		uint8_t	prec = `2`
	)

inline

Print a floating point number followed by CR/LF.

Parameters

[in]	val	the number to be printed.
[in]	prec	Number of digits after decimal point.

Returns: the number of bytes written.

size_t StdioStream::println	(	float	val,
		uint8_t	prec = `2`
	)

inline

Print a floating point number followed by CR/LF.

Parameters

[in]	val	the number to be printed.
[in]	prec	Number of digits after decimal point.

Returns: the number of bytes written.

template<typename T >

size_t StdioStream::println ( T val )

inline

Print an item followed by CR/LF

Parameters

[in] val the item to be printed.

Returns: the number of bytes written.

int StdioStream::putc ( int c )

inline

Write a byte to a stream.

putc and fputc are equivalent but putc is inline so it is faster but require more flash memory.

Parameters

[in] c the byte to be written (converted to an unsigned char).

Returns: Upon successful completion, fputc() returns the value it has written. Otherwise, it returns EOF and sets the error indicator for the stream.

int StdioStream::putCRLF ( )

inline

Write a CR/LF.

Returns: two, the number of bytes written, for success or -1 for failure.

bool StdioStream::rewind ( )

Set position of a stream to the beginning.

The rewind function sets the file position to the beginning of the file. It is equivalent to fseek(0L, SEEK_SET) except that the error indicator for the stream is also cleared.

Returns: true for success or false for failure.

int StdioStream::ungetc ( int c )

Push a byte back into an input stream.

Parameters

[in] c the byte (converted to an unsigned char) to be pushed back.

One character of pushback is guaranteed. If the ungetc function is called too many times without an intervening read or file positioning operation on that stream, the operation may fail.

A successful intervening call to a file positioning function (fseek, fsetpos, or rewind) discards any pushed-back characters for the stream.

Returns: Upon successful completion, ungetc() returns the byte pushed back after conversion. Otherwise it returns EOF.

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

Arduino/libraries/SdFat/StdioStream.h
Arduino/libraries/SdFat/StdioStream.cpp

Public Member Functions

Private Member Functions

Static Private Member Functions

Private Attributes

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation