JumpToMatch 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">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="50%"| '''Action:'''
|width="125px"| '''Action:'''
|width="50%"|
|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 [[review_common_buttons.html|Search button]]. </span>
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 [[glance_at_status_area.html|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 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 [[creating_running_macro.html|use the command in a macro]]: </span>
<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 [[passing_arguments_to_macros.html|argument variable.]]  
# 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 [[altering_flow_of_execution.html#jump_validation_rules|jump validation rules.]]
# Observe the [[Altering the flow of execution#Jump Validation Rules|jump validation rules.]]


<span class="f_Para">If you [[reconfiguring_gui_buttons.html|use the command in a mapped button or hot key]]: </span>
<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="f_GUIlabel">Search</span><span class="f_Para"> text box.</span><span class="f_ListNum1"> </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="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_GUIlabel">Source Code</span><span class="f_Para"> or </span><span class="f_GUIlabel">Daemon</span><span class="f_Para"> tab, see [[altering_flow_of_execution.html|Altering the flow of execution.]] </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:

  1. When you specify the JumpToMatch command in the macro, explicitly supply its argument (the current keyword or a number to indicate the target line) or specify an argument variable.
  2. Observe the jump validation rules.

If you use the command in a mapped button or hot key:

  1. Do not specify an argument for the JumpToMatch command in the mapping; you specify the argument (the current keyword or a number to indicate the target line) in the Search text box.
  2. Observe the jump validation rules.

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