C言語関数:rename





C言語のページでは、次の内容を解説しております。
C言語の入門講座  C言語の文法を中心に、基本的な関数などの解説をしています。
C言語ケーススタディ  C言語での実践的なプログラミングについて解説をしています。
C言語の関数リファレンス  C言語で用意されている関数を解説しています。
C言語で3次元動画プログラム  C言語で3次元タートルグラフィックを使用した3次元の動画プログラムの作成例です。
C言語の検定試験  C言語の文法に関する検定試験を実施することができます。
C言語でゲーム作成  C言語を使用したゲームの作り方を解説したページも用意しております。



2014年10月より個人の方を対象に、Study C無料提供を開始しました。
C言語を勉強中の方は、学習・教育に最適なC言語インタープリタのStudy Cを使ってみてください(個人の方は無料です)。
大学・高専・高校などの教育機関での採用実績も多数あるロングセラー商品Study Cが、個人向けに無料提供を始めました。
インタープリタの手軽さに加え、ゲームや3Dタートルグラフィックで楽しく勉強したりと、C言語の学習を協力にサポートします。
ブロック崩しゲーム 3Dツリー クリスマスツリー
また、このようなボタンの用意されているページでは、掲載しているプログラムをStudy Cに直接ロードし実行したりすることができます。
Study Cにロードする Study Cにロードし編集する Study Cにロードし実行する
Study C無料利用についての詳細は、このページを参照してください。




■rename
ファイル名の変更

【分類】
ファイル操作関数

【書式】
int rename(const char *oldname, const char *newname);

【パラメータの型と説明】

パラメータ説明
const char *oldname旧ファイル名(パス名)
const char *newname新ファイル名(パス名)

【機能説明】
oldnameで指定されたファイルをnewnameで指定されたファイル名に変更します。
変更に成功したときは0を、失敗したときは-1を返します。

まず、rename()関数がリネーム対象にするファイルを作成します。 「test.txt」というファイルを作成します。 次のコマンドでファイルを作成してください。 また、ファイルの存在はdirコマンドで確認することができます。

C:\StudyC\MyProg>echo test file>test.txt

C:\StudyC\MyProg>dir test.txt
ディレクトリは C:\StudyC\MyProg

test1         txt       21  ...

Study Cを使用している場合は、下記のようにコマンドラインから実行(exprコマンドを使用)して動作を確認することができます。

C:\StudyC\MyProg>expr rename("test.txt", "test1.txt")
<int>0 0x0

C:\StudyC\MyProg>dir test*.txt
ディレクトリは C:\StudyC\MyProg

test1         txt       21  ...

C:\StudyC\MyProg>expr rename("test.txt", "test2.txt")
<int>-1 0xffffffff

C:\StudyC\MyProg>expr rename("test1.txt", "test.txt")
<int>0 0x0

C:\StudyC\MyProg>dir test*.txt
ディレクトリは C:\StudyC\MyProg

test          txt       21  ...

※↑カーソルキーを押すと入力したコマンドが呼び出されるので色々なパターンで試してみてください。

1番目はrename()関数でファイル「test.txt」のファイル名を「test1.txt」に変更しています。
実行に成功しているので0が返されています。
2番目はrename()関数でファイル「test.txt」のファイル名を「test2.txt」に変更しようとしていますが、「test.txt」は存在していなのでエラーとなります。
実行に失敗しているので-1が返されます。
3番目はrename()関数でファイル「test1.txt」のファイル名を「test.txt」に変更しています。これで元のファイル名に戻っています。

通常のコンパイラを使用する場合の使用例は下記になります(もちろんStudy CでもOKです)。
このプログラムを実行する前にtest.txtというファイルをカレントディレクトリに用意しておいてください。

#include <stdio.h>

main()
{
        printf("1...%d\n", rename("test.txt", "test1.txt"));
        printf("2...%d\n", rename("test.txt", "test2.txt"));
}

実行結果は以下になります。

1...0
2...-1

1.rename()関数でファイル「test.txt」のファイル名を「test1.txt」に変更しています。
実行に成功しているので0が返されています。
2.rename()関数でファイル「test.txt」のファイル名を「test2.txt」に変更しようとしていますが、「test.txt」は存在していなのでエラーとなります。
実行に失敗しているので-1が返されます。

エクスプローラなどでファイル名が「test.txt」から「test1.txt」に変更されていることを確認してみてください。

【参照関数】
chmod
remove
unlink