JumpToMatch command: Difference between revisions
Jump to navigation
Jump to search
(Created page with "__TOC__ {| |width="50%"| '''Action:''' |width="50%"| <span class="f_Para">Transfers control to a request statement that contains a specified matching string, then attempts to...") |
No edit summary |
||
| (3 intermediate revisions by the same user not shown) | |||
| Line 2: | Line 2: | ||
{| | {| | ||
|width=" | |width="125px"| '''Action:''' | ||
|width=" | |width="775px"| | ||
<span class="f_Para">Transfers control to a request statement that contains a specified matching string, then attempts to execute that statement. </span> | <span class="f_Para">Transfers control to a request statement that contains a specified matching string, then attempts to execute that statement. </span> | ||
| Line 10: | Line 10: | ||
<p class="syntax">jumpToMatch ''string ''</p> | <p class="syntax">jumpToMatch ''string ''</p> | ||
where ''string'' is the string for which a match is searched ''from the top''<span style="font-size: 13px; font-family: Helvetica,'Helvetica Light',Roboto,Arial,sans-serif;"> </span><span class="f_Para">(first) line</span><span style="font-size: 13px; font-family: Helvetica,'Helvetica Light',Roboto,Arial,sans-serif;"> </span><span class="f_Para">in the </span><span class="f_GUIlabel">Source Code</span><span class="f_Para"> or </span><span class="f_GUIlabel">Daemon</span><span class="f_Para"> page. The search string may be a regular expression, as described for the [[ | where ''string'' is the string for which a match is searched ''from the top''<span style="font-size: 13px; font-family: Helvetica,'Helvetica Light',Roboto,Arial,sans-serif;"> </span><span class="f_Para">(first) line</span><span style="font-size: 13px; font-family: Helvetica,'Helvetica Light',Roboto,Arial,sans-serif;"> </span><span class="f_Para">in the </span><span class="f_GUIlabel">Source Code</span><span class="f_Para"> or </span><span class="f_GUIlabel">Daemon</span><span class="f_Para"> page. The search string may be a regular expression, as described for the [[Button Bar|Search button]]. </span> | ||
<span class="f_Para">The nesting level of a statement has no effect on whether it is located. </span> | <span class="f_Para">The nesting level of a statement has no effect on whether it is located. </span> | ||
<span class="f_Para">If a match is not found, </span><span class="f_Monospace">''JumpToMatch string not found''</span><span class="f_Para"> is displayed in the [[ | <span class="f_Para">If a match is not found, </span><span class="f_Monospace">''JumpToMatch string not found''</span><span class="f_Para"> is displayed in the [[Status bar|Status area.]] If a match is found but the statement is not executable, </span><span class="f_Monospace">''Invalid line for jump''</span><span class="f_Para"> is displayed in the </span><span class="f_GUIlabel">Status</span><span class="f_Para"> area. </span> | ||
<span class="f_Para">If you [[ | <span class="f_Para">If you [[Creating and running a macro|use the command in a macro]]: </span> | ||
# When you specify the </span><span class="f_Monospace">JumpToMatch</span><span class="f_ListBul1"> </span><span class="f_ListNum1">command in the macro, explicitly supply its argument (the </span><span class="f_Monospace">current</span><span class="f_ListNum1"> keyword or a number to indicate the target line) or specify an [[ | # When you specify the </span><span class="f_Monospace">JumpToMatch</span><span class="f_ListBul1"> </span><span class="f_ListNum1">command in the macro, explicitly supply its argument (the </span><span class="f_Monospace">current</span><span class="f_ListNum1"> keyword or a number to indicate the target line) or specify an [[Passing a command argument to a macro|argument variable.]] | ||
# Observe the [[ | # Observe the [[Altering the flow of execution#Jump Validation Rules|jump validation rules.]] | ||
<span class="f_Para">If you [[ | <span class="f_Para">If you [[Reconfiguring GUI buttons and hot keys|use the command in a mapped button or hot key]]: </span> | ||
# Do not specify an argument for the </span><span class="f_Monospace">JumpToMatch</span><span class="f_ListBul1"> </span><span class="f_ListNum1">command in the mapping; you specify the argument (the </span><span class="f_Monospace">current</span><span class="f_ListNum1"> keyword or a number to indicate the target line) in the </span><span class=" | # Do not specify an argument for the </span><span class="f_Monospace">JumpToMatch</span><span class="f_ListBul1"> </span><span class="f_ListNum1">command in the mapping; you specify the argument (the </span><span class="f_Monospace">current</span><span class="f_ListNum1"> keyword or a number to indicate the target line) in the </span><span class="term">Search</span><span class="f_Para"> text box.</span><span class="f_ListNum1"> </span> | ||
# Observe the jump validation rules. </span> | # Observe the jump validation rules. </span> | ||
<span class="f_Para">For information about invoking a jump by right clicking a line in the </span>< | <span class="f_Para">For information about invoking a jump by right clicking a line in the </span><var>Source Code</var><span class="f_Para"> or </span><var>Daemon</var><span class="f_Para"> tab, see [[Altering the flow of execution|Altering the flow of execution.]] </span> | ||
|- | |- | ||
| '''Client menu:''' | | '''Client menu:''' | ||
Latest revision as of 21:25, 30 January 2023
| Action: |
Transfers control to a request statement that contains a specified matching string, then attempts to execute that statement. Syntax: jumpToMatch string where string is the string for which a match is searched from the top (first) line in the Source Code or Daemon page. The search string may be a regular expression, as described for the Search button. The nesting level of a statement has no effect on whether it is located. If a match is not found, JumpToMatch string not found is displayed in the Status area. If a match is found but the statement is not executable, Invalid line for jump is displayed in the Status area. If you use the command in a macro:
If you use the command in a mapped button or hot key:
For information about invoking a jump by right clicking a line in the Source Code or Daemon tab, see Altering the flow of execution. |
| Client menu: | -- |
| Introduced: | Build 27 |