[Main page] [Overview]     /efun /copy_file

---

SYNOPSIS
int copy_file(string from, string to)

DESCRIPTION
The efun copy_file() will copy the file <from> to the new name <to>.
If <to> exists and is a directory, then <from> will be placed in that
directory and keep its original name.

You must have read permission for <from> and write permission for
the target file to copy the file.

On successfull completion copy_file() will return 0. If any error
occurs, a non-zero value is returned.

EXAMPLE
copy_file("/players/wizard/obj.c", "/players/wizard/newobj.c");

HISTORY
LDMud 3.2.9 restricted the error behaviour to returning non-0.

SEE ALSO
mkdir(E), rmdir(E), rm(E), rename(E)