名称

rename − ファイル名の付けかえ

形式

integer function rename (from, to)
character∗(∗) from, to

解説

from は、 既存ファイルのパス名でなければなりません。 to は、 そのファイルの新しいパス名となります。 もし to が既にある場合は、 from と to ともに、 同じタイプのファイルでなければなりません、 と同時に、 同じファイルシステム上になければなりません。 to がある場合、 そのファイルは消されます。

正常終了は、0、 そうでなければ、 システムエラーコードを 返します。 たとえシステムがオペレーションの途中でクラッシュしても to への存在は保証されます。

関連ファイル

/usr/lib/libU77.a

関連事項

rename(2), perror(3F)

バグ

パス名の文字数は、 <sys/param.h> で定義してあるMAXPATHLENより大きくできません。

NEWS-OSRelease 3.3