Quality RTOS & Embedded Software

Featured FreeRTOS IoT Integrations:
Extended Maintenance Plan (EMP):
Delta Over-the-Air Updates:
December 2021 Releases:
FreeRTOS LTS libraries:


[FreeRTOS Embedded File System API]

unsigned char f_rewind( F_FILE *pxFileHandle );

Sets the current read/write position of an open FAT file back to the start of the file.


pxFileHandle   The handle of the file being reset. The handle is returned by the call to f_open() used to originally open the file.

F_NO_ERROR   The file was reset.

Any other value   An error occurred. The returned value holds the error code.

See also

f_seek(), f_tell().

Example usage:

void vSampleFunction( void )
char pcBuffer1[ 4 ], pcBuffer2[ 4 ];
F_FILE *pxFile;

/* Open the file "afile.bin". */
pxFile = f_open( "afile.bin", "r" );

if( pxFile != NULL )
/* Read four bytes into pcBuffer1. */
f_read( pcBuffer1, 4, 1, pxFile );

/* Set the current read pointer back to the start of the file. */
f_rewind( pxFile );

/* Read the same four bytes into pcBuffer2. */
f_read( pcBuffer2, 4, 1, pxFile );

/* Finished with the file. */
f_close( pxFile );

Example use of the f_rewind() API function
Copyright (C) Amazon Web Services, Inc. or its affiliates. All rights reserved.