Access file system. More...

Enumerations
enum	FileOpenFlags { eFO_ReadOnly = SPIFFS_RDONLY, eFO_WriteOnly = SPIFFS_WRONLY, eFO_ReadWrite = eFO_ReadOnly \| eFO_WriteOnly, eFO_CreateIfNotExist = SPIFFS_CREAT, eFO_Append = SPIFFS_APPEND, eFO_Truncate = SPIFFS_TRUNC, eFO_CreateNewAlways = eFO_CreateIfNotExist \| eFO_Truncate }
	File open flags. More...

enum	SeekOriginFlags { eSO_FileStart = SPIFFS_SEEK_SET, eSO_CurrentPos = SPIFFS_SEEK_CUR, eSO_FileEnd = SPIFFS_SEEK_END }
	File seek flags. More...

Functions
static FileOpenFlags	operator\| (FileOpenFlags lhs, FileOpenFlags rhs)

file_t	fileOpen (const String &name, FileOpenFlags flags)
	Open file. More...

void	fileClose (file_t file)
	Clode file. More...

size_t	fileWrite (file_t file, const void *data, size_t size)
	Write to file. More...

size_t	fileRead (file_t file, void *data, size_t size)
	Read from file. More...

int	fileSeek (file_t file, int offset, SeekOriginFlags origin)
	Position file cursor. More...

bool	fileIsEOF (file_t file)
	Check if at end of file. More...

int32_t	fileTell (file_t file)
	Get position in file. More...

int	fileFlush (file_t file)
	Flush pending writes. More...

int	fileLastError (file_t fd)
	Get last file system error code. More...

void	fileClearLastError (file_t fd)
	Clear last file system error. More...

int	fileSetContent (const String &fileName, const char *content)
	Create or replace file with defined content. More...

int	fileSetContent (const String &fileName, const String &content)
	Create or replace file with defined content. More...

uint32_t	fileGetSize (const String &fileName)
	Get size of file. More...

void	fileRename (const String &oldName, const String &newName)
	Rename file. More...

Vector< String >	fileList ()
	Get list of files on file system. More...

String	fileGetContent (const String &fileName)
	Read content of a file. More...

int	fileGetContent (const String &fileName, char *buffer, int bufSize)
	Read content of a file. More...

int	fileStats (const String &name, spiffs_stat *stat)

int	fileStats (file_t file, spiffs_stat *stat)

int	fileDelete (const String &name)
	Delete file. More...

int	fileDelete (file_t file)
	Delete file. More...

bool	fileExist (const String &name)
	Check if a file exists on file system. More...

Detailed Description

Access file system.

Enumeration Type Documentation

enum FileOpenFlags

File open flags.

Enumerator
eFO_ReadOnly	Read only file.
eFO_WriteOnly	Write only file.
eFO_ReadWrite	Read and write file.
eFO_CreateIfNotExist	Create new file if file does not exist.
eFO_Append	Append to file.
eFO_Truncate	Truncate file.
eFO_CreateNewAlways	Create new file even if file exists.

enum SeekOriginFlags

File seek flags.

Enumerator
eSO_FileStart	Start of file.
eSO_CurrentPos	Current position in file.
eSO_FileEnd	End of file.

Function Documentation

void fileClearLastError ( file_t fd )

Clear last file system error.

Parameters

fd Not used

Todo:: Why does fileClearLastError have unused fd parameter?

void fileClose ( file_t file )

Clode file.

Parameters

file	ID of file to open

Note: File ID is returned from fileOpen function

int fileDelete ( const String & name )

Delete file.

Parameters

name	Name of file to delete

Return values

int	error code, 0 on success

int fileDelete ( file_t file )

Delete file.

Parameters

file	ID of file to delete

Return values

int	error code, 0 on success

bool fileExist ( const String & name )

Check if a file exists on file system.

Parameters

name	Name of file to check for

Return values

bool	True if file exists

int fileFlush ( file_t file )

Flush pending writes.

Parameters

file File ID

Return values

int	Size of last file written or negative error number

String fileGetContent ( const String & fileName )

