Chapter
7
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_FILE s), are grouped under file access
(or simply file) functions. The available file functions are listed in Table 7-1.
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 7-3.
The entry functions and the FSFile_Open() function accept full file paths. For information
about using file and path names, see section 4-3 “μC/FS File and Directory Names and
Paths” on page 62.
The functions listed in Table 7-1 and Table 7-3 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.
97