C-standard-library-c-function-rename

Cライブラリ関数-rename（）

説明

Cライブラリ関数 int rename（const char old_filename、const char * new_filename）は、 *old_filename によって参照されるファイル名を new_filename に変更します。

宣言

rename（）関数の宣言は次のとおりです。

int rename(const char *old_filename, const char *new_filename)

パラメーター

• old_filename -これは、名前を変更および/または移動するファイルの名前を含むC文字列です。
• new_filename -これは、ファイルの新しい名前を含むC文字列です。

戻り値

成功すると、ゼロが返されます。 エラーが発生した場合は-1が返され、errnoが適切に設定されます。

例

次の例は、rename（）関数の使用法を示しています。

#include <stdio.h>

int main () {
   int ret;
   char oldname[] = "file.txt";
   char newname[] = "newfile.txt";

   ret = rename(oldname, newname);

   if(ret == 0) {
      printf("File renamed successfully");
   } else {
      printf("Error: unable to rename the file");
   }

   return(0);
}

いくつかのコンテンツを含むテキストファイル file.txt があるとします。 したがって、上記のプログラムを使用して、このファイルの名前を変更します。 上記のプログラムをコンパイルして実行し、次のメッセージを生成すると、ファイルの名前が newfile.txt ファイルに変更されます。

File renamed successfully