Scanlab RTC 5 PC Interface Board - load_sub; load_text_table

RTC
®
5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
344
innovators for industry
Ctrl Command load_sub
Function assigns a desired index to a subroutine defined by subsequent list commands and loads
the subroutine into the protected buffer area (“List 3”)
Call
load_sub( Index )
Parameter Index Index of the indexed subroutine as an unsigned 32-bit value,
permissible range [0 … 1023]
Comments • Up to 1024 indexed subroutines can be stored. If Index > 1023 then the load_sub
command will be ignored (get_last_error return code
RTC5_PARAM_ERROR ).
• The address in the protected buffer area where the subroutine should be stored is auto-
matically determined and internally managed.
• Indexed subroutines must be terminated with a list_return command. This is a prereq-
uisite for actual storage of the commands, entry of the start address and other infor-
mation (e.g., the number of commands) into the internal management table, and
initiating a flush of the list input buffer (see page 71). Otherwise (the input pointer will
be altered without a preceding list_return command) the subroutine with this index
will not be available.
• An indexed subroutine will not be stored if the protected buffer area (“List 3”) was not
previously configured for a sufficient size beyond “List 1” and “List 2”.
•If list_return is the next command after load_sub, then the corresponding subroutine
will be deleted from the internal management table.
• Indexed subroutines can be called via the sub_call command along with the corre-
sponding index (see "Calling Subroutines", page 77).
• Observe all notes in the section "Indexed Subroutines", page 76.
RTC
®
4  RTC
®
5new command
References list_return, sub_call, load_char, load_text_table
Ctrl Command load_text_table
Function assigns a desired index to a text string defined by subsequent list commands and loads the
text string into the protected buffer area (“List 3”)
Call
load_text_table( Index )
Parameter Index Index of the indexed text string as an unsigned 32-bit value,
permissible range [0 … 41]