Get_Char_Pointer - Scanlab RTC6 PCIe Board Installation And Operation Manual

Ctrl Command get_char_pointer
Function Returns the absolute start address of an indexed character.
CharPointer = get_char_pointer( Char )
Call
Char
Parameters
Result Absolute start address.
As an unsigned 32-bit value.
• get_char_pointer reads from the internal management table the start address of the
Comments
indexed character with the specified index. Whether the read address resides in a
protected or the unprotected
character has been loaded into the protected
unprotected subroutine has been only subsequently referenced.
• If Index > 1023 or if no character has been referenced with the specified index, then
get_char_pointer returns the value "–1" (for example, 2
• get_char_pointer is useful for checking if a character has already been defined or for
calling an indexed character by an absolute memory address as if it were a non-indexed
subroutine, for example, for conditional execution with list_call_cond. Be aware,
though, that a subsequent
address. And you should ensure that get_char_pointer does not return "–1";
otherwise
RTC4RTC6 New command.
RTC5RTC6 Unchanged functionality.
Version info Available as of DLL 600, OUT 600, RBF 600.
References get_sub_pointer,
RTC6 boards
Doc. Rev. 1.0.21 en-US
10 RTC6 Commands
Index of the indexed character.
As an unsigned 32-bit value.
Allowed value range: [0...1023].
RTC6 List Memory
save_disk/load_disk
list_call_cond is ignored.
get_text_table_pointer
area depends on whether the
RTC6 List Memory area "List 3" or an
32
–1).
might alter the absolute memory
395