引数xの値を出力するC言語マクロPRINT(x)の定義方法

本記事では、引数として渡された内容をそのまま出力するC言語マクロ PRINT(x) の定義方法を解説します。デバッグ時などに変数やリテラルの中身を手軽に確認できる、覚えておくと便利なテクニックです。

文字列化演算子「#」による実装

この課題を実現するには、プリプロセッサが提供する文字列化演算子（stringize operator）「#」を使用します。マクロ仮引数の直前に「#」を付けると、渡された実引数は自動的に文字列リテラルへと変換されます。そのため、内部で printf() 関数を呼び出すだけで、引数の内容をそのまま出力できます。それでは、具体例を見ていきましょう。

コード例

#include <stdio.h>
#define PRINT(x) printf(#x)
int main () {
    PRINT(Hello);
    printf("\n");
    PRINT(26);
    printf("\n");
    PRINT(2.354721);
    printf("\n");
    return 0;
}

実行結果

Hello
26
2.354721

動作の仕組み

#define PRINT(x) printf(#x) では、記号「#」によって引数が文字列化されるため、PRINT(Hello); はコンパイル前に printf("Hello"); へと展開されます。同様に PRINT(26); は printf("26"); となり、数値もそのまま文字列として出力されます。

ただし、このマクロが出力するのは「評価後の値」ではなく「引数として記述されたテキスト」である点には注意が必要です。たとえば変数名を渡した場合は、その変数名がそのまま表示されます。変数名と実際の値をセットで出力したいデバッグ用途には、次のようにフォーマット指定子と組み合わせる方法もあります。

#define PRINT_VALUE(x) printf(#x " = %d\n", x)

このように文字列化演算子を活用すれば、シンプルな1行マクロで柔軟な出力処理を実現できます。