1.4.42 rename: ファイルの名称変更 (Sun Studio 12: Fortran ライブラリ・リファレンス)

Sun Studio 12: Fortran ライブラリ・リファレンス

1.4.42 `rename`: ファイルの名称変更

関数は、次のように呼び出します。

*`INTEGER4 rename`** status = rename( from, to )
from	*`character`**n	入力	既存ファイルのパス名
to	*`character`**n	入力	ファイルの新しいパス名
戻り値	*`INTEGER4`**	出力	status=0: 正常 status>0: システムエラーコード

to で指定されたファイルがすでに存在する場合、from と to はどちらも同じタイプのファイルでなければならず、かつ同じファイルシステムに存在していなければなりません。to がすでに存在する場合、最初にそのファイルが削除されます。

例: rename() - ファイル trename.old の名前を trename.new に変更します。

demo% cat trename.f
       INTEGER*4 rename, status
       character*18 from/'trename.old'/, to/'trename.new'/
       status = rename( from, to )
       if ( status .ne. 0 ) stop 'rename: error'
       end
demo% f95 trename.f
demo% ls trename*
trename.f trename.old
demo% a.out
demo% ls trename*
trename.f trename.new
demo%

参照: rename(2)、perror(3F)

注意: パス名は、<sys/param.h> で定義されている MAXPATHLEN より長くすることはできません。