Scanlab RTC6 PCIe Board - Get_Char_Pointer

RTC6 boards
Doc. Rev. 1.0.21 en-US
10 RTC6 Commands
395
innovators for industry
Ctrl Command get_char_pointer
Function Returns the absolute start address of an indexed character.
Call CharPointer = get_char_pointer( Char )
Parameters Char Index of the indexed character.
As an unsigned 32-bit value.
Allowed value range: [0…1023].
Result Absolute start address.
As an unsigned 32-bit value.
Comments • get_char_pointer reads from the internal management table the start address of the
indexed character with the specified index. Whether the read address resides in a
protected or the unprotected RTC6 List Memory area depends on whether the
character has been loaded into the protected RTC6 List Memory area “List 3” or an
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
32
–1).
• 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 save_disk/load_disk might alter the absolute memory
address. And you should ensure that get_char_pointer does not return “–1”;
otherwise list_call_cond is ignored.
RTC4RTC6 New command.
RTC5RTC6 Unchanged functionality.
Version info Available as of DLL 600, OUT 600, RBF 600.
References get_sub_pointer, get_text_table_pointer