Next: , Previous: QTanH Intrinsic, Up: Other Intrinsics


10.5.2.126 Rename Intrinsic (function)

     Rename(Path1, Path2)

Rename: INTEGER(KIND=1) function.

Path1: CHARACTER; scalar; INTENT(IN).

Path2: CHARACTER; scalar; INTENT(IN).

Intrinsic groups: badu77.

Description:

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 nonzero 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).