RTC6 boards
Doc. Rev. 1.0.21 en-US
10 RTC6 Commands
802
Undelayed
Short List
Command
sub_call
Function Causes an unconditional jump to an indexed subroutine.
Call
sub_call( Index )
Parameters
Index
Index of the called indexed subroutine. As an unsigned 32-bit value.
Allowed value range: [0…1023].
Comments • sub_call reads the indexed subroutine’s starting address from the internal
management table based on the supplied index and then calls list_call (see also the
comments there). list_call then triggers the jump to the subroutine.
• sub_call starts indexed subroutines in protected memory (that were loaded and/or
referenced by load_sub, load_disk or copy_dst_src) as well as indexed subroutines in
the unprotected list area (that were referenced by set_sub_pointer or copy_dst_src).
• If no subroutine is referenced for the supplied index, then the jump is suppressed and
execution continues at the command located after the calling position. If applicable, a
list_continue is executed.
get_sub_pointer( Index )
can be used to determine whether a subroutine has been
referenced for a particular index. If no subroutine has been referenced, this command
returns the value “–1” (= 2
32
–1).
• If
Index
> 1023, then sub_call is, already during loading, replaced by a list_nop
(get_last_error return code
RTC6_PARAM_ERROR
).
• Absolute Vector Commands and “Arc” Commands execute absolutely after being
called with sub_call. If the subroutine needs to execute at various locations within the
Image Field, then either the subroutine can only contain relative
[*]mark[*] Commands, arc commands and Jump Commands or sub_call_abs must be
used instead.
RTC4RTC6 New command.
RTC5RTC6 Unchanged functionality.
Version info Available as of DLL 600, OUT 600, RBF 600.
References list_call, sub_call_abs, sub_call_cond
To Next Page
Loading...