Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Code Block
languagecpp
void  FSEntry_Rename (CPU_CHAR     *name_full_old,

...


                      CPU_CHAR     *name_full_new,

...


                      CPU_BOOLEAN   excl,

...


                      FS_ERR       *p_err);


File

Called from

Code enabled by

fs_entry.c

Application;
fs_rename()

not FS_CFG_RD_ONLY_EN

...

Indicates whether the creation of the new entry shall be exclusive (see Note #1):

DEF_YES, if the entry shall be renamed only if name_full_new does not exist.

...

Returned Value

None.

Notes/Warnings

  1. If name_full_old and name_full_new specify entries on different volumes, then name_full_old must specify a file. If name_full_old specifies a directory, an error will be returned.
  2. If name_full_old and name_full_new specify the same entry, the volume will not be modified and no error will be returned.
  3. If name_full_old specifies a file:
    1. name_full_new must not specify a directory;
    2. if excl is DEF_NO and name_full_new is a file, it will be removed.
  4. If name_full_old specifies a directory:
    1. name_full_new must not specify a file
    2. if excl is DEF_NO and name_full_new is a directory, name_full_newmust be empty; if so, it will be removed.
  5. If excl is DEF_NO, name_full_new must not exist.
  6. The root directory may not be renamed.