Scanlab RTC6 PCIe Board - Copy_Dst_Src

RTC6 boards
Doc. Rev. 1.0.21 en-US
10 RTC6 Commands
348
innovators for industry
Ctrl Command copy_dst_src
Function Creates entries in the internal management table for an indexed character, text string or
subroutine with the specified index ( Dst ) by copying the table entries of another index
( Src ).
Call copy_dst_src( Dst, Src, Mode )
Parameters Dst Index of the indexed character, text string or subroutine whose entries should
be copied from Src . As an unsigned 32-bit value.
Allowed value range: [0…1023] for indexed characters or subroutines,
[1024+0…1024+41] for indexed text strings.
Src Index of the indexed character, text string or subroutine whose entries should
be copied to Dst . As an unsigned 32-bit value.
Allowed value range: [0…1023] for indexed characters or subroutines,
[1024+0…1024+41] for indexed text strings.
Mode Determines which management tables are to be changed.
As an unsigned 32-bit value.
Bit #0 = 0: Dst is the index of an indexed character or
the index of an indexed text string.
Bit #0 = 1: Dst is the index of an indexed subroutine.
Bit #1 = 0: Src is the index of an indexed character or
the index of an indexed text string.
Bit #1 = 1: Src is the index of an indexed subroutine.
Bit #2…Bit #31: Not evaluated.
Comments • If an index value ( Dst and/or Src ) is invalid, then copy_dst_src is ignored
(get_last_error return code RTC6_PARAM_ERROR ).
• copy_dst_src creates an additional reference (index) to an indexed character, text
string or subroutine (that can also be called with this new index). copy_dst_src only
alters the corresponding entry in the internal management table and does not modify
the content of the RTC6 List Memory. This allows copying, renumbering or converting
between indexed characters, text strings or subroutines without having to reload each
time.
• A real copy of an indexed character, text string or subroutine in the protected RTC6 List
Memory area “List 3” can be created (subsequent to copy_dst_src) with
save_disk/load_disk. Characters, text strings and/or subroutines with multiple
references are thereby written several times to the RTC6 List Memory. Keep this in mind
in order to prevent unintended memory overflow of the protected RTC6 List Memory
area “List 3”.
• See also Section ”Managing Indexed Characters and Text Strings”, page 120.
RTC4RTC6 New command.
RTC5RTC6 Unchanged functionality.
Version info Available as of DLL 600, OUT 600, RBF 600.
References save_disk, load_disk