NAME

name - change file name

SYNOPSIS

#include <basic/string.h>

name(sstr, dstr)
struct string *sstr, *dstr;

DESCRIPTION

Name changes the name of the file given by the string pointed to by sstr to the name given by the string pointed to by dstr.  The source string must name an existing file while the destination string must not. 

The renaming is performed with link(2) and unlink(2).  Should the system fail during the renaming, the file can not be lost although it may appear with both names.  A file can not be moved between file systems with this function. 

This function implements the NAME statement. 

SEE ALSO

string(inc)
name(stmt)
link(2), unlink(2) in the UNIX Programmerís Manual

from The Basmark QuickBASIC Programmerís Manual by Lawrence Leinweber