Vely logo install | documentation | examples | changelog
16.10.0 released May 10, 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/>
}

See also
Files ( close-file   copy-file   delete-file   file-position   file_storage   file_uploading   lock-file   open-file   read-file   read-line   rename-file   stat-file   temporary_file   uniq-file   unlock-file   write-file  )  SEE ALL (documentation)


Copyright (c) 2017-2023 Dasoftver LLC