ファイルを削除する | Programming Place Plus　Ｃ言語編　逆引き

このページの概要 🔗

このページの解説は C99 をベースとしています。

以下は目次です。

• 目的
• 方法①（remove関数を使う）
  • Ｃ言語の標準ライブラリ関数を使った方法で、どの環境でも使えるはず
  • しかし、ファイルが存在しなかったり、オープンされていたりしたときの挙動が処理系に任されており、そのまま使うと移植性がない
• 方法②（_unlink関数を使う）[非標準]
  • 確実だが、Ｃ言語の標準ライブラリ関数ではないため、使えない環境もあり得る
• 方法③（DeleteFile関数を使う）[Windows]
  • Windows限定

目的 🔗

存在しているファイルを削除したいとします。

方法①（remove関数を使う） 🔗

Ｃ言語の標準ライブラリには、ファイルを削除する目的で使用できる remove関数があります。 remove関数は、厳密には「その名前でのファイルへのアクセスを、再びファイルを生成しない限り、不可能にする」という処理を行うことになっていますが、 普通、これはファイルを削除していると考えて良いはずです。

#include <stdio.h>

/*
    ファイルを削除する。

    file_name: 削除するファイルの名前
    戻り値:   成功したら 0以外、失敗したら 0
*/
int delete_file(const char* file_name)
{
    return !(remove(file_name));
}

int main(void)
{
    if (delete_file("test.txt")) {
        puts("ファイルを削除しました。");
    }
    else {
        puts("ファイルの削除に失敗しました。");
    }
}

実行結果：

ファイルを削除しました。

remove関数の引数には、削除したいファイルの名前を指定します。 戻り値は、ファイルの削除に成功すると 0 を、失敗すると 0以外を返します。 真の方が失敗であることに注意してください。

指定した名前を持ったファイルが存在していなかったり、オープンされていたりした場合の結果は処理系定義です。Windows (Visual Studio) の場合、いずれも失敗と扱われます。

方法②（_unlink関数を使う）[非標準] 🔗

Ｃ言語の標準ライブラリ関数ではありませんが、_unlink関数でもファイルの削除が行えます。

#include <stdio.h>

/*
    ファイルを削除する。

    file_name: 削除するファイルの名前
    戻り値:   成功したら 0以外、失敗したら 0
*/
int delete_file(const char* file_name)
{
    return !(_unlink(file_name));
}

int main(void)
{
    if (delete_file("test.txt")) {
        puts("ファイルを削除しました。");
    }
    else {
        puts("ファイルの削除に失敗しました。");
    }
}

実行結果：

ファイルを削除しました。

_unlink関数を使用するには、<stdio.h> あるいは <io.h> のインクルードが必要です。

_unlink関数の引数には、削除したいファイルの名前を指定します。 戻り値は、ファイルの削除に成功すると 0 を、失敗すると 0以外を返します。 真の方が失敗であることに注意してください。

ファイルが存在しない場合や、オープンされている場合は失敗します。

方法③（DeleteFile関数を使う）[Windows] 🔗

Windows API の DeleteFile関数（→Microsoft Docs）でも、ファイルの削除が行えます。

#include <stdio.h>

/*
    ファイルを削除する。

    file_name: 削除するファイルの名前
    戻り値:   成功したら 0以外、失敗したら 0
*/
int delete_file(const char* file_name)
{
    return DeleteFileA(file_name);
}

int main(void)
{
    if (delete_file("test.txt")) {
        puts("ファイルを削除しました。");
    }
    else {
        puts("ファイルの削除に失敗しました。");
    }
}

実行結果：

ファイルを削除しました。

DeleteFile関数を使用するには、Windows.h のインクルードが必要です。

DeleteFile関数の引数には、削除したいファイルの名前を指定します。 戻り値は、成功した場合は 0以外、失敗した場合は 0 です。

また、DeleteFile は実際にはマクロになっていて、UNICODEマクロの定義の有無によって、ANSI版(char型)の DeleteFileA と、Unicode版(wchar_t型)の DeleteFileW のいずれかに置換されます。 上のサンプルプログラムでは、文字列を const char* で扱っているため、DeleteFileA の方を直接呼び出すようにしていますが、両対応できるのであれば、DeleteFile を使うようにすれば良いです。

ファイルが存在しない場合や、オープンされている場合は失敗します。

参考リンク 🔗

• FIO08-C. オープンしたままのファイルに対する remove() の呼び出しに注意する
  　– オープンされているファイルに対する remove関数の動作について。
• _unlink、_wunlink | Microsoft Docs
  　– Visual Studio の _unlink関数のリファレンスマニュアル。
• DeleteFile function | Microsoft Docs
  　– Windows API の DeleteFile関数のリファレンスマニュアル。
• Programming Place Plus　Ｃ言語編　参考書籍
  　– 当サイトの参考書籍一覧ページ。Ｃ言語に関する書籍を多数紹介。
• Programming Place Plus　Ｃ言語編　リンク集
  　– 当サイトの参考Webサイト集。Ｃ言語の全般的な学習に有益なサイトを紹介。

更新履歴 🔗

• ’2023/2/15
  • コーディング規約を統一（変数や関数の名前をスネークケースにする）
• ’2021/12/11
  • main関数から return 0; を削除（Ｃ言語編全体でのコードの統一）
• ’2019/7/19
  • MSDN に対するリンクを、Microsoft Docs に貼り換え

’2018/4/2　「VisualC++」という表現を「VisualStudio」に統一。

’2018/2/15　新規作成。

逆引きのトップページへ

Ｃ言語編のトップページへ

Programming Place Plus のトップページへ