rename()

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

Show/hide構文

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

Show/hide使用法

この関数のデフォルト実装では、セミホスト機能が使用されます。

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

Show/hide戻り値

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

Show/hide関連項目

参照

『ARM C ライブラリ、C++ ライブラリ、および浮動小数点サポートユーザガイド』

Copyright © 2014 ARM. All rights reserved.ARM DUI 0809AJ
Non-ConfidentialID061814