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
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 [[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 [[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 you [[creating_running_macro.html|use the command in a macro]]: </span>
<span class="f_Para">If you [[creating_running_macro.html|use the command in a macro]]: </span>

Revision as of 21:32, 26 May 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:

  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