致命的エラー

C言語におけるC1020エラーについて解説

2025-03-25更新日: 2025-03-25

このエラーは、コンパイル時に #endif に対応する条件付きディレクティブ(#if、#ifdef、#ifndef)が不足していることが原因で発生します。

記事ではエラーの具体的な発生例や、正しいディレクティブの使い方、プリコンパイル済みヘッダーとの関係について解説しています。

これにより、コードの記述ミスを防ぎ、適切な対処方法を理解する手助けとなります。

目次から探す

エラー発生原因の詳細
- 条件付きディレクティブの基礎
条件付きプリプロセッサの正しい記述方法
- 対応ディレクティブの組み合わせ
プリコンパイル済みヘッダーとの連携
- ヘッダー読み込み前後の注意点
- コンパイラの処理順序と影響
コード例による検証
- エラー発生コードの具体例
- 修正後コードの提示
まとめ

エラー発生原因の詳細

条件付きディレクティブの基礎

#if, #ifdef, #ifndef の役割と使い方

C言語では、条件付きディレクティブを用いてコンパイル時に特定のコードを有効または無効にすることができます。

具体的には、次のようなディレクティブが利用されます。

#if

条件式が真の場合にのみ、後続のコードを有効にします。

例として、定数がある値以上の場合に処理を行う場合などに用います。

#ifdef

指定したマクロが定義されている場合に、後続のコードを有効にします。

例えば、デバッグ用のマクロが定義されているかどうかのチェックに使用します。

#ifndef

指定したマクロが定義されていない場合に、後続のコードを有効にします。

一般的にインクルードガードとして使用され、複数回のインクルードを防ぐ役割があります。

これらのディレクティブを適切に使用することで、特定のプラットフォームや設定に合わせてコードの一部をコンパイルするかどうかを制御できます。

#endif の過剰記述による不整合

各条件付きディレクティブに対して、必ず対応する#endifが必要です。

しかし、対応する#if, #ifdef, #ifndefが存在しない場所に#endifを記述すると、コンパイラは不整合と判断し、エラー(C1020など)を発生させます。

この問題は、プリプロセッサの対応関係が崩れることから起こるため、コードを書いている際には各ディレクティブの開始と終了のペアを意識することが重要です。

条件付きプリプロセッサの正しい記述方法

対応ディレクティブの組み合わせ

ディレクティブを使用する際は、開始となる#if, #ifdef, #ifndefに対して必ず対応する#endifが必要です。

また、条件が複数重なる場合はそれぞれのブロックで正しく対応付けを行う必要があります。

例えば、次のような記述は正しい対応関係となっています。

正しいコード例による解説

以下のサンプルコードは、DEBUGマクロが定義されている場合にのみデバッグ情報を出力する処理です。

このコードは正しい対応関係を保っているため、C1020エラーは発生しません。

#include <stdio.h>
int main(void) {
    // DEBUGマクロが定義されている場合のみ実行される
#ifdef DEBUG
    printf("デバッグモードです。\n");
#endif
    printf("プログラムが開始されました。\n");
    return 0;
}

デバッグモードです。
プログラムが開始されました。

条件付きディレクティブの組み合わせのポイントは、各ディレクティブが適切にネストされていることです。

無用なディレクティブの記述は、コンパイラの混乱を招く原因となるため、シンプルにまとめる工夫が必要です。

プリコンパイル済みヘッダーとの連携

ヘッダー読み込み前後の注意点

プリコンパイル済みヘッダーを使用する場合、条件付きディレクティブの記述順序に特に注意が必要です。

プリコンパイル済みヘッダーをインクルードする前に条件付きディレクティブを使用すると、コンパイラの読み飛ばしが発生し、意図しない動作やエラーにつながる可能性があります。

一般的には、プリコンパイル済みヘッダーの読み込みは、コード全体の先頭に記述し、その後に条件付きディレクティブを使ってコードを分岐させることが推奨されます。

コンパイラの処理順序と影響

コンパイラは、ソースコード中のプリプロセッサディレクティブを上から順に処理します。

そのため、プリコンパイル済みヘッダーの前に条件付きディレクティブがある場合、ヘッダー情報が正しく反映されず、結果としてエラーが発生する場合があります。

数学的に説明すると、

$Result = {\begin{cases} ヘッダーの処理結果 & (プリプロセッサディレクティブが正しく閉じられている場合) \\ エラー & (条件付きディレクティブの対応が崩れている場合) \end{cases}$

といった形になります。

これにより、条件付きディレクティブとプリコンパイル済みヘッダーの順序は、非常に重要な要素となっています。

コード例による検証

エラー発生コードの具体例

不正な #endif の配置例

次のサンプルコードは、対応するディレクティブが存在しないためにエラーが発生する例です。

コンパイラはこのコードに対して、未対応の#endifがあるとしてエラーを出力します。

#include <stdio.h>
int main(void) {
    // 誤って不要な #endif を記述している例
    // ここで対応するディレクティブがありません
    #endif
    printf("エラーが発生するコード例です。\n");
    return 0;
}

(コンパイルエラー: 予期しない #endif です。)

上記のコードは、単純な例ですが、実際のプロジェクトにおいても似た構造のミスがC1020エラーを引き起こすことがあります。

修正後コードの提示

対応ディレクティブの正しい記述例

正しく条件付きディレクティブを使用した場合、以下のように記述することでエラーは発生しません。

今回の例では、意図的に条件付きブロックを作成し、その後正しく閉じる形で記述しています。

#include <stdio.h>
int main(void) {
    // 条件付きコンパイルの正しい例
#if 1
    // このブロックは常に実行されます
    printf("条件が真の場合の処理です。\n");
#endif  // 対応する #if が正しく閉じられています
    printf("プログラムが正常に終了します。\n");
    return 0;
}

条件が真の場合の処理です。
プログラムが正常に終了します。

この例では、#if 1とその後の#endifがペアとなっており、条件付きディレクティブが正しく扱われています。

条件付きブロック内で複数の処理を行う際も、各ブロックがきちんと閉じられているか確認することがポイントとなります。

まとめ

この記事では、条件付きディレクティブの基本的な使い方と、それに伴うC1020エラーの原因について解説しています。

具体的に、#if、#ifdef、#ifndefの役割と使い方、そして不要な#endifの記述がエラーを引き起こす仕組みが学べます。

また、プリコンパイル済みヘッダーと連携する際の注意点や、各ディレクティブを正しく対応付ける方法を、実践的なコード例を通して確認できます。