Xマクロ

X マクロは、データまたはコードのリストのような構造を生成するためのプログラミング言語 マクロの慣用的な使用法です。コンパイル時など、少なくとも一部のリストがインデックスで構成できない場合に最も役立ちます。対応する項目が同じ順序で宣言または実行される必要がある並列リストを確実に維持できます。

このようなリストの例としては、特に、列挙定数と関数プロトタイプの宣言と連動した配列の初期化、ステートメント シーケンスとスイッチ アームの生成などが挙げられます。

Xマクロの使用は1960年代にまで遡ります。^[1]現代のCおよびC++プログラミング言語でも有用ですが、あまり知られていません。^{[2] [3]}

X マクロ アプリケーションは 2 つの部分で構成されます。

1. リストの要素の定義。
2. リストを拡張して、宣言またはステートメントのフラグメントを生成します。

リストはマクロまたはヘッダー ファイル ( という名前LIST) によって定義されます。マクロまたはヘッダー ファイル自体はコードを生成せず、X要素のデータを使用したマクロ (従来は " " という名前) の呼び出しシーケンスのみで構成されます。 の各展開の前には、リスト要素の構文を使用したLISTの定義が続きますX。 の呼び出しにより、リスト内の各要素が LIST展開されます。X

この例では、変数のリストを定義し、それらの宣言とそれらを出力する関数を自動的に生成します。

まずリストの定義です。リストのエントリには複数の引数を含めることができますが、ここでは変数の名前のみが使用されます。

# LIST_OF_VARIABLES \ 
    X(値1) \ 
    X(値2) \ 
    X(値3)を定義します

次に、このリストを展開して変数宣言を生成します。

#define X(name) int name; 
LIST_OF_VARIABLES 
#undef X

同様の方法で、変数とその値を出力する関数を生成することができます。

void print_variables ( void ) { #define X(name) printf("%s = %d\n", #name, name); LIST_OF_VARIABLES #undef X } 

C プリプロセッサで実行すると、次のコードが生成されます。改行とインデントは読みやすくするために追加されていますが、実際にはプリプロセッサによって生成されていません。

int値1 ; int値2 ; int値3 ; 
 
 

void print_variables ( void ) { printf ( "%s = %d \n " , "value1" , value1 ); printf ( "%s = %d \n " , "value2" , value2 ); printf ( "%s = %d \n " , "value3" , value3 ); } 

      
      
      

この例では、次の方法で X マクロの使用の読みやすさを向上させることを目的としています。

1. リストを定義するマクロの名前の前に「FOR_」を付けます。
2. ワーカー マクロの名前をリスト マクロに渡します。これにより、わかりにくい名前のマクロ (X) の定義が回避され、マクロを未定義にする必要性も軽減されます。
3. ワーカー マクロで可変長マクロ引数の構文"..." を使用すると、必要以上の引数を受け入れることができます。これにより、コードの管理者は、すべてのマクロ定義を更新しなくても、リストに列を追加できます。
4. リスト マクロの引数であるマクロ名として「DO」という名前を使用します。

#define FOR_LIST_OF_VARIABLES(DO) \ 
    DO(id1, name1) \ 
    DO(id2, name2) \ 
    DO(id3, name3) \

上記のように、このリストを実行して変数宣言を生成します。

#define DEFINE_NAME_VAR(id, name, ...) int name; 
FOR_LIST_OF_VARIABLES ( DEFINE_NAME_VAR )  

または列挙を宣言します。

#define DEFINE_ENUMERATION(id, name, ...) name = id, 
enum my_id_list_type { FOR_LIST_OF_VARIABLES ( DEFINE_ENUMERATION ) }  
      

同様の方法で、変数とその名前を出力する関数を生成することができます。

void print_variables ( void ) { #define PRINT_NAME_AND_VALUE(id, name, ...) printf("%s = %d\n", #name, name); FOR_LIST_OF_VARIABLES ( PRINT_NAME_AND_VALUE ) } 


  

• X マクロに関する Wikibooks
• 可変長マクロ