4.21 rename()

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

構文

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

使用法

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

戻り値

処理に成功するとゼロが返され、失敗するとゼロ以外の値が返されます。ゼロ以外の値が返され、ファイルが既に存在した場合、そのファイルはそれ以降も元の名前で識別されます。
関連する参考文書
1.6.5 C ライブラリ関数の直接セミホスティング依存関数
非機密扱いPDF file icon PDF 版ARM DUI0808CJ
Copyright © 2014, 2015 ARM.All rights reserved.