Node: Rename Intrinsic (function), Next: , Previous: QTanH Intrinsic, Up: Other Intrinsics

Rename Intrinsic (function)

     Rename(Path1, Path2)

Rename: INTEGER(KIND=1) function.

Path1: CHARACTER; scalar; INTENT(IN).

Path2: CHARACTER; scalar; INTENT(IN).

Intrinsic groups: badu77.


Renames the file Path1 to Path2. A null character (CHAR(0)) marks the end of the names in Path1 and Path2--otherwise, trailing blanks in Path1 and Path2 are ignored. See rename(2). Returns 0 on success or a non-zero error code.

Due to the side effects performed by this intrinsic, the function form is not recommended.

For information on other intrinsics with the same name: See Rename Intrinsic (subroutine).