名称

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

形式

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

解説

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

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

関連ファイル

/usr/lib/libU7768.a

関連事項

rename(2), perror(3F7768)

バグ

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

NEWS-OSRelease 4.2.1R