ファイル

[C言語] fscanf関数の使い方についてわかりやすく詳しく解説

2025-01-18更新日: 2025-01-18

fscanf関数は、C言語でファイルからデータを読み取るために使用される標準ライブラリ関数です。

この関数は、指定されたフォーマットに従ってファイルから入力を解析し、変数に格納します。

使用する際には、まずファイルポインタを取得し、フォーマット指定子を用いて読み取るデータの型を指定します。

fscanf関数は、成功した入力項目の数を返し、エラーが発生した場合やファイルの終端に達した場合には負の値を返します。

正確なデータ読み取りのためには、フォーマット指定子と変数の型を一致させることが重要です。

目次から探す

fscanf関数の基本

fscanf関数とは

fscanf関数は、C言語においてファイルからフォーマットに従ってデータを読み込むための標準ライブラリ関数です。

scanf関数のファイル版と考えることができ、ファイルポインタを使用して、指定されたフォーマットに基づいてデータを読み取ります。

これにより、テキストファイルやバイナリファイルから効率的にデータを取得することが可能です。

fscanf関数の基本的な構文

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

#include <stdio.h>
int fscanf(FILE *stream, const char *format, ...);

FILE *stream: 読み込み対象のファイルポインタを指定します。
const char *format: 読み込むデータのフォーマットを指定します。
...: 読み込んだデータを格納するための変数のアドレスを指定します。

fscanf関数の引数の説明

fscanf関数の引数は以下のように構成されています。

引数名	説明
`FILE *stream`	読み込み対象のファイルを指すポインタです。 `fopen関数`で取得したファイルポインタを使用します。
`const char *format`	読み込むデータのフォーマットを指定する文字列です。フォーマット指定子を用いて、データの型や形式を指定します。
`...`	読み込んだデータを格納するための変数のアドレスを指定します。複数の変数を指定することが可能です。

fscanf関数の戻り値

fscanf関数の戻り値は、正常に読み込んだ項目の数を返します。

読み込みに失敗した場合や、ファイルの終端に達した場合には、特定の値を返します。

正常に読み込んだ項目の数: 読み込んだデータの数を返します。
EOF: ファイルの終端に達した場合や、読み込みエラーが発生した場合に返されます。

この戻り値を利用して、読み込みが成功したかどうかを確認することができます。

たとえば、fscanf関数の戻り値が期待した項目数と一致するかどうかをチェックすることで、データの読み込みが正しく行われたかを判断できます。

fscanf関数の使い方

ファイルからのデータ読み込み

fscanf関数を使用してファイルからデータを読み込むには、まずファイルを開き、ファイルポインタを取得する必要があります。

以下は、ファイルから整数と文字列を読み込む例です。

#include <stdio.h>
int main() {
    FILE *file;
    int number;
    char name[50];
    // ファイルを読み込みモードで開く
    file = fopen("data.txt", "r");
    if (file == NULL) {
        printf("ファイルを開けませんでした。\n");
        return 1;
    }
    // ファイルから整数と文字列を読み込む
    fscanf(file, "%d %s", &number, name);
    // 読み込んだデータを表示
    printf("Number: %d, Name: %s\n", number, name);
    // ファイルを閉じる
    fclose(file);
    return 0;
}

Number: 123, Name: John

この例では、data.txtファイルから整数と文字列を読み込み、コンソールに表示しています。

標準入力からのデータ読み込み

fscanf関数は標準入力からのデータ読み込みにも使用できます。

標準入力からの読み込みには、stdinをファイルポインタとして使用します。

#include <stdio.h>
int main() {
    int age;
    char city[50];
    // 標準入力から整数と文字列を読み込む
    printf("年齢と都市名を入力してください: ");
    fscanf(stdin, "%d %s", &age, city);
    // 読み込んだデータを表示
    printf("Age: %d, City: %s\n", age, city);
    return 0;
}

年齢と都市名を入力してください: 25 Tokyo
Age: 25, City: Tokyo

この例では、ユーザーから年齢と都市名を入力してもらい、そのデータを表示しています。

フォーマット指定子の使い方

fscanf関数では、フォーマット指定子を使用して、読み込むデータの型や形式を指定します。

以下に、数値、文字列、特殊文字の読み込み方法を示します。

数値の読み込み

数値を読み込む際には、%dや%fなどのフォーマット指定子を使用します。

