where:

The definition contains a macro name, the parameters passed to the macro, the source lines of the macro, and a terminating period as the first and only character on the last line.

After a macro has been loaded into RealView Debugger, the definition is stored in the symbol table. If the symbol table is recreated, for example when an image is loaded with symbols, any macros are automatically deleted. The number of macros that can be defined is limited only by the available memory on your workstation.

Macros can be invoked by name on the command line where the name does not conflict with other commands or aliases and the return value is not required. You can also invoke a macro on the command line using the MACRO command, and in expressions, for example using the CEXPRESSION command.

Macros can also be invoked as actions associated with:

If you require a breakpoint that, when the condition is met, does something and then continues program execution, you must use the breakpoint continue qualifier, or return 1 from the macro call, instead of the GO command. See the breakpoint command descriptions for more details.

The following examples show how to use DEFINE:

define float square(f)
 float f;
{
  return (f*f);
}
.

define show_i()
{
  int i;
  i = 10;
  $printf "value of i = %d\n", i$;
  return (1);
}
.

define /R int userPrompt()
{
  char userPromptBuffer[100];
  int retval;
  retval = prompt_text( "Please enter text", userPromptBuffer );
  if (retval == 0) {
    $printf "Clicked OK\n"$;
    $printf "%s\n", userPromptBuffer$;
  } else
    $printf "Clicked Cancel\n"$;
  return 1;
}
.

The following commands provide similar or related functionality: