JumpToMatch command: Difference between revisions
Jump to navigation
Jump to search
No edit summary |
No edit summary |
||
| Line 14: | Line 14: | ||
<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:''' | ||
Revision as of 15:53, 6 December 2022
| 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 |