#include <stdio.h>
int main() {
    FILE *file;
    int integer;
    float decimal;
    file = fopen("numbers.txt", "r");
    if (file == NULL) {
        printf("ファイルを開けませんでした。\n");
        return 1;
    }
    // 整数と浮動小数点数を読み込む
    fscanf(file, "%d %f", &integer, &decimal);
    printf("Integer: %d, Decimal: %.2f\n", integer, decimal);
    fclose(file);
    return 0;
}

Integer: 42, Decimal: 3.14

文字列の読み込み

文字列を読み込む際には、%sを使用します。

文字列はスペースで区切られた単語として読み込まれます。

#include <stdio.h>
int main() {
    FILE *file;
    char word[50];
    file = fopen("words.txt", "r");
    if (file == NULL) {
        printf("ファイルを開けませんでした。\n");
        return 1;
    }
    // 文字列を読み込む
    fscanf(file, "%s", word);
    printf("Word: %s\n", word);
    fclose(file);
    return 0;
}

Word: Hello

特殊文字の読み込み

特殊文字を読み込む際には、%cを使用します。

これにより、スペースや改行を含む任意の文字を読み込むことができます。

#include <stdio.h>
int main() {
    FILE *file;
    char character;
    file = fopen("chars.txt", "r");
    if (file == NULL) {
        printf("ファイルを開けませんでした。\n");
        return 1;
    }
    // 1文字を読み込む
    fscanf(file, "%c", &character);
    printf("Character: %c\n", character);
    fclose(file);
    return 0;
}

Character: A

この例では、ファイルから1文字を読み込み、その文字を表示しています。

fscanf関数のエラーハンドリング

fscanf関数を使用する際には、エラーハンドリングが重要です。

エラーが発生した場合、適切に対処することでプログラムの信頼性を向上させることができます。

エラーの種類と対処法

fscanf関数で発生する可能性のあるエラーには、以下のようなものがあります。

エラーの種類	説明	対処法
ファイルオープンエラー	ファイルが存在しない、またはアクセス権がない場合に発生します。	`fopen関数`の戻り値を確認し、 `NULL`の場合はエラーメッセージを表示して終了します。
読み込みエラー	フォーマットに一致しないデータがある場合に発生します。	`fscanf`の戻り値を確認し、期待した項目数と一致しない場合はエラーメッセージを表示します。
ファイル終端エラー	ファイルの終端に達した場合に発生します。	`fscanf`の戻り値が`EOF`の場合、ループを終了するなどの処理を行います。

EOFの扱い方

fscanf関数を使用してファイルを読み込む際、ファイルの終端(EOF)に達したかどうかを確認することが重要です。

fscanfの戻り値がEOFの場合、ファイルの終端に達したことを示します。

以下は、EOFを扱う例です。

#include <stdio.h>
int main() {
    FILE *file;
    int number;
    file = fopen("numbers.txt", "r");
    if (file == NULL) {
        printf("ファイルを開けませんでした。\n");
        return 1;
    }
    // ファイルの終端まで整数を読み込む
    while (fscanf(file, "%d", &number) != EOF) {
        printf("Number: %d\n", number);
    }
    fclose(file);
    return 0;
}

この例では、ファイルの終端に達するまで整数を読み込み続けます。

fscanfの戻り値がEOFになるとループが終了します。

エラーメッセージの取得方法

fscanf関数自体はエラーメッセージを返しませんが、perror関数やstrerror関数を使用して、エラーメッセージを取得することができます。

これにより、エラーの原因を特定しやすくなります。

以下は、perror関数を使用したエラーメッセージの取得例です。

#include <stdio.h>
#include <errno.h>
int main() {
    FILE *file;
    // 存在しないファイルを開こうとする
    file = fopen("nonexistent.txt", "r");
    if (file == NULL) {
        perror("ファイルオープンエラー");
        return 1;
    }
    fclose(file);
    return 0;
}

この例では、存在しないファイルを開こうとした際にperror関数を使用してエラーメッセージを表示しています。

perrorは、errnoの値に基づいて適切なエラーメッセージを出力します。

fscanf関数の応用例

fscanf関数は、さまざまな形式のデータを効率的に読み込むことができるため、応用範囲が広いです。

ここでは、いくつかの応用例を紹介します。

CSVファイルの読み込み

CSVファイルは、カンマで区切られたデータを持つファイル形式です。

fscanf関数を使用してCSVファイルを読み込むことができます。

