RENAME(DOS) XENIX System V RENAME(DOS)
Name
rename - renames a file or directory.
Syntax
#include <io.h>
int rename (newname, oldname);
char *newname;
char *oldname;
Description
The rename function renames the file or directory specified
by oldname to the name given by newname. oldname must
specify the pathname of an existing file or directory.
Newname must not specify the name of an existing file or
directory.
The rename function can be used to move a file from one
directory to another by giving a different pathname in the
newname argument. However, files cannot be moved from one
device to another (for example, from Drive A to Drive B).
Directories can only be renamed, not moved.
Return Value
rename returns 0 if it is successful.
See Also
creat(S), fopen(DOS), open(S)
Example
#include <io.h>
int result;
/* The following statement changes the file "data" to **
have the name "input". */ result = rename ("input",
"data"):
Notes
This call must be compiled with the -dos flag.
Page 1 (printed 8/7/87)