- Function
Rename a file.
- Header
- Declaration
int __fastcall__ rename (const char* oldname, const char* newname);
- Description
rename
renames a file (gives it a new name). On success, zero is returned. On error, -1 is returned anderrno
is set to an error code describing the reason for the failure.- Limits
- This function is not available on all cc65 targets (depends on the capabilities of the storage devices).
- The function is only available as fastcall function, so it may only be used in presence of a prototype.
- Availability
ISO 9899
- See also
- Example
#include <stdio.h> #define OLDNAME "textfile.txt" #define NEWNAME "textfile.bak" if (rename (OLDNAME, NEWNAME) == 0) { printf ("Renamed %s to %s\n", OLDNAME, NEWNAME); } else { printf ("Error renaming %s to %s\n", OLDNAME, NEWNAME); }