JumpToLine 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 specified request statement in the </span><span class="f_GUIlabel">Source Cod...")
 
No edit summary
Line 4: Line 4:
|width="50%"| '''Action:'''
|width="50%"| '''Action:'''
|width="50%"|
|width="50%"|
<span class="f_Para">Transfers control to a specified request statement in the </span><span class="f_GUIlabel">Source Code</span><span class="f_ListBul2"> </span><span class="f_Para">or </span><span class="f_GUIlabel">Daemon</span><span class="f_Para"> </span><span class="f_ListBul2">page</span><span class="f_Para">, then executes that statement. </span>
<span class="f_Para">Transfers control to a specified request statement in the </span><var>Source Code</var><span class="f_ListBul2"> </span><span class="f_Para">or </span><var>Daemon</var><span class="f_Para"> </span><span class="f_ListBul2">page</span><span class="f_Para">, then executes that statement. </span>


<span class="f_Para">The command's required argument is a number or keyword that indicates the target statement: </span>
<span class="f_Para">The command's required argument is a number or keyword that indicates the target statement: </span>


<p class="syntax">jumpToLine [current | </span><span class="f_MonoItalTable">number</span><span class="f_CodeExample">] </p>
<p class="syntax">jumpToLine [current | </span><span class="term">number</span><span class="f_CodeExample">] </p>


<span class="f_Para">where: </span>
<span class="f_Para">where: </span>
Line 14: Line 14:
*The keyword current specifies a jump to and then execution of the current statement.  
*The keyword current specifies a jump to and then execution of the current statement.  
*''number'' may be in one of three forms: ''nnn'' | -''nnn'' | +''nnn''
*''number'' may be in one of three forms: ''nnn'' | -''nnn'' | +''nnn''
**''nnn'' specifies an &quot;absolute jump&quot; to the ''nnn'' [[tour_tabbed_pages.html#source_code_tab|statement line number]] in the <span class="f_GUIlabel">Source Code</span><span class="f_ListBul2"> </span><span class="f_Para">or </span><span class="f_GUIlabel">Daemon</span><span class="f_Para"> </span><span class="f_ListBul2">page display, then an execution of that statement.  
**''nnn'' specifies an &quot;absolute jump&quot; to the ''nnn'' [[The tabbed pages#Source Code tab|statement line number]] in the <var>Source Code</var><span class="f_ListBul2"> </span><span class="f_Para">or </span><var>Daemon</var><span class="f_Para"> </span><span class="f_ListBul2">page display, then an execution of that statement.  
**''-nnn'' or ''+nnn'' specifies a &quot;relative jump,&quot; jumping the indicated number of statements backward or forward relative to the current (yellow highlighted) line, followed by the execution of that statement.  
**''-nnn'' or ''+nnn'' specifies a &quot;relative jump,&quot; jumping the indicated number of statements backward or forward relative to the current (yellow highlighted) line, followed by the execution of that statement.  
: For example, specifying <span class="f_Monospace">-1</span><span class="f_ListContinue"> reruns the statement prior to the current line. </span><span class="f_Monospace">+1</span><span class="f_ListContinue"> skips the current executable statement and executes the one following it. </span>


<span class="f_ListContinue">For example, specifying </span><span class="f_Monospace">-1</span><span class="f_ListContinue"> reruns the statement prior to the current line. </span><span class="f_Monospace">+1</span><span class="f_ListContinue"> skips the current executable statement and executes the one following it. </span>
<span class="f_Para">If you [[Creating and running a macro|use the command in a macro]]: </span>


<span class="f_Para">If you [[creating_running_macro.html|use the command in a macro]]: </span>
# <span class="f_ListNum1">When you specify the </span><span class="f_Monospace">jumpToLine</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.]] </span>
# <span class="f_ListNum1">Observe the [[Altering the flow of execution#Jump validation rules|jump validation rules.]] </span>


# <span class="f_ListNum1">When you specify the </span><span class="f_Monospace">jumpToLine</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.]] </span>
<span class="f_Para">If you [[Reconfiguring GUI buttons and hot keys|use the command in a mapped button or hot key]]: </span>
# <span class="f_ListNum1">Observe the [[altering_flow_of_execution.html#jump_validation_rules|jump validation rules.]] </span>


<span class="f_Para">If you [[reconfiguring_gui_buttons.html|use the command in a mapped button or hot key]]: </span>
# <span class="f_ListNum1">Do not specify an argument for the </span><span class="f_Monospace">jumpToLine</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 [[Entity name input box|Entity name input box]]. </span>
 
# <span class="f_ListNum1">Do not specify an argument for the </span><span class="f_Monospace">jumpToLine</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 [[entity-name_input.html|Entity name input box]]. </span>
# <span class="f_ListNum1">Observe the jump validation rules. </span>
# <span class="f_ListNum1">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:'''

Revision as of 21:51, 5 December 2022

Action:

Transfers control to a specified request statement in the Source Code or Daemon page, then executes that statement.

The command's required argument is a number or keyword that indicates the target statement:

jumpToLine [current | number] 

where:

  • The keyword current specifies a jump to and then execution of the current statement.
  • number may be in one of three forms: nnn | -nnn | +nnn
    • nnn specifies an "absolute jump" to the nnn statement line number in the Source Code or Daemon page display, then an execution of that statement.
    • -nnn or +nnn specifies a "relative jump," jumping the indicated number of statements backward or forward relative to the current (yellow highlighted) line, followed by the execution of that statement.
For example, specifying -1 reruns the statement prior to the current line. +1 skips the current executable statement and executes the one following it.

If you use the command in a macro:

  1. When you specify the jumpToLine 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 jumpToLine command in the mapping; you specify the argument (the current keyword or a number to indicate the target line) in the Entity name input 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
Retrieved from "https://m204wiki.rocketsoftware.com/index.php?title=JumpToLine_command&oldid=119284"