frename

#include <rtl.h>

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

The function frename replaces the name of a file. The parameter oldname is a character pointer specifying the current name of the file. The parameter newname is a character pointer specifying the new name of the file.

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

The parameter oldname can contain a drive prefix and, for FAT media, path information.

The following values are allowed for the parameter oldname:

• 0 - on success.
• non-zero value - on failure.

fclose, fdelete, ffind

#include <rtl.h>

void tst_frename (void)  {

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