C-SPY のマクロ関数は、C-SPY 変数定義と、マクロが呼び出されたときに実行されるマクロ文で構成されます。マクロ関数には任意の個数のパラメータを引き渡すことができます。また、マクロ関数は終了時に値を返すことができます。

C-SPY マクロの形式は、以下のとおりです。

macroName (parameterList)
{
  macroBody
}

ここで、parameterList にはコンマ区切りのマクロパラメータリスト、macroBody には C-SPY 変数定義および C-SPY 文を記述します。

タイプチェックは、マクロ関数に引き渡される値とリターン値のいずれでも実行されません。

マクロ変数は、アプリケーション外で定義して配置される変数です。C-SPY式で使用できるほか、アプリケーションデータ（アプリケーションの変数値）を割り当てることができます。C-SPY 式の詳細については、C-SPY式を参照してください。

マクロ変数を定義する構文は、以下のとおりです。

__var nameList;

ここで、nameList にはコンマ区切りの C-SPY 変数名リストを指定します。

マクロ本体の外で定義したマクロ変数は、グローバルスコープになり、デバッグセッション全体に存在します。マクロ本体内部で定義されたマクロ変数は、その定義文の実行時に作成され、マクロから戻るときに破棄されます。

デフォルトでは、マクロ変数は符号付き整数として処理され、0 に初期化されます。式で C-SPY 変数に値を割り当てると、その式の型も変数に適用されます。以下に例を示します。

C のシンボルと C-SPY マクロ変数の間で名前が重複する場合は、C-SPY マクロ変数の方が C の変数よりも優先されます。マクロ変数はデバッガホストに割り当てられるため、アプリケーションは影響されないことに注意してください。

マクロパラメータは、デバイスサポートをパラメータ化するためのものです。名前付きパラメータは通常の C-SPY マクロ変数と同様に動作しますが、以下の点が異なります：

1 つまたは複数のマクロパラメータを定義する際の構文は以下の通りです。

__param param[=value, ...;]

コマンドラインオプション ‑‑macro_param を使用して、パラメータの値を指定します（‑‑macro_paramを参照）。

C のデータ型に加えて、マクロ変数にマクロ文字列の値を保持できます。マクロ文字列は C 言語文字列と異ななることに、注意してください。

C-SPY 式に "Hello!" などの文字列リテラルを書き込む場合、この値はマクロ文字列になります。char* はターゲットメモリの文字列を参照する必要がありますが、C-SPY ではターゲットメモリに実際に存在するいかなる文字列も使用できないため、これは C- 形式文字ポインタ char* ではありません。

__strFind または __subString などの組み込みマクロ関数を使用して、マクロ文字列を操作できます。結果として新しいマクロ文字列が作成されます。str + "tail" のような + 演算子を使用して、マクロ文字列を連結できます。str[3] などのサブスクリプションを使用して、個々の文字も取得できます。sizeof(str) を使用して、文字列の長さを取得できます。マクロ文字列はNULL 終了ではないことに注意してください。

マクロ関数 _ _toString を使用して、アプリケーション内の NULL 終了 C 文字列（char* または char[]）からマクロ文字列に変換します。たとえば、アプリケーションに以下の C 文字列の定義があると仮定します。

char const *cstr = "Hello";

次に、以下のマクロの例を検討します。

__var str;         /* A macro variable */
str = cstr         /* str is now just a pointer to char */
sizeof str         /* same as sizeof (char*), typically 2 or 4 */
str = __toString(cstr,512)  /* str is now a macro string */
sizeof str         /* 5, the length of the string */
str[1]             /* 101, the ASCII code for 'e' */
str += " World!"   /* str is now "Hello World!" */

フォーマットした出力を参照してください。

マクロ文は、相当する C 文と同様に機能します。 以下の C-SPY マクロ文を使用できます。

expression;

if (expression)
  statement

if (expression)
  statement
else
  statement

for (init_expression; cond_expression; update_expression)
  statement

while (expression)
  statement

do
  statement
while (expression);

return;

return expression;

{
  statement1
  statement2
  .
  .
  .
  statementN
}

C-SPY では、フォーマットした出力をさまざまな方法で生成できます。

ここで、argList は C-SPY の式か文字列をコンマで区切ったリストで、fileは _ _openFile システムマクロの実行結果です（__openFileを参照）。

［デバッグログ］ウィンドウにメッセージを出力するには、以下の手順に従います。

var1 = 42;
var2 = 37;
__message "This line prints the values ", var1, " and ", var2, " in the Debug Log window.";

この手順を実行すると、以下のメッセージが［デバッグログ］ウィンドウに出力されます。

This line prints the values 42 and 37 in the Debug Log window.

出力を指定のファイルに書き込む場合 :

__fmessage myfile, "Result is ", res, "!\n";

文字列を生成する場合 :

myMacroVar = __smessage 42, " is the answer.";

myMacroVar に、ここで文字列 "42 is the answer." が格納されます。

__message "The character '", cvar:%c, "' has the decimal value ", cvar;

The character 'A' has the decimal value 65

__message 'A', " is the numeric value of the character ", 'A':%c;

65 is the numeric value of the character A

__message 31:%4x;     // 001f
__message 31:%4d;     //   31
__message 31:%8b;     // 00011111