bool :file-rename ( string $OLDNAME , string $NEWNAME )

Renames a file on the disk from OLDNAME to NEWNAME. Returns true if the operation succeeded, or false if there was an error.

# :file-rename example - poor UNIX mv replica
!if :gt i2 :param-num
    :writeln s'Usage: mv.yuk <oldname> <newname>'
    :exit
!fi
 
!if :not :file-rename (:param-str i0|:param-str i1)
    :writeln s'Unable to rename: ' (:param-str i0) s' -> ' :param-str i1
!fi