【C言語】ファイルを一括で読み込む方法

2023-07-182024-07-26

この記事では、C言語を使ってファイルを一括で読み込む方法について学びます。

具体的には、fread、fgets、fgetcの3つの関数を使って、バイナリデータやテキストデータを効率的に読み込む方法を紹介します。

また、複数のファイルを一度に読み込む方法や、エラーが発生したときの対処法についても解説します。

初心者の方でもわかりやすく説明しているので、ぜひ最後まで読んでみてください。

目次から探す

一括読み込みの方法

C言語では、ファイルからデータを一括で読み込むためのさまざまな方法があります。

ここでは、fread、fgets、fgetcの3つの関数を使ったファイルの読み込み方法について詳しく解説します。

fread関数の使用

fread関数は、バイナリデータを一括で読み込むために使用されます。

この関数は、指定したサイズのデータを一度に読み込むことができるため、大量のデータを効率的に処理するのに適しています。

freadの基本的な使い方

fread関数の基本的な構文は以下の通りです。

size_t fread(void *ptr, size_t size, size_t count, FILE *stream);

用語	説明
ptr	読み込んだデータを格納するためのポインタです。
size	1つのデータのサイズ(バイト数)です。
count	読み込むデータの個数です。
stream	読み込むファイルのポインタです。

以下は、freadを使ってファイルからデータを読み込むサンプルコードです。

#include <stdio.h>
int main() {
    FILE *file;
    int buffer[10];
    // ファイルをバイナリモードでオープン
    file = fopen("data.bin", "rb");
    if (file == NULL) {
        perror("ファイルオープンエラー");
        return 1;
    }
    // データを一括で読み込む
    size_t elementsRead = fread(buffer, sizeof(int), 10, file);
    printf("読み込んだ要素数: %zu\n", elementsRead);
    // 読み込んだデータを表示
    for (size_t i = 0; i < elementsRead; i++) {
        printf("%d ", buffer[i]);
    }
    printf("\n");
    // ファイルをクローズ
    fclose(file);
    return 0;
}

このコードでは、data.binというバイナリファイルから整数データを一括で読み込み、読み込んだ要素数とその内容を表示します。

読み込むデータのサイズと数

freadを使用する際は、読み込むデータのサイズと数を正しく指定することが重要です。

例えば、sizeof(int)を使って整数のサイズを取得し、必要な個数を指定することで、正確にデータを読み込むことができます。

fgets関数による行単位の読み込み

fgets関数は、テキストファイルから行単位でデータを読み込むために使用されます。

この関数は、指定したバッファに1行分のデータを読み込み、改行文字も含めて格納します。

fgetsの基本的な使い方

fgets関数の基本的な構文は以下の通りです。

char *fgets(char *str, int n, FILE *stream);

用語	説明
str	読み込んだ文字列を格納する配列のポインタです。
n	読み込む最大文字数です。
stream	読み込むファイルのポインタです。

以下は、fgetsを使ってファイルから行単位でデータを読み込むサンプルコードです。

#include <stdio.h>
int main() {
    FILE *file;
    char buffer[256];
    // ファイルをオープン
    file = fopen("data.txt", "r");
    if (file == NULL) {
        perror("ファイルオープンエラー");
        return 1;
    }
    // 行単位でデータを読み込む
    while (fgets(buffer, sizeof(buffer), file) != NULL) {
        printf("読み込んだ行: %s", buffer);
    }
    // ファイルをクローズ
    fclose(file);
    return 0;
}

このコードでは、data.txtというテキストファイルから行単位でデータを読み込み、各行を表示します。

行単位でのデータ処理

fgetsを使用することで、行単位でデータを処理することができます。

読み込んだ行を解析したり、特定の条件に基づいてフィルタリングすることが可能です。

fgetc関数による文字単位の読み込み

fgetc関数は、ファイルから1文字ずつ読み込むために使用されます。

この関数は、テキストファイルの内容を逐次的に処理するのに適しています。

fgetcの基本的な使い方

fgetc関数の基本的な構文は以下の通りです。

int fgetc(FILE *stream);

stream: 読み込むファイルのポインタ

以下は、fgetcを使ってファイルから文字単位でデータを読み込むサンプルコードです。

#include <stdio.h>
int main() {
    FILE *file;
    int ch;
    // ファイルをオープン
    file = fopen("data.txt", "r");
    if (file == NULL) {
        perror("ファイルオープンエラー");
        return 1;
    }
    // 文字単位でデータを読み込む
    while ((ch = fgetc(file)) != EOF) {
        putchar(ch); // 読み込んだ文字を表示
    }
    // ファイルをクローズ
    fclose(file);
    return 0;
}

このコードでは、data.txtというテキストファイルから文字を1つずつ読み込み、読み込んだ文字を表示します。

文字単位でのデータ処理

fgetcを使用することで、文字単位でデータを処理することができます。

特定の文字をカウントしたり、条件に基づいて処理を行うことが可能です。

