TRACE マクロは、デバッグ出力を行うときに使います。

TARGET_ENVIRONMENT_SIMULATOR マクロが定義されていると、 TRACE マクロは SFXHelper::dbgprintf ( BREW ヘルパー関数 DBGPRINTF ) に置き換えられます。

SInt16 ComplicatedCaculation(SInt16 data);

Void Evaluate(Void)
{
  SInt16 val = 0;
  ...  // val の値が変化するような処理
  SInt16 result = ComplicatedCalculation(val);
  TRACE("result = %d (in Evaluate, Line = %d)", result, __LINE__);
  ...
}

	注意
	ComplicatedCaculation の戻り値とコード上での現在値を BREW 出力ウィンドウに表示します。

	TARGET_ENVIRONMENT_SIMULATOR マクロが定義されていない場合
	TRACE マクロは "空" として定義されます。TRACE マクロの引数への代入やメンバ変数を変更する関数の呼び出しには注意が必要です。

ただ 1 つの Bool 型引数を持つ ASSERT マクロは、「必ず満足すべき条件」を開発時に検証するときに使います。 (BREW シミュレーター用ビルドとBREW 実機用ビルドでプログラムの動作が異なることがあります。)

TARGET_ENVIRONMENT_SIMULATOR マクロが定義されていると(BREW シミュレーター用ビルドの場合)、 引数を評価した値が false であれば、ソースファイル名と行番号を含む警告メッセージとを BREW 出力ウィンドウに表示します。

// Example.cpp

SFMTYPEDEFCLASS(MyClass)
class MyClass{
public:
  Initialize(Void);
...
};

...
// ここが 4093 行目
Void Function(MyClassConstPtr obj)
{
  ASSERT(obj != null); // Function に渡される引数の値が NULL でないことを検証する
  obj->Initialize;
...
}
...

	注意
	obj が空ポインターではないことを確認しています。 obj が空ポインターである場合は、BREW 出力ウィンドウに ASSERT failed : line 4096, file 'Example.cpp' と表示します。

	TARGET_ENVIRONMENT_SIMULATOR マクロが定義されていない場合(BREW 実機用ビルドの場合)
	ASSERT マクロは "空" として定義されます。ASSERT マクロの引数への代入やメンバ変数を変更する関数の呼び出しには注意が必要です。

	その他
	ASSERT マクロは引数の比較結果が偽の場合は警告メッセージを表示するだけです。プログラムは停止しません。

ただ 1 つの Bool 型引数を持つVERIFY マクロは、「必ず満足すべき条件」を開発時に検証するときに使います。 (BREW シミュレーター用ビルドとBREW 実機用ビルドでプログラムの動作は同じです。)

TARGET_ENVIRONMENT_SIMULATOR マクロが定義されていると(BREW シミュレーター用ビルドの場合)、 引数を評価した値が false であれば、ソースファイル名と行番号を含む警告メッセージとを BREW 出力ウィンドウに表示します。

TARGET_ENVIRONMENT_SIMULATOR マクロが定義されていないと(BREW 実機用ビルドの場合)、 引数の評価だけを行います。

	TARGET_ENVIRONMENT_SIMULATOR マクロが定義されていない場合(BREW 実機用ビルドの場合)
	ASSERT マクロと違うのは、VERIFY マクロの場合、引数が評価される点だけです。