fs_remove()

int  fs_remove (const  char  *name_full);

File

Called from

Code enabled by

fs_api.c

Application

FS_CFG_API_EN and not FS_CFG_RD_ONLY_EN

Delete a file or directory.

Arguments

name_full

Name of the entry.

Returned Value

0, if the file is not removed.

-1, if the file is not removed.

Notes/Warnings

  1. When a file is removed, the space occupied by the file is freed and shall no longer be accessible.
  2. A directory can be removed only if it is an empty directory.
  3. The root directory cannot be removed.

Example

void  App_Fnct (void)
{
    int  err;
    .
    .
    .
    err = fs_remove("sd:0:\\data\\file001.txt");   /* Remove file.  */
    if (err != 0) {
        APP_TRACE_INFO(("Could not remove file."));
    }
    .
    .
    .
    err = fs_remove("sd:0:\\data\\old");           /* Remove dir.   */
    if (err != 0) {
        APP_TRACE_INFO(("Could not remove dir."));
    }
    .
    .
    .
}