Read content of a file.

Parameters

fileName Name of file to read from

Return values

String String variable in to which to read the file content

Note: After calling this function the content of the file is placed in to a string

int fileGetContent	(	const String &	fileName,
		char *	buffer,
		int	bufSize
	)

Read content of a file.

Parameters

fileName	Name of file to read from
buffer	Pointer to a character buffer in to which to read the file content
bufSize	Quantity of bytes to read from file

Return values

int	Quantity of bytes read from file or zero on failure

Note: After calling this function the content of the file is placed in to a c-string Ensure there is sufficient space in the buffer for file content plus extra trailing null, i.e. at least bufSize + 1

uint32_t fileGetSize ( const String & fileName )

Get size of file.

Parameters

fileName Name of file

Return values

uint32_t Size of file in bytes

bool fileIsEOF ( file_t file )

Check if at end of file.

Parameters

file File ID

Return values

bool	True if at end of file

int fileLastError ( file_t fd )

Get last file system error code.

Parameters

fd Not used

Todo:: Why does fileLastError have unused fd parameter?

Return values

int	Error code of last file system operation

Vector<String> fileList ( )

Get list of files on file system.

Return values

Vector<String> Vector of strings. Each string element contains the name of a file on the file system

file_t fileOpen	(	const String &	name,
		FileOpenFlags	flags
	)

Open file.

Parameters

name	File name
flags	Mode to open file

Return values

file	File ID or negative error code

size_t fileRead	(	file_t	file,
		void *	data,
		size_t	size
	)

Read from file.

Parameters

file	File ID
data	Pointer to data buffer in to which to read data
size	Quantity of data elements to read from file

Return values

size_t Quantity of data elements actually read from file or negative error code

void fileRename	(	const String &	oldName,
		const String &	newName
	)

Rename file.

Parameters

oldName	Original name of file to rename
newName	New name for file

int fileSeek	(	file_t	file,
		int	offset,
		SeekOriginFlags	origin
	)

Position file cursor.

Parameters

file	File ID
offset	Quantity of bytes to move cursor
origin	Position from where to move cursor

Return values

Offset within file or negative error code

int fileSetContent	(	const String &	fileName,
		const char *	content
	)

Create or replace file with defined content.

Parameters

fileName	Name of file to create or replace
content	Pointer to c-string containing content to populate file with

Return values

int	Positive integer represents the numbers of bytes written.
int	Negative integer represents the error code of last file system operation.

Note: This function creates a new file or replaces an existing file and populates the file with the content of a c-string buffer. Remember to terminate your c-string buffer with a null (0).

int fileSetContent	(	const String &	fileName,
		const String &	content
	)

Create or replace file with defined content.

Parameters

fileName	Name of file to create or replace
content	String containing content to populate file with

Return values

int	Positive integer represents the numbers of bytes written.
int	Negative integer represents the error code of last file system operation.

Note: This function creates a new file or replaces an existing file and populates the file with the content of a string.

int fileStats	(	const String &	name,
		spiffs_stat *	stat
	)

brief Get file statistics

Parameters

name	File name
stat	Pointer to SPIFFS statistic structure to populate

Return values

int	-1 on error

Note: Pass a pointer to an instantiated fileStats structure

Todo:: Document the return value of fileStats

int fileStats	(	file_t	file,
		spiffs_stat *	stat
	)

brief Get file statistics

Parameters

file	File ID
stat	Pointer to SPIFFS statistic structure to populate

Return values

int	-1 on error

Note: Pass a pointer to an instantiated fileStats structure

Todo:: Document the return value of fileStats

int32_t fileTell ( file_t file )

Get position in file.

Parameters

file File ID

Return values

int32_t Read / write cursor position

size_t fileWrite	(	file_t	file,
		const void *	data,
		size_t	size
	)

Write to file.

Parameters

file	File ID
data	Pointer to data to write to file
size	Quantity of data elements to write to file

Return values

size_t Quantity of data elements actually written to file or negative error code

Enumerations

Functions

Detailed Description

Enumeration Type Documentation

Function Documentation