SYNOPSIS #include <stdio.h> int rename(const char *old, const char *new); int _rename_r(void *reent, const char *old, const char *new);
DESCRIPTION
Use rename
to establish a new name (the string
at new)
for a file now known by the string at old.
After a successful rename,
the file is no longer accessible by the string at old.
If rename fails, the file named *old is unaffected. The conditions for failure depend on the host operating system.
The alternate function, _rename_r, is a reentrant version. The extra argument, reent, is a pointer to a reentrancy structure.
RETURNS
The result is either 0
(when successful)
or -1
(when the file could not be renamed).
COMPLIANCE
ANSI C requires
rename,
but only specifies that the result on failure be nonzero. The effects of
using the name of an existing file as *new
may vary from one implementation to
another.