RTC
®
5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
492
Ctrl Command set_text_table_pointer
Function stores the absolute start address of a command list in the internal management table for
indexed text strings.
Call
set_text_table_pointer( Index, Pos )
Parameters
Index
Index of the indexed text string whose starting address
Pos
should be entered
in the management table (as an unsigned 32-bit value, allowed range:
[0 … 41]). The same ordering applies as for the load_text_table command:
= 0…9: digits for marking the time and date [0 … 9]
= 10…21: months [January … December]
= 22…28: days-of-the-week [Sunday … Saturday]
= 29: blank character for marking serial numbers
= 30…39: digits for marking serial numbers [0 … 9]
= 40: text for “a.m.”
= 41: text for “p.m.”
Pos
Absolute start address as an unsigned 32-bit value;
allowed range: [0 … (2
20
–1)]
Comments • Indexed text strings can be used for marking time, date or serial numbers (see "Calling
Indexed Text Strings", page 81).
•If
Index
> 41 and/or
Pos
> (2
20
–1), then the command will not be executed
(get_last_error return code
RTC5_PARAM_ERROR
).
•The set_text_table_pointer command can be used for referencing a nonindexed
subroutine, which thereby becomes an indexed text string that is protectable via
save_disk/load_disk and/or callable via the index.
• set_text_table_pointer can also be used to reference anew an indexed subroutine,
character or text string so that it can also be called via a second index. Here, it is pref-
erable to use the copy_dst_src command for index management.
• The start addresses of command lists that are to be referenced with
set_text_table_pointer can be queried via get_input_pointer before loading the
command lists.
• set_text_table_pointer only stores starting addresses in the internal management
table. An indexed text string only gains protection via a subsequent
save_disk/load_disk command.
•
Pos
should not be an arbitrary address within a list. Instead, it should be the starting
address of an actually existing subroutine that was finalized via list_return and does
not contain set_end_of_list.
• The command is synonymous with set_char_table, which was introduced for the
RTC
®
SCANalone Board (standalone version of the RTC
®
4 board).
RTC
®
4
RTC
®
5 new command
References load_text_table, mark_date, mark_serial, mark_time
To Next Page
Loading...