以上のように、C言語ではfread、fgets、fgetcの3つの関数を使って、さまざまな方法でファイルを一括で読み込むことができます。

それぞれの関数の特性を理解し、適切な方法を選択することが重要です。

複数ファイルの一括読み込み

C言語では、複数のファイルを一括で読み込むことができます。

特に、ディレクトリ内のファイルを自動的に検出し、それらを順次読み込む方法は非常に便利です。

このセクションでは、dirent.hを使用してディレクトリ内のファイルを操作し、各ファイルをオープンして読み込む方法について解説します。

ディレクトリ内のファイルを読み込む

ディレクトリ内のファイルを読み込むためには、dirent.hというヘッダーファイルを使用します。

このヘッダーファイルには、ディレクトリの操作に必要な関数や構造体が定義されています。

dirent.hを使用したディレクトリ操作

まず、dirent.hをインクルードし、ディレクトリをオープンしてファイルをリストアップする基本的なコードを見てみましょう。

#include <stdio.h>
#include <stdlib.h>
#include <dirent.h>
int main() {
    DIR *dir;
    struct dirent *entry;
    // ディレクトリをオープン
    dir = opendir("path/to/directory"); // 読み込みたいディレクトリのパスを指定
    if (dir == NULL) {
        perror("ディレクトリをオープンできません");
        return EXIT_FAILURE;
    }
    // ディレクトリ内のエントリを読み込む
    while ((entry = readdir(dir)) != NULL) {
        // エントリの名前を表示
        printf("%s\n", entry->d_name);
    }
    // ディレクトリをクローズ
    closedir(dir);
    return EXIT_SUCCESS;
}

このコードでは、指定したディレクトリをオープンし、readdir関数を使ってその中のファイル名を一つずつ読み込んで表示しています。

readdirは、ディレクトリ内の次のエントリを返し、すべてのエントリを読み終えるとNULLを返します。

各ファイルのオープンと読み込み

次に、ディレクトリ内の各ファイルをオープンし、内容を読み込む方法を見ていきます。

ファイル名のリストを使用した一括処理

ファイル名をリストに格納し、それを使って各ファイルをオープンする方法を考えます。

以下のコードは、ディレクトリ内のすべてのファイルを読み込む例です。

#include <stdio.h>
#include <stdlib.h>
#include <dirent.h>
#include <string.h>
#define MAX_FILES 100
#define MAX_FILENAME 256
int main() {
    DIR *dir;
    struct dirent *entry;
    char *filenames[MAX_FILES];
    int file_count = 0;
    // ディレクトリをオープン
    dir = opendir("path/to/directory");
    if (dir == NULL) {
        perror("ディレクトリをオープンできません");
        return EXIT_FAILURE;
    }
    // ファイル名をリストに格納
    while ((entry = readdir(dir)) != NULL) {
        if (entry->d_type == DT_REG) { // 通常のファイルのみを対象
            filenames[file_count] = malloc(MAX_FILENAME);
            strcpy(filenames[file_count], entry->d_name);
            file_count++;
        }
    }
    closedir(dir);
    // 各ファイルをオープンして内容を読み込む
    for (int i = 0; i < file_count; i++) {
        FILE *file = fopen(filenames[i], "r");
        if (file == NULL) {
            perror("ファイルをオープンできません");
            continue;
        }
        // ファイルの内容を表示
        char buffer[256];
        while (fgets(buffer, sizeof(buffer), file) != NULL) {
            printf("%s", buffer);
        }
        fclose(file);
        free(filenames[i]); // メモリを解放
    }
    return EXIT_SUCCESS;
}

このコードでは、ディレクトリ内の通常のファイルをリストに格納し、その後、各ファイルをオープンして内容を読み込んでいます。

ファイルの内容は、fgetsを使って行単位で読み込まれ、表示されます。

ファイル名の配列を作成

ファイル名を格納するために、配列を使用しています。

配列のサイズはMAX_FILESで定義されており、これを超えるファイルがある場合は、適切なエラーハンドリングを行う必要があります。

ループを用いたファイルの読み込み

最後に、ループを使用してファイルを一つずつ読み込む方法を示しました。

各ファイルをオープンし、内容を読み込んだ後は、必ずファイルをクローズし、メモリを解放することが重要です。

このようにして、C言語を使ってディレクトリ内の複数のファイルを一括で読み込むことができます。

これにより、大量のデータを効率的に処理することが可能になります。

エラーハンドリング

ファイル操作を行う際には、さまざまなエラーが発生する可能性があります。

これらのエラーを適切に処理することは、プログラムの安定性を保つために非常に重要です。

ここでは、ファイル操作におけるエラーの種類と、それに対するエラーチェックの実装方法について解説します。

ファイル操作におけるエラーの種類

ファイル操作に関連するエラーは主に以下の2つに分類されます。

ファイルが存在しない場合

ファイルをオープンしようとした際に、指定したファイルが存在しない場合、fopen関数はNULLを返します。

この場合、プログラムはファイルが見つからないことを認識し、適切なエラーメッセージを表示する必要があります。

