setSubstr()
vgLib.setSubstr() 시스템 함수는 하위 문자열의 각 문자를 지정된 문자로 바꿉니다.
vgLib.setSubstr()은 이전 버전과의 호환성을 위해 유지보수되는 다수의 함수 중 하나입니다. 새 코드가 이러한 용도로 표준 EGL 연산자를 사용할 수 있습니다.
구문
vgLib.setSubstr(
target CharType inOut,
targetSubstringIndex INT in,
targetSubstringLength INT in,
source CharType inOut)
- target
- 변경될 변수입니다.
- targetSubstringIndex
- 첫 번째 바이트의 색인 값이 1이면 target에서 하위 문자열의 시작 바이트를 식별합니다. 이 색인은 정수 리터럴 또는 변수(INT 또는 BIN(9))일 수 있습니다.
- targetSubstringLength
- target에서 파생되는 하위 문자열의 바이트 수를 식별합니다. 길이는 정수 리터럴 또는 변수(INT 또는 BIN(9))일 수 있습니다.
- source
- 대상 변수가 CHAR, MBCHAR 또는 HEX인 경우 소스 변수는 1바이트 CHAR, MBCHAR 또는 HEX 변수 또는 CHAR 리터럴이어야 합니다. 대상이 DBCHAR 또는 UNICODE 변수인 경우 소스는 단일 문자 DBCHAR 또는 UNICODE 변수여야 합니다.
오류 고려사항
V6 예외 호환성을 사용하는 경우(V6 예외 호환성 사용 참조) 다음 값이
sysVar.errorCode에서 리턴됩니다.
- 8
- 1 미만 또는 문자열 길이 초과 색인입니다.
- 12
- 1 미만의 길이입니다.
- 20
- DBCHAR 또는 UNICODE 문자열의 색인이 2바이트 문자의 중간을 가리킵니다.
- 24
- DBCHAR 또는 UNICODE 문자열의 길이(바이트)가 홀수입니다(2바이트 길이는 항상 짝수여야 함).
예제
다음 예제는 vgLib.setSubstr() 함수를 표시합니다.
target Char(15) = "abcdefghijklm"; // target is "abcdefghijklm "
vgLib.setSubstr(target,2,5," "); // target is now "a ghijklm "