C言語のマクロとプリプロセッサを徹底解説！主要ディレクティブと定義済みマクロの使い方

Cプリプロセッサ(CPP)は、コンパイラの一部ではなく、コンパイル処理における独立したステップとして動作します。簡単に言えば、Cプリプロセッサはテキストの置換を行うツールであり、実際のコンパイルが始まる前に必要な前処理をコンパイラに指示する役割を担っています。

プリプロセッサディレクティブの基本ルール

すべてのプリプロセッサコマンドはハッシュ記号(#)で始まります。この記号は空白以外の最初の文字でなければならず、可読性の観点から、プリプロセッサディレクティブは行の先頭(第1カラム)から記述することが推奨されます。

以下に、重要なプリプロセッサディレクティブを一覧でまとめました。

プリプロセッサの実例

ここからは、具体的なコード例を通じて、各ディレクティブの使い方を詳しく見ていきましょう。

#define による定数定義

#define MAX_ARRAY_LENGTH 20

このディレクティブは、ソースコード内の MAX_ARRAY_LENGTH をすべて 20 に置き換えるようCPPに指示します。定数に #define を使うことで、コードの可読性が向上します。

#include によるヘッダファイルの読み込み

#include <stdio.h>
#include "myheader.h"

1行目は、システムライブラリから stdio.h を取得し、その内容を現在のソースファイルに追加するよう指示します。2行目は、カレントディレクトリから myheader.h を取得して同様に追加することを意味します。山括弧(<>)と二重引用符("")で使い分ける点に注意しましょう。

#undef と #define の組み合わせ

#undef FILE_SIZE
#define FILE_SIZE 42

この例では、既に定義されている FILE_SIZE の定義を一度解除し、改めて 42 として再定義しています。

#ifndef による二重定義の防止

#ifndef MESSAGE
#define MESSAGE "You wish!"
#endif

このディレクティブは、MESSAGE がまだ定義されていない場合にのみ、MESSAGE を定義するようCPPに指示します。ヘッダファイルのインクルードガードとして頻繁に使われるパターンです。

#ifdef によるデバッグコードの切り替え

#ifdef DEBUG
/* ここにデバッグ用の処理を記述 */
#endif

この例では、DEBUG が定義されている場合にのみ、囲まれた処理がコンパイル対象となります。gccコンパイラでコンパイル時に -DDEBUG フラグを渡すと DEBUG が定義されるため、デバッグ処理のオン/オフをコンパイル時に簡単に切り替えられます。

ANSI C の定義済みマクロ

ANSI Cでは、あらかじめ定義された複数のマクロが用意されています。これらはプログラム内で自由に参照できますが、直接変更してはいけません。

定義済みマクロの使用例

以下のサンプルコードは、各定義済みマクロの実際の出力を確認できるものです。

#include <stdio.h>
int main() {
    printf("File :%s\n", __FILE__ );
    printf("Date :%s\n", __DATE__ );
    printf("Time :%s\n", __TIME__ );
    printf("Line :%d\n", __LINE__ );
    printf("ANSI :%d\n", __STDC__ );
}

実行結果

File :test.c
Date :Jun 2 2012
Time :03:36:24
Line :8
ANSI :1

このように、定義済みマクロを活用することで、ファイル名や行番号などの情報を簡単に取得でき、デバッグやログ出力の際に非常に役立ちます。プリプロセッサの仕組みを理解することは、効率的なC言語プログラミングの第一歩と言えるでしょう。