rename

ファイル名を変更します． 

#include <stdio.h>

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

rename 関数は引数 old が指すファイルを引数 new が指す文字列を名前とするファイルとして識別できるようにします．ようするにファイルの名前を old から new に変更するということです．

rename を呼び出す前にファイル名が new であるファイルが存在していたときの動作は処理系定義です．

戻り値

  • 操作が成功したとき: 0
  • 操作が失敗したとき: 0以外 ※

※ rename の操作が失敗したときには rename の呼出し前に存在していたファイルは元の名前でアクセス可能です．

C言語サンプルプログラム

rename 関数を使用してファイル名を変更するサンプルプログラムを以下に示します．

/* header files */
#include <stdio.h>
#include <stdlib.h>

/* main */
int main(void) {
    char old[] = "sample01.txt";
    char new[] = "sample02.txt";

    if ( rename(old, new) == 0 ) {
        printf("%sの名前を%sに変更しました．\n", old, new);
    } else {
        fprintf(stderr, "%sのリネームに失敗しました．\n", old);
    }

    return EXIT_SUCCESS;
}

実行例

サンプルプログラムの実行結果は以下のようになります．

(カレントディレクトリにsample01.txtが存在する場合)
sample01.txtの名前をsample02.txtに変更しました．

(カレントディレクトリにsample01.txtが存在しない場合)
sample01.txtのリネームに失敗しました．

cプログラマの必読書

たくさんあるc言語関連の書籍の中でも特に役に立った本です．よかったら参考にしてみてください．

c実践プログラミング 第3版

c言語の実践的参考書．少々値段は張りますが初心者を脱しようとしている人は絶対に読むべきです．
文法だけでなく，コーディングスタイルやデバッグなど文字通り「実践的」なことが書かれているので非常にためになります． オライリーの本は，読みにくい本が多いのですが本書はとても読みやすくオススメです．


c言語ポインタ完全制覇 (標準プログラマーズライブラリ)

ポインタの解説書としては最高の書籍です．
この1冊でポインタを完全に理解することができます．全くの初学者が読むには敷居が高いですが，入門書を読み終えた後に読むと非常に有益です．