Rename file

18.4.0 released Sep 25, 2023

Rename file

Purpose: Renames a file.

rename-file <from file> to <to file> [ status [ define ] <status> ]

rename-file will rename <from file> to <to file>. Optional <status> variable is VV_OKAY on success and VV_ERR_RENAME on failure, and can be created with optional "define".

<from file> and <to file> must be specified with full paths unless they are in the current working directory (see vv), in which case a name alone will suffice, and can be in different directories.

Examples

Rename files:

rename-file "/home/u1/d1/f1" to "/home/u1/d2/f2" status define st
if (st == VV_OKAY)  {
    @Rename successful. <br/>
}

Rename files in the current working directory:

rename-file "f1" to "f2" status define st
if (st == VV_OKAY)  {
    @Rename successful. <br/>
}