Die Systemfunktion vgLib.copyStr() kopiert Zeichen aus einer Unterzeichenfolge in eine andere. Trotz des Namens können Sie keine Zeichenfolgen mit dieser Funktion verwenden.
vgLib.copyStr() ist eine von vielen Funktionen, die zum Zweck der Kompatibilität mit früheren Versionen beibehalten wird. Neuer Code sollte Standard-EGL-Operatoren für diese Zwecke einsetzen.
Wenn die Quellenunterzeichenfolge länger ist als die Zielunterzeichenfolge, wird die Quellenunterzeichenfolge abgeschnitten. Wenn die Quellenunterzeichenfolge kürzer ist als die Zielunterzeichenfolge, wird die Quellenunterzeichenfolge auf der rechten Seite mit Leerzeichen gefüllt.
vgLib.copyStr(
target CHAR | DBCHAR | MBCHAR | UNICODE | NUM inOut,
targetSubstringIndex INT in,
targetSubstringLength INT in,
source CHAR | DBCHAR | MBCHAR | UNICODE | NUM in,
sourceSubstringIndex INT in,
sourcetSubstringLength INT in)
Im folgenden Beispiel werden die Zeichen in source in die Mitte der Zeichen in target kopiert:
target, source CHAR (6); // index must be multiple of 2
target = "120056";
source = "34";
vgLib.copyStr(target,3,2,source,1,2); // target = "123456"