fdelete

#include <rtl.h>

int fdelete (
  const char *filename);    /* file to delete */

The fdelete function deletes the file specified by filename. The filename may contain a drive prefix that specifies where the file exists. If the drive prefix is omitted the default drive specified in FILE_CONFIG.C configuration file is used.

The following drive prefixes are allowed:

For the M: drive, a filename must contain a path, othervise a file from the root folder will be deleted. To delete a subfolder parameter filename, which is in this case a directory name, must contain also a terminating backslash character.

The fdelete function is in the RL-FlashFS library. The prototype is defined in rtl.h.

note

• To maintain compatibility, rtl.h defines the identical function unlink as a macro that is substituted by the fdelete function.

#include <rtl.h>

void tst_fdelete (void) {

   /* Delete a file from default drive. */
   if (fdelete ("TEST.TXT") == 0) {
      printf ("Deleted: TEST.TXT\n");
   }

   /* Delete a file from RAM FS. */
   if (fdelete ("R:DATA.LOG") == 0) {
      printf ("Deleted: DATA.LOG\n");
   }

   /* Delete a file from SD Card located in subfolder. */
   if (fdelete ("M:\\Working folder\\Temporary log.txt") == 0) {
      printf ("Deleted: Temporary log.txt\n");
   }

   /* Delete a folder from SD Card (if empty). */
   if (fdelete "M:\\Working folder\\") == 0) {
      printf ("Deleted: Working folder.\n");
  }
}