Evaluate command: Difference between revisions

From m204wiki
Jump to navigation Jump to search
(Created page with "__TOC__ {| |width="50%"| '''Action:''' |width="50%"| <span class="f_Para">Constructs and runs a Client command. The </span><span class="f_Monospace">evaluate</span><span clas...")
 
No edit summary
Line 12: Line 12:
<span class="f_Para">where: </span>
<span class="f_Para">where: </span>


*<span class="f_EmphItal">&amp;var</span><span class="f_ListBul1"> is a </span><span class="f_Para">previously defined </span><span class="f_ListBul1">[[working_with_macro_variables.html|macro variable]]. </span>
*<span class="term">&amp;var</span><span class="f_ListBul1"> is a </span><span class="f_Para">previously defined </span><span class="f_ListBul1">[[Working with macro variables|macro variable]]. </span>
* <span class="f_EmphItal">string1</span><span class="f_ListBul1"> and </span><span class="f_EmphItal">string2 </span><span class="f_ListBul1">are</span><span class="f_Para"> single or double quoted string literals. </span>
* <span class="term">string1</span><span class="f_ListBul1"> and </span><span class="term">string2 </span><span class="f_ListBul1">are</span><span class="f_Para"> single or double quoted string literals. </span>
* <span class="f_Para">As of Build 69, an invocation of a Debugger Client [[working_with_macro_functions.html|&amp;&amp;function]] may also be used.</span>
* <span class="f_Para">As of Build 69, an invocation of a Debugger Client [[Working with Client functions (Debugger)|&amp;&amp;function]] may also be used.</span>


<span class="f_Para">No blanks are placed between the argument values when they are concatenated, so you may have to add blanks with quoted string values. </span>
<span class="f_Para">No blanks are placed between the argument values when they are concatenated, so you may have to add blanks with quoted string values. </span>

Revision as of 15:24, 29 November 2022

Action:

Constructs and runs a Client command. The evaluate argument values are concatenated into a single string and run as a Client command.

Syntax:

evaluate {&var|'string1'|"string2"|&&function} ... 

where:

  • &var is a previously defined macro variable.
  • string1 and string2 are single or double quoted string literals.
  • As of Build 69, an invocation of a Debugger Client &&function may also be used.

No blanks are placed between the argument values when they are concatenated, so you may have to add blanks with quoted string values.

Here is a macro definition that makes heavy use of the evaluate command:

# historyButtons.macro: Assign extrabutton<extrBtn>-<extrBtn+3> 
# for history traversal 
# Usage: macro historyButtons <extrBtn> 
extraButtonBar main 
set &bnum = &argstring 
evaluate 'mapButton extrabutton' &bnum ' previousHistory' 
increment &bnum 
evaluate 'mapButton extrabutton' &bnum ' nextHistory' 
increment &bnum  
evaluate 'mapButton extrabutton' &bnum ' firstHistory' 
increment &bnum  
evaluate 'mapButton extrabutton' &bnum ' lastHistory'  
evaluate 'echo buttons ' &argstring '-' &bnum ' set for history'

Client menu:
Introduced: Build 57