ユーザ関数

ユーザ関数は、µVision4 デバッガで使用するためにユーザが作成する関数です。ユーザ関数を関数エディタに直接入力することも、INCLUDE コマンドを使用して 1 つまたは複数のユーザ関数が記述されたファイルをロードすることもできます。

注

• µVision4 には、ユーザ関数で使用できるさまざまなシステム変数が用意されています。詳細については、「システム変数」を参照して下さい。

ユーザ関数は FUNC キーワードで始まり、次のように定義されます。

FUNC return_type fname (parameter_list) {
  statements
}

例

次のユーザ関数は、複数の CPU レジスタの内容を表示します。詳細については、「関数の作成」を参照して下さい。

FUNC void MyRegs (void) {
  printf ("---------- MyRegs() ----------\n");
  printf (" R4 R8 R9 R10 R11 R12\n");
  printf (" %04X %04X %04X %04X %04X %04X\n",
            R4,  R8,  R9,  R10, R11, R12);
  printf ("------------------------------\n");
}

この関数を呼び出すには、［コマンド］（Command）ウィンドウに次のように入力します。

MyRegs()

MyRegs 関数を呼び出すと、レジスタの内容が次のように表示されます。

---------- MyRegs() ----------
 R4   R8   R9   R10  R11  R12
 B02C 8000 0001 0000 0000 0000
------------------------------

ユーザ関数を呼び出すための［ツールボックス］（Toolbox）のボタンを定義できます。

DEFINE BUTTON "My Registers", "MyRegs()"

制約

• ユーザ関数の戻り値が、関数の戻り値型に一致するかどうかが自動的にチェックされます。void 戻り値型の関数は、値を返すことができません。void 以外の戻り値型の関数は、値を返す必要があります。有効な戻り値の各戻りパスは自動的にチェックされないので注意して下さい。
• ユーザ関数は、シグナル関数または twatch 関数を呼び出すことができません。
• ローカルオブジェクトの値は、値が割り当てられるまで定義されません。
• ユーザ関数を削除するには、KILL FUNC コマンドを使用します。