例えば、次のようなコードでファイルをオープンする際にエラーチェックを行います。

#include <stdio.h>
int main() {
    FILE *file = fopen("nonexistent.txt", "r"); // 存在しないファイルをオープン
    if (file == NULL) {
        perror("ファイルをオープンできませんでした");
        return 1; // エラーコードを返す
    }
    fclose(file);
    return 0;
}

このコードでは、fopenがNULLを返した場合にperror関数を使ってエラーメッセージを表示しています。

読み込みエラーの処理

ファイルが存在していても、読み込み中にエラーが発生することがあります。

たとえば、ファイルが破損している場合や、読み込み権限がない場合などです。

このような場合、freadやfgetsなどの関数は、読み込みに失敗したことを示すために、返り値をチェックする必要があります。

以下は、freadを使用した場合のエラーチェックの例です。

#include <stdio.h>
int main() {
    FILE *file = fopen("data.bin", "rb");
    if (file == NULL) {
        perror("ファイルをオープンできませんでした");
        return 1;
    }
    int buffer[10];
    size_t result = fread(buffer, sizeof(int), 10, file);
    if (result < 10) {
        if (feof(file)) {
            printf("ファイルの終わりに達しました\n");
        } else {
            perror("読み込みエラーが発生しました");
        }
    }
    fclose(file);
    return 0;
}

このコードでは、freadの返り値をチェックし、読み込んだデータの数が期待した数より少ない場合に、feofを使ってファイルの終わりに達したかどうかを確認しています。

エラーチェックの実装

エラーハンドリングを行うためには、エラーの種類に応じた適切な処理を実装する必要があります。

errnoの利用

C言語では、エラーの種類を示すためにerrnoというグローバル変数が用意されています。

errnoは、エラーが発生した際にそのエラーコードを格納します。

これを利用することで、エラーの詳細を知ることができます。

以下は、errnoを使用したエラーチェックの例です。

#include <stdio.h>
#include <errno.h>
#include <string.h>
int main() {
    FILE *file = fopen("nonexistent.txt", "r");
    if (file == NULL) {
        printf("エラーコード: %d\n", errno);
        printf("エラーメッセージ: %s\n", strerror(errno));
        return 1;
    }
    fclose(file);
    return 0;
}

このコードでは、ファイルがオープンできなかった場合にerrnoの値を表示し、strerror関数を使ってエラーメッセージを取得しています。

エラーメッセージの表示

エラーメッセージは、ユーザーにとって理解しやすい形で表示することが重要です。

perror関数を使用すると、エラーの内容を簡単に表示できますが、独自のメッセージを追加することも可能です。

以下は、エラーメッセージをカスタマイズして表示する例です。

#include <stdio.h>
#include <errno.h>
#include <string.h>
int main() {
    FILE *file = fopen("data.txt", "r");
    if (file == NULL) {
        fprintf(stderr, "ファイルをオープンできませんでした: %s\n", strerror(errno));
        return 1;
    }
    fclose(file);
    return 0;
}

このコードでは、fprintfを使って標準エラー出力にカスタマイズしたエラーメッセージを表示しています。

エラーハンドリングは、プログラムの信頼性を高めるために欠かせない要素です。

適切なエラーチェックを行うことで、予期しない動作を防ぎ、ユーザーにとって使いやすいプログラムを作成することができます。

応用例

読み込んだデータの加工

読み込んだデータを加工することも可能です。

例えば、各行の文字数をカウントしたり、特定のキーワードを含む行だけを抽出したりすることができます。

以下は、行の文字数をカウントする例です。

void read_file_with_count(const char *filename) {
    FILE *file = fopen(filename, "r");
    if (file == NULL) {
        perror("ファイルオープンエラー");
        return;
    }
    char line[256];
    int line_count = 0;
    while (fgets(line, sizeof(line), file)) {
        line_count++;
        printf("行 %d: %s (文字数: %lu)\n", line_count, line, strlen(line));
    }
    fclose(file);
}

この関数では、各行を読み込むたびに行番号とその行の文字数を表示します。

データの集計や分析

さらに、読み込んだデータを集計したり分析したりすることもできます。

例えば、特定の単語の出現回数をカウントするプログラムを作成することができます。

void count_word_occurrences(const char *filename, const char *word) {
    FILE *file = fopen(filename, "r");
    if (file == NULL) {
        perror("ファイルオープンエラー");
        return;
    }
    char line[256];
    int count = 0;
    while (fgets(line, sizeof(line), file)) {
        char *ptr = line;
        while ((ptr = strstr(ptr, word)) != NULL) {
            count++;
            ptr++; // 次の検索のためにポインタを進める
        }
    }
    printf("ファイル %s における '%s' の出現回数: %d\n", filename, word, count);
    fclose(file);
}

この関数では、指定したファイル内で特定の単語が何回出現するかをカウントします。

これにより、データの分析が可能になります。

以上のように、C言語を使ってファイルを一括で読み込む方法を学ぶことで、さまざまなデータ処理や分析が行えるようになります。