Die Systemfunktion vgLib.copyBytes() kopiert die Inhalte einer Unterzeichenfolge in eine andere, Byte für Byte, ohne auf das Format dieses Inhalts zu achten.
vgLib.copyBytes() ist eine von vielen Funktionen, die für die Kompatibilität mit früheren Versionen beibehalten werden. Neuer Code sollte Standard-EGL-Operatoren für diese Zwecke einsetzen.
Wenn die Quelle länger ist als das Ziel, wird sie abgeschnitten. Wenn die Quelle kürzer ist als das Ziel, wird der Quellenwert mit Leerzeichen gefüllt, selbst wenn es sich dabei um einen numerischen Wert handelt.
vgLib.copyBytes(
target HEX inOut,
targetSubstrIndex INT in,
targetSubstrLength INT in,
source HEX inOut,
sourceSubstrIndex INT in,
sourcetSubstrLength INT in)
Im folgenden Beispiel wird die Zeichenfolge source in die Mitte von target kopiert:
target HEX (8) = "1200567"; // target = "12005670"
source HEX (4)= "3478"; // index must be multiple of 2
vgLib.copyBytes(target,2,1,source,1,1); // target = "12345670"