RENAME — Rename a file

RENAME()

Renames a file from file PATH1 to PATH2. A null character ( CHAR(0) ) can be used to mark the end of the names in PATH1 and PATH2 ; otherwise, trailing blanks in the file names are ignored. If the STATUS argument is supplied, it contains 0 on success or a nonzero error code upon return; see rename(2).

Parameters

  • PATH1 – Shall be of default CHARACTER type.

  • PATH2 – Shall be of default CHARACTER type.

  • STATUS – (Optional) Shall be of default INTEGER type.

Standard:

GNU extension

Class:

Subroutine, function

Syntax:

CALL RENAME(PATH1, PATH2 [, STATUS])
STATUS = RENAME(PATH1, PATH2)
See also:

LINK