#include <stdio.h>
int main() {
    FILE *file;
    char name[50];
    int age;
    float salary;
    file = fopen("data.csv", "r");
    if (file == NULL) {
        printf("ファイルを開けませんでした。\n");
        return 1;
    }
    // CSVファイルからデータを読み込む
    while (fscanf(file, "%[^,],%d,%f\n", name, &age, &salary) != EOF) {
        printf("Name: %s, Age: %d, Salary: %.2f\n", name, age, salary);
    }
    fclose(file);
    return 0;
}

この例では、%[^,]を使用してカンマまでの文字列を読み込み、%dと%fで整数と浮動小数点数を読み込んでいます。

複数データ型の読み込み

fscanf関数は、異なるデータ型を一度に読み込むことができます。

以下の例では、整数、文字列、浮動小数点数を一度に読み込んでいます。

#include <stdio.h>
int main() {
    FILE *file;
    int id;
    char name[50];
    float score;
    file = fopen("students.txt", "r");
    if (file == NULL) {
        printf("ファイルを開けませんでした。\n");
        return 1;
    }
    // 複数のデータ型を読み込む
    while (fscanf(file, "%d %s %f", &id, name, &score) != EOF) {
        printf("ID: %d, Name: %s, Score: %.2f\n", id, name, score);
    }
    fclose(file);
    return 0;
}

この例では、学生のID、名前、スコアをそれぞれ異なるデータ型で読み込んでいます。

フォーマット指定子を使ったデータ検証

fscanf関数のフォーマット指定子を活用して、データの形式を検証することができます。

以下の例では、整数と文字列の形式を検証しています。

#include <stdio.h>
int main() {
    FILE *file;
    int number;
    char word[50];
    file = fopen("input.txt", "r");
    if (file == NULL) {
        printf("ファイルを開けませんでした。\n");
        return 1;
    }
    // データの形式を検証しながら読み込む
    while (fscanf(file, "%d %49s", &number, word) == 2) {
        printf("Number: %d, Word: %s\n", number, word);
    }
    fclose(file);
    return 0;
}

この例では、fscanfの戻り値が2であることを確認することで、整数と文字列の両方が正しく読み込まれたかを検証しています。

これにより、データの形式が期待通りであることを確認できます。

fscanf関数の注意点

fscanf関数を使用する際には、いくつかの注意点があります。

これらを理解しておくことで、プログラムの安全性と信頼性を向上させることができます。

バッファオーバーフローのリスク

fscanf関数を使用する際に、バッファオーバーフローが発生するリスクがあります。

特に、文字列を読み込む際に、指定したバッファサイズを超えるデータが入力されると、メモリの不正アクセスが発生する可能性があります。

#include <stdio.h>
int main() {
    FILE *file;
    char buffer[10];
    file = fopen("input.txt", "r");
    if (file == NULL) {
        printf("ファイルを開けませんでした。\n");
        return 1;
    }
    // バッファサイズを指定して文字列を読み込む
    fscanf(file, "%9s", buffer); // バッファサイズを超えないように指定
    printf("Buffer: %s\n", buffer);
    fclose(file);
    return 0;
}

この例では、%9sを使用して、バッファサイズを超えないように文字列を読み込んでいます。

バッファサイズを指定することで、オーバーフローを防ぐことができます。

フォーマット指定子の誤用

fscanf関数でフォーマット指定子を誤用すると、予期しない動作やエラーが発生する可能性があります。

データの型に応じた適切なフォーマット指定子を使用することが重要です。

%d: 整数を読み込む
%f: 浮動小数点数を読み込む
%s: 文字列を読み込む
%c: 1文字を読み込む

例えば、整数を読み込む際に%fを使用すると、正しくデータが読み込まれない可能性があります。

常にデータの型に合ったフォーマット指定子を使用してください。

ファイルポインタの管理

ファイルポインタの管理は、fscanf関数を使用する際に重要な要素です。

ファイルを開いた後は、必ず閉じるようにし、メモリリークを防ぎます。

また、ファイルポインタがNULLでないことを確認してから使用することが重要です。

#include <stdio.h>
int main() {
    FILE *file;
    // ファイルを開く
    file = fopen("data.txt", "r");
    if (file == NULL) {
        printf("ファイルを開けませんでした。\n");
        return 1;
    }
    // ファイル操作を行う
    // ...
    // ファイルを閉じる
    fclose(file);
    return 0;
}