【C言語】defineマクロのif文(ifdef)の使い方についてわかりやすく解説

2023 3/29

C言語において、defineマクロを使うことで、コードの可読性や保守性を高めることができます。

その中でも、ifdefを使った条件分岐はデバッグ時に重要です。

本記事では、初心者でも理解しやすいように、ifdefの基本的な使い方から応用まで詳しく解説します。

ifdefとは

ifdefは、C言語においてプリプロセッサディレクティブの一つであり、指定したマクロが定義されている場合にコンパイルする処理を行います。

例えば、以下のようなコードがあったとします。

#include <stdio.h>

#define DEBUG

int main() {
#ifdef DEBUG
    printf("Debug mode\n");
#endif
    printf("Hello, world!\n");
    return 0;
}

この場合、DEBUGというマクロが定義されているため、コンパイル時には「Debug mode」という文字列が出力されます。一方で、DEBUGマクロをコメントアウトすると、「Hello, world!」だけが出力されます。

Visual Studioでは、ビルドモードがDebugの場合、自動的にDEBUGマクロが定義されています。

このようにifdefを使うことで、特定の状況下でのみ実行する処理を記述することができます。また、ifndefを使うことで指定したマクロが未定義の場合に実行する処理を記述することも可能です。

ifdefを使った条件分岐の基本的な書き方

ifdefは、C言語において条件分岐を行うためのプリプロセッサディレクティブの一つです。ifdefを使うことで、あるマクロが定義されているかどうかで処理を分岐することができます。

以下に、ifdefを使った条件分岐の基本的な書き方を示します。

#ifdef マクロ名
    // マクロが定義されている場合の処理
#else
    // マクロが定義されていない場合の処理
#endif

例えば、以下のようにマクロFOOが定義されている場合とそうでない場合で処理を分けたい場合は、以下のように記述します。

#include <stdio.h>

#define FOO 1

int main(void)
{
#ifdef FOO
    printf("FOO は定義されています。\n");
#else
    printf("FOO は定義されていません。\n");
#endif
    
    return 0;
}

上記コードでは、マクロFOOが定義されているため、「FOO は定義されています。」というメッセージが表示されます。

もしマクロFOOが定義されていなければ、「FOO は定義されています。」というメッセージが表示されます。

このようにifdefを使って条件分岐することで、コンパイル時に特定の機能や設定を有効化・無効化することが可能です。

また、ifdefは他のプリプロセッサディレクティブ（例えばifndefやelif）と組み合わせて使用することもできます。

ifdefを使ったdefineマクロのif文の注意点

ifdefを使ったdefineマクロのif文を使用する際には、いくつか注意点があります。

ifdefとendifの対応に注意する

ifdefを使用する場合、必ず対応するendifが必要です。ifdefとendifが対応していない場合、コンパイルエラーが発生します。

defineマクロ名は大文字で定義する

defineマクロ名は大文字で定義することが一般的です。これは、defineマクロ名が大文字であることで、プログラム内で目立ちやすくなり、可読性が向上するためです。