Inhaltsverzeichnis
Werbung
Kontrollbefehl copy_dst_src
Funktion
Erstellt in der internen Verwaltungstabelle für ein indiziertes Zeichen, eine indizierte
Zeichenfolge oder ein indiziertes Unterprogramm mit dem angegebenen Index (Dst)
Tabelleneinträge durch Kopieren der Tabelleneinträge zu einem anderen Index (Src).
Aufruf
copy_dst_src( Dst, Src, Mode )
Parameter
Dst
Src
Mode
Hinweise
• Bei ungültigen Indexwerten (Dst und/oder Src) wird der Befehl ignoriert
(get_last_error-Returncode: RTC5_PARAM_ERROR).
• Mit copy_dst_src wird ein indiziertes Zeichen, eine indizierte Zeichenfolge oder ein
indiziertes Unterprogramm ein weiteres Mal referenziert (kann also dann mit einem
weiteren Index aufgerufen werden). Der Befehl ändert nur die entsprechenden Einträge
in der internen Verwaltungstabelle und lässt den Speicherinhalt des Listenspeichers
unverändert. Damit können indizierte Zeichen, Zeichenfolgen und Unterprogramme
dupliziert, umnummeriert oder ineinander konvertiert werden, ohne dass sie jeweils
neu geladen werden müssen.
• Ein echtes Duplikat eines indizierten Zeichens, einer indizierten Zeichenfolge oder eines
indizierten Unterprogramms im geschützten Speicherbereich des Listenspeichers kann
– nachfolgend auf copy_dst_src – mit
referenzierte Zeichen, Zeichenfolgen und/oder Unterprogramme werden dadurch
entsprechend oft in den Listenspeicher geschrieben. Man sollte darauf achten, dass es
dabei zu keinem Speicherüberlauf im geschützten Speicherbereich kommt.
• Siehe auch
®
®
RTC
4 RTC
5 Neuer Befehl.
Verweise
save_disk,
®
®
RTC
5 PCI-Karte, RTC
5 PCI-Express-Karte, RTC
Rev. 1.10 d
10 Befehle und Funktionen
Index (als 32-Bit-Wert ohne Vorzeichen) des indizierten Zeichens, der
indizierten Zeichenfolge oder des indizierten Unterprogramms, dessen
Einträge aus Src kopiert werden sollen.
Zulässiger Wertebereich: [0 ... 1023] für indizierte Zeichen oder
Unterprogramme, [1024+0 ... 1024+41] für indizierte Zeichenfolgen.
Index (als 32-Bit-Wert ohne Vorzeichen) des indizierten Zeichens, der
indizierten Zeichenfolge oder des indizierten Unterprogramms, dessen
Einträge nach Dst kopiert werden sollen.
Zulässiger Wertebereich: [0 ... 1023] für indizierte Zeichen oder
Unterprogramme, [1024+0 ... 1024+41] für indizierte Zeichenfolgen.
Mit diesem Parameter (32-Bit-Wert ohne Vorzeichen) wird festgelegt, welche
Verwaltungstabellen geändert werden sollen:
Bit #0 = 0:Dst ist der Index eines indizierten Zeichens oder einer indizierten
Zeichenfolge.
= 1:Dst ist der Index eines indizierten Unterprogramms.
Bit #1 = 0:Src ist der Index eines indizierten Zeichens oder einer indizierten
Zeichenfolge.
= 1:Src ist der Index eines indizierten Unterprogramms.
Bit #2-31:Werden nicht berücksichtigt.
Abschnitt "Verwalten von indizierten Zeichen und Zeichenfolgen", Seite
load_disk
®
5 PC/104-Plus-Karte, RTC
save_disk/load_disk
erstellt werden. Mehrfach
®
5 PCIe/104-Karte
87.
283
Werbung
Inhaltsverzeichnis
