frename

#include <rtl.h>

int frename (
  const char *oldname,     /* old filename */
  const char *newname);    /* new filename */

The frename function changes the filename of the oldname to newname. oldname must be the name of an existing file and newname must be a valid filename that is not the name of an existing file.

Both oldname and newname may 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. If oldname and newname include a drive prefix, the prefix must refer to the same medium.

The following drive prefixes are allowed:

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

note

• For compatibility, the rename function is also defined.

#include <rtl.h>

void tst_frename (void) {

   if (frename ("F:Test.txt", "New name.txt") == 0) {
      printf ("Rename Successful.\n");
   }
}