RTC
®
5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
351
innovators for industry
Undelayed
Short
List Command
mark_char
Function
marks an indexed character.
Call
mark_char( Char )
Parameter
Char
Index of the indexed character to be marked (as an unsigned 32-bit value,
allowed range: [0 … 1023]). The following applies:
Char
= character set number * 256 + ASCII number of the character
(character sets are numbered 0 to 3).
Comments
• The
mark_char
command reads the indexed character’s starting address from the
internal management table based on the supplied index and then calls the command
(also see the comments there), which then starts the corresponding command
list.
• The
mark_char
command starts indexed characters in protected memory (that were
loaded and/or referenced via
) as well as indexed
subroutines in the unprotected list area (that were referenced as characters via
or
).
• If no character is referenced for the supplied index, then the jump will be suppressed
and execution will continue at the command located after the calling position. In some
circumstances, a
might be executed (siehe
).
(
Char
) can be used to determine whether a character has been
referenced for a particular index. If
no
character has been referenced, this command
returns the value “–1” (d.h. 2
32
–1).
• If
Char
> 1023, then
mark_char
will, already during loading, be replaced by a
(
return code
RTC5_PARAM_ERROR
).
• Absolute vector and arc commands will execute absolutely after being called with
mark_char
. If the character needs to execute at various locations within the image field,
then either the command list can only contain relative mark, arc or jump commands or
must be used instead.
• The called character should not contain
commands that also contain this
character. Such text will
not
be marked. The called character itself then might not be
complete.
• Also see
"Character Sets and Text Strings", page 80
.
RTC
®
4
RTC
®
5 new command
References
,
,
