StreamFile< BaseFile, PosType > Class Template Reference

StreamFile class. More...

#include <ArduinoFiles.h>

Inheritance diagram for StreamFile< BaseFile, PosType >:

Collaboration diagram for StreamFile< BaseFile, PosType >:

Public Member Functions
int	available ()
void	flush ()
bool	isDirectory ()
const char *	name () const
int	peek ()
PosType	position ()
int	read ()
void	rewindDirectory ()
bool	seek (PosType pos)
PosType	size ()
size_t	write (const uint8_t *buffer, size_t size)
size_t	write (uint8_t b)

Detailed Description

template<class BaseFile, typename PosType>
class StreamFile< BaseFile, PosType >

StreamFile class.

Member Function Documentation

available()

template<class BaseFile, typename PosType>

int StreamFile< BaseFile, PosType >::available ( )

inline

Returns

number of bytes available from the current position to EOF or INT_MAX if more than INT_MAX bytes are available.

flush()

template<class BaseFile, typename PosType>

void StreamFile< BaseFile, PosType >::flush ( )

inline

Ensure that any bytes written to the file are saved to the SD card.

isDirectory()

template<class BaseFile, typename PosType>

bool StreamFile< BaseFile, PosType >::isDirectory ( )

inline

This function reports if the current file is a directory or not.

Returns

true if the file is a directory.

name()

template<class BaseFile, typename PosType>

const char* StreamFile< BaseFile, PosType >::name ( ) const

inline

No longer implemented due to Long File Names.

Use getName(char* name, size_t size).

Returns

a pointer to replacement suggestion.

peek()

template<class BaseFile, typename PosType>

int StreamFile< BaseFile, PosType >::peek ( )

inline

Return the next available byte without consuming it.

Returns

The byte if no error and not at eof else -1;

position()

template<class BaseFile, typename PosType>

PosType StreamFile< BaseFile, PosType >::position ( )

inline

Returns

the current file position.

read()

template<class BaseFile, typename PosType>

int StreamFile< BaseFile, PosType >::read ( )

inline

Read the next byte from a file.

Returns

For success return the next byte in the file as an int. If an error occurs or end of file is reached return -1.

rewindDirectory()

template<class BaseFile, typename PosType>

void StreamFile< BaseFile, PosType >::rewindDirectory ( )

inline

Rewind a file if it is a directory

seek()

template<class BaseFile, typename PosType>

bool StreamFile< BaseFile, PosType >::seek ( PosType  pos )

inline

Seek to a new position in the file, which must be between 0 and the size of the file (inclusive).

Parameters

[in]

pos

the new file position.

Returns

true for success or false for failure.

size()

template<class BaseFile, typename PosType>

PosType StreamFile< BaseFile, PosType >::size ( )

inline

Returns

the file's size.

write() [1/2]

template<class BaseFile, typename PosType>

size_t StreamFile< BaseFile, PosType >::write ( const uint8_t *  buffer, size_t  size  )

inline

Write data to an open file.

Note

Data is moved to the cache but may not be written to the storage device until sync() is called.

Parameters

[in]	buffer	Pointer to the location of the data to be written.
[in]	size	Number of bytes to write.

Returns

For success write() returns the number of bytes written, always size.

write() [2/2]

template<class BaseFile, typename PosType>

size_t StreamFile< BaseFile, PosType >::write ( uint8_t  b )

inline

Write a byte to a file. Required by the Arduino Print class.

Parameters

[in]

b

the byte to be written. Use getWriteError to check for errors.

Returns

1 for success and 0 for failure.

---

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

• Arduino/libraries/SdFat/src/common/ArduinoFiles.h