Real time embedded FreeRTOS RSS feed 
Homepage FreeRTOS+ Products FreeRTOS Labs Support Forum Contact / Enquiries

f_write()

[FreeRTOS Embedded File System API]

header_file.h
long f_write( const void *pvBuffer, long lSize, long lItems, FILE_F pxFileHandle );
		

Writes data into an open FAT file in the fat file system. The data is written at the current file read/write position, and the current file read/write position is incremented by the number of bytes successfully written.

A file can only be written to if it was opened with one of the following option strings: "w", "w+", "a+", "r+" or "a" (see f_open()).

Parameters:

pvBuffer   A pointer to the source of the data being written to the file.

lSize,   The size in bytes of the item being written to the file.

lItems   The number of items being written to the file (the size of each item being set by the lSize parameter).

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

Returns:
Any value   The returned value is the number of items that were successfully written to the disk.

See also

f_putc()

Example usage:


void vSampleFunction( void )
{
F_FILE *pxFile;
char *pcString = "ABC";

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

    if( pxFile != NULL )
    {
        /* Write three single characters to the opened file. */
        if( f_write( pcString, 1, 3, pxFile ) == 3 )
        {
            /* All three bytes were written to the file. */
        }

        /* Close the file again. */
        f_close( pxFile );
    }
}
						
Example use of the f_write() API function


[ Back to the top ]    [ About FreeRTOS ]    [ Privacy ]    [ FreeRTOS+ Sitemap ]    [ Main FreeRTOS Sitemap ]    [ ]


Copyright (C) Amazon Web Services, Inc. or its affiliates. All rights reserved.