ff_rename()

[FreeRTOS+FAT Standard API Reference]

ff_stdio.h
int ff_rename( const char *pcOldName, const char *pcNewName );
		

Moves a file. A file can be moved across directories, but not across file systems.

Parameters:

pcOldName   A pointer to a standard null terminated C string that holds the name of the source file. The string can contain a relative path.
pcNewName   A pointer to a standard null terminated C string that holds the name of the destination file. The string can contain a relative path.
Returns:

If the file is moved successfully then zero is returned.

If the file could not be moved then -1 is returned and the task’s errno is set to indicate the reason. A task can obtain its errno value using the ff_errno() API function.