Files

An application stores information in a file system by creating a file or appending new information to an existing file. At a later time, this information may be retrieved by reading the file. Other functions support these capabilities; for example, the application can move to a specified location in the file or query the file system to get information about the file. These functions, which operate on file structures (FS_FILEs), are grouped under file access (or simply file) functions. The available file functions are listed in Table - File API functions.

A separate set of file operations (or entry) functions manage the files and directories available on the system. Using these functions, the application can copy, create, delete and rename files, and get and set a file or directory’s attributes and date/time. The available entry functions are listed in Table - Entry API Functions.

The entry functions and the FSFile_Open() function accept full file paths. For information about using file and path names, see µC/FS File and Directory Names and Paths.

The functions listed in Table - File API functions  and Table - Entry API Functions the are core functions in the file access module (FSFile_####() functions) and entry module (FSEntry_####() functions). These are matched, in most cases, by API level functions that correspond to standard C or POSIX functions. The core and API functions provide basically the same functionality; the benefits of the former are enhanced capabilities, a consistent interface and meaningful return error codes.