copyStr()
vgLib.copyStr() 시스템 함수는 하나의 하위 문자열에서 다른 하위 문자열로 문자를 복사합니다. 이름인 경우에도 이 함수에 문자열을 사용할 수 없습니다.
vgLib.copyStr()은 이전 버전과의 호환성을 위해 유지보수되는 다수의 함수 중 하나입니다. 새 코드가 이러한 용도로 표준 EGL 연산자를 사용해야 합니다.
소스 하위 문자열이 대상 하위 문자열보다 긴 경우 소스 하위 문자열이 잘립니다. 소스 하위 문자열이 대상 하위 문자열보다 짧은 경우 소스 하위 문자열이 공백으로 오른쪽에서 채워집니다.
구문
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)
- target
- 대상 하위 문자열이 파생되는 문자 변수(STRING 제외) 문자 변수(STRING 제외)입니다.
- targetSubstringIndex
- 첫 번째 바이트의 값이 1이면 target에서 하위 문자열의 시작 바이트를 식별합니다. 이 색인은 정수 리터럴 또는 변수(INT 또는 BIN(9))일 수 있습니다.
- targetSubstringLength
- target에서 파생되는 하위 문자열의 바이트 수를 식별합니다. 이 길이는 정수 리터럴 또는 변수(INT 또는 BIN(9))일 수 있습니다.
- source
- 소스 하위 문자열이 파생되는 문자 변수입니다. 변수 또는 리터럴일 수 있습니다.
- sourceSubstringIndex
- 첫 번째 바이트의 값이 1이면 source에서 하위 문자열의 시작 바이트를 식별합니다. 이 색인은 정수 리터럴 또는 변수(INT 또는 BIN(9))일 수 있습니다.
- sourceSubstringLength
- source에서 파생되는 하위 문자열의 바이트 수를 식별합니다. 이 길이는 정수 리터럴 또는 변수(INT 또는 BIN(9))일 수 있습니다.
오류 고려사항
V6 예외 호환성을 사용하는 경우(V6 예외 호환성 사용 참조) 다음 값이
sysVar.errorCode에 리턴됩니다.
- 8
- 1 미만 또는 문자열 길이 초과 색인입니다.
- 12
- 1 미만의 길이입니다.
- 20
- DBCHAR 또는 UNICODE 문자열의 색인이 2바이트 문자의 중간을 가리킵니다.
- 24
- DBCS 또는 UNICODE 문자열의 길이(바이트)가 홀수입니다(2바이트 길이는 항상 짝수여야 함).
예제
다음 예제는 source 문자를 target 문자의 중간에 복사합니다.
target, source CHAR (6); // index must be multiple of 2
target = "120056";
source = "34";
vgLib.copyStr(target,3,2,source,1,2); // target = "123456"