2.13.5. rename()

stdio.h に含まれている標準 C ライブラリの rename() 関数です。

構文

int rename(const char *old, const char *new);

使用法

rename() によって、old が指す文字列と同じ名前のファイルが、それ以降は new が指す文字列の名前で認識されます。 old が指す文字列が名前として付けられているファイルは事実上削除されます。 new が指す文字列によって識別されるファイルが rename() 関数の呼び出しよりも前に存在していた場合の動作は実装定義です。

戻り値

処理に成功するとゼロが返され、失敗するとゼロ以外の値が返されます。 ゼロ以外の値が返され、ファイルが既に存在した場合、そのファイルはそれ以降も元の名前で識別されます。

Copyright © 2007 ARM Limited. All rights reserved.ARM DUI 0349AJ
Non-Confidential