ContinueIf 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">Determines whether the processing of a Debugger macro may continue. I...")
 
No edit summary
 
(2 intermediate revisions by the same user not shown)
Line 2: Line 2:


{|
{|
|width="50%"| '''Action:'''
|width="125px"| '''Action:'''
|width="50%"|
|width="775px"|
<span class="f_Para">Determines whether the processing of a Debugger [[using_debugger_macros.html|macro]] may continue. If the state (&quot;True&quot; or &quot;False&quot;) of a specified command argument ([[working_with_macro_variables.html|macro variable]], [[working_with_macro_functions.html|client function]], or constant) is </span><span class="f_Monospace">True,</span><span class="f_Para"> the macro continues. </span>
<span class="f_Para">Determines whether the processing of a Debugger [[Using Debugger Macros|macro]] may continue. If the state (&quot;True&quot; or &quot;False&quot;) of a specified command argument ([[Working with macro variables|macro variable]], [[Working with Client functions (Debugger)|client function]], or constant) is </span><span class="f_Monospace">True,</span><span class="f_Para"> the macro continues. </span>


<span class="f_Para">If the state of the </span><span class="f_Monospace">continueIf</span><span class="f_Para"> argument or comparison expression is </span><span class="f_Monospace">False,</span><span class="f_Para"> the macro containing this command </span><span class="f_EmphBoldItal">and any macro(s) within which this macro is contained</span><span class="f_Para"> terminate (without error). This behavior contrasts with that of the </span><span class="f_Monospace">[[continuemacroif_cmd.html|continueMacroIf]]</span><span class="f_Para"> command, which exits only the macro containing the </span><span class="f_Monospace">continueMacroIf</span><span class="f_Para"> command. </span>
<span class="f_Para">If the state of the </span><span class="f_Monospace">continueIf</span><span class="f_Para"> argument or comparison expression is </span><span class="f_Monospace">False,</span><span class="f_Para"> the macro containing this command </span><span class="term">and any macro(s) within which this macro is contained</span><span class="f_Para"> terminate (without error). This behavior contrasts with that of the </span><span class="f_Monospace">[[continueMacroIf command|continueMacroIf]]</span><span class="f_Para"> command, which exits only the macro containing the </span><span class="f_Monospace">continueMacroIf</span><span class="f_Para"> command. </span>


'''Syntax:'''  
'''Syntax:'''  


<p class="syntax">continueIf ''test'' </p>
<p class="syntax">continueIf ''test'' </p>
Where ''test'' is:  
Where '''test''' is:  


<span class="f_CodeExample">&amp;var</span><span class="f_Para"> </span><span class="f_CodeExample">|</span><span class="f_Para"> </span><span class="f_CodeExample">&amp;&amp;function</span><span class="f_Para"> </span><span class="f_CodeExample">|</span><span class="f_Para"> </span><span class="f_CodeExample">const</span><span class="f_Para">  </span><span class="f_CodeExample">[</span><span class="f_Para"> </span><span class="f_CodeExample">=</span><span class="f_Para"> </span><span class="f_CodeExample">|</span><span class="f_Para"> </span><span class="f_CodeExample">&lt;&gt; &amp;var</span><span class="f_Para"> </span><span class="f_CodeExample">|</span><span class="f_Para"> </span><span class="f_CodeExample">&amp;&amp;function</span><span class="f_Para"> </span><span class="f_CodeExample">|</span><span class="f_Para"> </span><span class="f_CodeExample">const</span><span class="f_Para"> </span><span class="f_CodeExample">] </span>
<p class="syntax"><span class="f_CodeExample">&amp;var</span><span class="f_Para"> </span><span class="f_CodeExample">|</span><span class="f_Para"> </span><span class="f_CodeExample">&amp;&amp;function</span><span class="f_Para"> </span><span class="f_CodeExample">|</span><span class="f_Para"> </span><span class="f_CodeExample">const</span><span class="f_Para">  </span><span class="f_CodeExample">[</span><span class="f_Para"> </span><span class="f_CodeExample">=</span><span class="f_Para"> </span><span class="f_CodeExample">|</span><span class="f_Para"> </span><span class="f_CodeExample">&lt;&gt; &amp;var</span><span class="f_Para"> </span><span class="f_CodeExample">|</span><span class="f_Para"> </span><span class="f_CodeExample">&amp;&amp;function</span><span class="f_Para"> </span><span class="f_CodeExample">|</span><span class="f_Para"> </span><span class="f_CodeExample">const</span><span class="f_Para"> </span><span class="f_CodeExample">] </span></p>


<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 macro variable that may or may not already exist. </span>
* <span class="term">&amp;var</span><span class="f_ListBul1"> is a macro variable that may or may not already exist. </span>
* <span class="f_EmphItal">&amp;&amp;function</span><span class="f_ListBul1"> is a Client function. </span>
* <span class="term">&amp;&amp;function</span><span class="f_ListBul1"> is a Client function. </span>
* <span class="f_EmphItal">const</span><span class="f_ListBul1"> is a constant. </span>
* <span class="term">const</span><span class="f_ListBul1"> is a constant. </span>


'''Notes:'''
'''Notes:'''

Latest revision as of 00:57, 26 January 2023

Action:

Determines whether the processing of a Debugger macro may continue. If the state ("True" or "False") of a specified command argument (macro variable, client function, or constant) is True, the macro continues.

If the state of the continueIf argument or comparison expression is False, the macro containing this command and any macro(s) within which this macro is contained terminate (without error). This behavior contrasts with that of the continueMacroIf command, which exits only the macro containing the continueMacroIf command.

Syntax:

continueIf test

Where test is:

&var | &&function | const  [ = | <> &var | &&function | const 

Where:

  • &var is a macro variable that may or may not already exist.
  • &&function is a Client function.
  • const is a constant.

Notes:

If continueIf is used with a single argument and that argument is 0 or a zero length (null) string, or if it is undefined, its state is considered to be False. For all other values, its state is considered to be True. In an equality comparison any undefined item makes an equality comparison False.

Example:

# Execute Step and optionally update history
noSpan
step
continueIf &historyWanted
getHistory 
...
continueIf &testMe <> &testMe2 

Scope: Allowed only in Debugger macros
Client menu: --
Introduced: Build 37