Net.Data 참조서

문자열 함수

다음은 Net.Data가 지원하는 표준 문자열 함수 세트입니다.

DTW_ASSIGN
DTW_CONCAT
DTW_DELSTR
DTW_INSERT
DTW_LASTPOS
DTW_LENGTH
DTW_LOWERCASE
DTW_POS
DTW_REVERSE
DTW_STRIP
DTW_SUBSTR
DTW_TRANSLATE
DTW_UPPERCASE

주의: Net.Data는 OS/400이 아닌 다른 플랫폼상에서는 멀티바이트 문자열 조작을 지원하지 않습니다.

자료 유형	매개변수	사용	설명
문자열	`stringOut`	OUT	stringIn과 같은 문자열이 들어 있는 변수.
문자열	`stringIn`	IN	변수 또는 리터럴 문자열.

자료 유형	매개변수	사용	설명
문자열	`stringIn1`	IN	변수 또는 리터럴 문자열.
문자열	`stringIn2`	IN	변수 또는 리터럴 문자열.
문자열	`stringOut`	OUT	'stringIn1 + stringIn2' 문자열이 들어 있는 변수.

DTW_DELSTR

목적

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

n번째 문자에서 시작하여 length 문자 수만큼 지정된 문자열의 부속 문자열을 삭제합니다.

구문

@DTW_DELSTR(stringIn, n, length, stringOut)
@DTW_DELSTR(stringIn, n, stringOut)
@DTW_rDELSTR(stringIn, n, length)
@DTW_rDELSTR(stringIn, n)

매개변수

표 22. DTW_DELSTR 매개변수

자료 유형 매개변수 사용 설명
문자열 stringIn IN 변수 또는 리터럴 문자열.
정수 n IN 삭제할 부속 문자열이 시작하는 문자의 위치. n이 stringIn 길이보다 큰 경우 stringOut은 stringIn 값으로 설정됩니다.
정수 length OUT 삭제할 부속 문자열의 길이. 생략시 값은 stringIn 끝까지의 모든 문자를 삭제하는 것입니다.
문자열 stringOut OUT 수정된 stringIn 유형이 들어 있는 변수.

자료 유형	매개변수	사용	설명
문자열	`stringIn`	IN	변수 또는 리터럴 문자열.
정수	`n`	IN	삭제할 부속 문자열이 시작하는 문자의 위치. n이 stringIn 길이보다 큰 경우 stringOut은 stringIn 값으로 설정됩니다.
정수	`length`	OUT	삭제할 부속 문자열의 길이. 생략시 값은 stringIn 끝까지의 모든 문자를 삭제하는 것입니다.
문자열	`stringOut`	OUT	수정된 stringIn 유형이 들어 있는 변수.

예

예1:

@DTW_DELSTR("abcde", "3", "2", result)

결과: result = "abe"

예2:

@DTW_rDELSTR("abcde", "6", "1")

결과: "abcde"

DTW_INSERT

목적

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

n번째 문자 다음에 시작하는 다른 문자열에 문자열을 삽입합니다.

구문

@DTW_INSERT(stringIn1, stringIn2, n, length, pad, stringOut)
@DTW_INSERT(stringIn1, stringIn2, n, length, stringOut)
@DTW_INSERT(stringIn1, stringIn2, n, stringOut)
@DTW_INSERT(stringIn1, stringIn2, stringOut)
@DTW_rINSERT(stringIn1, stringIn2, n, length, pad)
@DTW_rINSERT(stringIn1, stringIn2, n, length)
@DTW_rINSERT(stringIn1, stringIn2, n)
@DTW_rINSERT(stringIn1, stringIn2)

매개변수

표 23. DTW_INSERT 매개변수

자료 유형 매개변수 사용 설명
문자열 stringIn1 IN stringIn2에 삽입할 리터럴 문자열 또는 변수.
문자열 stringIn2 IN 변수 또는 리터럴 문자열.
정수 n IN stringIn1이 삽입된 이후 stringIn2내의 문자 위치. n이 stringIn2의 길이보다 큰 경우, 충분한 문자가 생길 때까지 채움 문자로 채워집니다. 생략시 값은 stringIn2의 시작 부분에 삽입하는 것입니다.
정수 length IN 삽입할 stringIn1의 문자 수. 이 매개변수가 stringIn1의 길이보다 큰 경우, 문자열은 채움 문자로 채워집니다. 생략시 값은 stringIn1의 길이입니다.
정수 pad IN n 및 length에 사용되는 채움 문자. 생략시 채움 문자는 공백입니다.
문자열 stringOut OUT stringIn1 일부 또는 전체를 삽입함으로써 수정된 stringIn2가 포함된 변수.

자료 유형	매개변수	사용	설명
문자열	`stringIn1`	IN	stringIn2에 삽입할 리터럴 문자열 또는 변수.
문자열	`stringIn2`	IN	변수 또는 리터럴 문자열.
정수	`n`	IN	stringIn1이 삽입된 이후 stringIn2내의 문자 위치. n이 stringIn2의 길이보다 큰 경우, 충분한 문자가 생길 때까지 채움 문자로 채워집니다. 생략시 값은 stringIn2의 시작 부분에 삽입하는 것입니다.
정수	`length`	IN	삽입할 stringIn1의 문자 수. 이 매개변수가 stringIn1의 길이보다 큰 경우, 문자열은 채움 문자로 채워집니다. 생략시 값은 stringIn1의 길이입니다.
정수	`pad`	IN	n 및 length에 사용되는 채움 문자. 생략시 채움 문자는 공백입니다.
문자열	`stringOut`	OUT	stringIn1 일부 또는 전체를 삽입함으로써 수정된 stringIn2가 포함된 변수.

예

예1:

@DTW_INSERT("123", "abc", result)

결과: result = "123abc"

예2:

@DTW_INSERT("123", "abc", "5", result)

결과: result = "abc 123"

예3:

@DTW_INSERT("123", "abc", "5", "6", result)

결과: result = "abc 123 "

예4:

@DTW_INSERT("123", "abc", "5", "6", "_", result)

결과: result = "abc__123___"

예5:

@DTW_rINSERT("123", "abc", "5", "6", "+")

결과: "abc++123+++"

DTW_LASTPOS

목적

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

n번째 문자에서 시작하여 반대 방향으로로 가면서, 다른 문자열에서 문자열의 마지막 발생 위치를 리턴합니다.

구문

@DTW_LASTPOS(stringIn1, stringIn2, n, position)
@DTW_LASTPOS(stringIn1, stringIn2, position)
@DTW_rLASTPOS(stringIn1, stringIn2, n)
@DTW_rLASTPOS(stringIn1, stringIn2)

매개변수

표 24. DTW_LASTPOS 매개변수

자료 유형 매개변수 사용 설명
문자열 stringIn1 IN stringIn2에서 탐색되는 리터럴 문자열 또는 변수.
문자열 stringIn2 IN 변수 또는 리터럴 문자열.
정수 n IN stringIn1 탐색을 시작할 stringIn2내의 문자 위치. 생략시 값은 첫번째 문자에서 탐색을 시작하는 것입니다.
정수 position OUT stringIn2에 있는 stringIn1의 최종 발생 위치. 발생이 발견되지 않는 경우, 0이 리턴됩니다.

자료 유형	매개변수	사용	설명
문자열	`stringIn1`	IN	stringIn2에서 탐색되는 리터럴 문자열 또는 변수.
문자열	`stringIn2`	IN	변수 또는 리터럴 문자열.
정수	`n`	IN	stringIn1 탐색을 시작할 stringIn2내의 문자 위치. 생략시 값은 첫번째 문자에서 탐색을 시작하는 것입니다.
정수	`position`	OUT	stringIn2에 있는 stringIn1의 최종 발생 위치. 발생이 발견되지 않는 경우, 0이 리턴됩니다.

예

예1:

@DTW_LASTPOS(" ", "abc def ghi", result)

결과: result = "8"

예2:

@DTW_LASTPOS(" ", "abc def ghi", "10", result)

결과: result = "8"

예3:

@DTW_rLASTPOS(" ", "abc def ghi", "7")

결과: "4"

DTW_LENGTH

목적

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

문자열의 길이를 리턴합니다.

구문

@DTW_LENGTH(stringIn, length)
@DTW_rLENGTH(stringIn)

매개변수

표 25. DTW_LENGTH 매개변수

자료 유형 매개변수 사용 설명
문자열 stringIn IN 변수 또는 리터럴 문자열.
정수 length OUT stringIn의 길이가 들어 있는 기호.

자료 유형	매개변수	사용	설명
문자열	`stringIn`	IN	변수 또는 리터럴 문자열.
정수	`length`	OUT	stringIn의 길이가 들어 있는 기호.

예

예1:

@DTW_LENGTH("abcdefgh", result)

결과: result = "8"

예2:

@DTW_rLENGTH("")

결과: "0"

DTW_LOWERCASE

목적

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

모두 소문자에서 문자열을 리턴합니다.

구문

@DTW_LOWERCASE(stringIn, stringOut)
@DTW_rLOWERCASE(stringIn)
@DTW_mLOWERCASE(stringMult1, stringMult2, ..., stringMultn)

매개변수

표 26. DTW_LOWERCASE 매개변수

자료 유형 매개변수 사용 설명
문자열 stringIn IN 대소문자에 관계없이 문자가 있는 리터럴 문자열 또는 변수.
문자열 stringOut OUT 모든 문자가 소문자인 strinIn이 들어 있는 변수.
문자열 stringMult INOUT

입력: 문자열이 들어 있는 변수.
출력: 대문자로 변환된 입력 문자열이 들어있는 변수.

자료 유형	매개변수	사용	설명
문자열	`stringIn`	IN	대소문자에 관계없이 문자가 있는 리터럴 문자열 또는 변수.
문자열	`stringOut`	OUT	모든 문자가 소문자인 strinIn이 들어 있는 변수.
문자열	`stringMult`	INOUT	입력: 문자열이 들어 있는 변수. 출력: 대문자로 변환된 입력 문자열이 들어있는 변수.

예

예1:

@DTW_LOWERCASE("This", stringOut)

결과: stringOut = "this"

예2:

@DTW_rLOWERCASE(string1)

입력: string1 = "Web Pages"
결과: "web pages"

예3:

@DTW_mLOWERCASE(string1, string2, string3)

입력: string1 = "THIS", string2 = "IS", string3 = "LOWERCASE"
결과: string1 = "this", string2 = "is", string3 = "lowercase"

DTW_POS

목적

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

다른 문자열에서 첫번째 문자열의 발생 위치를 리턴합니다.

구문

@DTW_POS(stringIn1, stringIn2, n, nOut)
@DTW_POS(stringIn1, stringIn2, nOut)
@DTW_rPOS(stringIn1, stringIn2, n)
@DTW_rPOS(stringIn1, stringIn2)

매개변수

표 27. DTW_POS 매개변수

자료 유형 매개변수 사용 설명
문자열 stringIn1 IN 탐색할 리터럴 문자열 또는 변수.
문자열 stringIn2 IN 탐색될 리터럴 문자열 또는 변수.
정수 n IN stringIn2에서 탐색을 시작할 문자 위치. 생략시 값은 stringIn2의 첫번째 문자에서 탐색을 시작하는 것입니다.
정수 nOut OUT stringIn2 내에 stringIn1의 첫번째 발생 위치가 들어있는 변수. 발생이 발견되지 않는 경우, 0이 리턴됩니다.

자료 유형	매개변수	사용	설명
문자열	`stringIn1`	IN	탐색할 리터럴 문자열 또는 변수.
문자열	`stringIn2`	IN	탐색될 리터럴 문자열 또는 변수.
정수	`n`	IN	stringIn2에서 탐색을 시작할 문자 위치. 생략시 값은 stringIn2의 첫번째 문자에서 탐색을 시작하는 것입니다.
정수	`nOut`	OUT	stringIn2 내에 stringIn1의 첫번째 발생 위치가 들어있는 변수. 발생이 발견되지 않는 경우, 0이 리턴됩니다.

예

예1:

@DTW_POS("day", "Saturday", result)

결과: result = "6"

예2:

@DTW_POS("a", "Saturday", "3", result)

결과: result = "7"

예3:

@DTW_rPOS(" ", "abc def ghi", "5")

결과: "8"

DTW_REVERSE

목적

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

입력 문자열을 역순으로 합니다.

구문

@DTW_REVERSE(stringIn, stringOut)
@DTW_rREVERSE(stringIn)

매개변수

표 28. DTW_REVERSE 매개변수

자료 유형 매개변수 사용 설명
문자열 stringIn IN 역순으로 할 리터럴 문자열 또는 변수.
문자열 stringOut OUT stringIn의 역순 형태가 들어 있는 변수.

자료 유형	매개변수	사용	설명
문자열	`stringIn`	IN	역순으로 할 리터럴 문자열 또는 변수.
문자열	`stringOut`	OUT	stringIn의 역순 형태가 들어 있는 변수.

예

예1:

@DTW_REVERSE("This is it.", result)

결과: result = ".ti si sihT"

예2:

@DTW_rREVERSE(string1)

입력: string1 = "reversed"
결과: "desrever"

DTW_STRIP

목적

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

선행 공백이나 후행 공백, 또는 입력 문자열의 선후행 공백 모두를 제거합니다.

구문

@DTW_STRIP(stringIn, option, stringOut)
@DTW_STRIP(stringIn, stringOut)
@DTW_rSTRIP(stringIn, option)
@DTW_rSTRIP(stringIn)

매개변수

표 29. DTW_STRIP 매개변수

자료 유형 매개변수 사용 설명
문자열 stringIn IN 변수 또는 리터럴 문자열.
문자열 option IN stringIn에서 제거할 공백을 지정합니다. 생략시 값은 B입니다.

B 또는 b: 선행 및 후행 공백을 모두 제거
L 또는 l: 선행 공백만 제거
T 또는 t: 후행 공백만 제거

문자열 stringOut OUT 옵션으로 지정된대로 공백이 제거된 stringIn이 포함된 변수.

자료 유형	매개변수	사용	설명
문자열	`stringIn`	IN	변수 또는 리터럴 문자열.
문자열	`option`	IN	stringIn에서 제거할 공백을 지정합니다. 생략시 값은 B입니다. B 또는 b: 선행 및 후행 공백을 모두 제거 L 또는 l: 선행 공백만 제거 T 또는 t: 후행 공백만 제거
문자열	`stringOut`	OUT	옵션으로 지정된대로 공백이 제거된 stringIn이 포함된 변수.

예

예1:

@DTW_STRIP("  day ", result)

결과: result = "day"

예2:

@DTW_STRIP("  day ", "T", result)

결과: result = " day"

예3:

@DTW_rSTRIP("  a day  ", "L")

결과: "a day "

DTW_SUBSTR

목적

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

입력 문자열의 부속 문자열을 리턴합니다. 채움 문자가 포함될 수도 있습니다.

구문

@DTW_SUBSTR(stringIn, n, length, pad, stringOut)
@DTW_SUBSTR(stringIn, n, length, stringOut)
@DTW_SUBSTR(stringIn, n, stringOut)
@DTW_rSUBSTR(stringIn, n, length, pad)
@DTW_rSUBSTR(stringIn, n, length)
@DTW_rSUBSTR(stringIn, n)

매개변수

표 30. DTW_SUBSTR 매개변수

자료 유형 매개변수 사용 설명
문자열 stringIn IN 탐색될 리터럴 문자열 또는 변수.
정수 n IN 부속 문자열이 시작하는 문자 위치. 생략시 값은 stringIn의 시작 부분에서 시작하는 것입니다.
정수 length IN 부속 문자열의 문자 수. 생략시 값은 나머지 문자열입니다.
문자열 pad IN n이 stringIn의 길이보다 크거나 length가 stringIn의 길이를 벗어나는 경우 사용되는 채움 문자. 생략시 값은 공백입니다.
문자열 stringOut OUT stringIn의 부속 문자열이 들어 있는 변수.

자료 유형	매개변수	사용	설명
문자열	`stringIn`	IN	탐색될 리터럴 문자열 또는 변수.
정수	`n`	IN	부속 문자열이 시작하는 문자 위치. 생략시 값은 stringIn의 시작 부분에서 시작하는 것입니다.
정수	`length`	IN	부속 문자열의 문자 수. 생략시 값은 나머지 문자열입니다.
문자열	`pad`	IN	n이 stringIn의 길이보다 크거나 length가 stringIn의 길이를 벗어나는 경우 사용되는 채움 문자. 생략시 값은 공백입니다.
문자열	`stringOut`	OUT	stringIn의 부속 문자열이 들어 있는 변수.

예

예1:

@DTW_SUBSTR("abc", "2", result)

결과: result = "bc"

예2:

@DTW_SUBSTR("abc", "2", "4", result)

결과: result = "bc "

예3:

@DTW_SUBSTR("abc", "2", "4", ".", result )

결과: result = "bc.."

예4:

@DTW_rSUBSTR("abc", "2", "6", ".")

결과: "bc...."

DTW_TRANSLATE

목적

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

입력 및 출력 변환 테이블, tableI 및 tableO을 사용하여 입력 문자열에 있는 문자를 변환합니다. 매개변수 목록에 tableI, tableO, pad 등이 없는 경우, stringIn은 대문자로 변환됩니다. 목록에 tableI과 tableo은 있는데 pad가 없는 경우, tableI에서 입력 문자열의 각 문자가 탐색되고 tableO의 해당 문자로 변환됩니다. 매개변수 일람표에 pad가 있는 경우, stringIn과 stringOut의 길이는 같습니다. 입력 문자열에 있는 문자가 tableI에 없는 경우 pad 문자가 사용됩니다. 변환 테이블 길이에는 제한이 없습니다. 변환 테이블이 제공되지 않는 경우, 입력 문자열은 대문자로 변환됩니다.

구문

@DTW_TRANSLATE(stringIn, tableO, tableI, pad, stringOut)
@DTW_TRANSLATE(stringIn, tableO, tableI, stringOut)
@DTW_TRANSLATE(stringIn, tableO, stringOut)
@DTW_TRANSLATE(stringIn, stringOut)
@DTW_rTRANSLATE(stringIn, tableO, tableI, pad)
@DTW_rTRANSLATE(stringIn, tableO, tableI)
@DTW_rTRANSLATE(stringIn, tableO)
@DTW_rTRANSLATE(stringIn)

매개변수

표 31. DTW_TRANSLATE 매개변수

자료 유형 매개변수 사용 설명
문자열 stringIn IN 변수 또는 리터럴 문자열.
문자열 tableO IN 변환 테이블로 사용되는 리터럴 문자열 또는 변수. tableI나 pad를 지정하려면 널 값("")을 사용하십시오. 그렇지 않은 경우, 이 매개변수는 선택 가능합니다.
문자열 tableI IN stringIn에서 탐색될 리터럴 문자열 또는 변수. 채움을 지정하려면 널값("")을 사용하십시오. 그렇지 않은 경우 이 매개변수는 선택적입니다.
문자열 pad IN 사용할 채움 문자. 생략시 값은 공백입니다.
문자열 stringOut OUT stringIn의 부속 문자열이 들어 있는 변수.

자료 유형	매개변수	사용	설명
문자열	`stringIn`	IN	변수 또는 리터럴 문자열.
문자열	`tableO`	IN	변환 테이블로 사용되는 리터럴 문자열 또는 변수. tableI나 pad를 지정하려면 널 값("")을 사용하십시오. 그렇지 않은 경우, 이 매개변수는 선택 가능합니다.
문자열	`tableI`	IN	stringIn에서 탐색될 리터럴 문자열 또는 변수. 채움을 지정하려면 널값("")을 사용하십시오. 그렇지 않은 경우 이 매개변수는 선택적입니다.
문자열	`pad`	IN	사용할 채움 문자. 생략시 값은 공백입니다.
문자열	`stringOut`	OUT	stringIn의 부속 문자열이 들어 있는 변수.

예

예1:

@DTW_TRANSLATE("abbc", result)

결과: result = "ABBC"

예2:

@DTW_TRANSLATE("abbc", "R", "bc", result)

결과: result = "aRR "

예3:

@DTW_rTRANSLATE("abcdef", "12", "abcd", ".")

결과: "12..ef"

예4:

@DTW_rTRANSLATE("abbc", "", "", "")

결과: "abbc"

DTW_UPPERCASE

목적

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

대문자로 문자열을 리턴합니다.

구문

@DTW_UPPERCASE(stringIn, stringOut)
@DTW_rUPPERCASE(stringIn)
@DTW_mUPPERCASE(stringMult1, stringMult2, ..., stringMultn)

매개변수

표 32. DTW_UPPERCASE 매개변수

자료 유형 매개변수 사용 설명
문자열 stringIn IN 대소문자에 관계없이 문자가 있는 리터럴 문자열 또는 변수.
문자열 stringOut OUT 모든 문자가 대문자인 strinIn이 들어 있는 변수.
문자열 stringMult INOUT

입력: 문자열이 들어 있는 변수.
출력: 각 작은 따옴표(')가 두 개의 작은 따옴표로 교체된 입력 문자열이 들어 있는 변수.

자료 유형	매개변수	사용	설명
문자열	`stringIn`	IN	대소문자에 관계없이 문자가 있는 리터럴 문자열 또는 변수.
문자열	`stringOut`	OUT	모든 문자가 대문자인 strinIn이 들어 있는 변수.
문자열	`stringMult`	INOUT	입력: 문자열이 들어 있는 변수. 출력: 각 작은 따옴표(')가 두 개의 작은 따옴표로 교체된 입력 문자열이 들어 있는 변수.

예

예1:

@DTW_UPPERCASE("Test", result)

결과: result = "TEST"

예2:

@DTW_rUPPERCASE(string1)

입력: string1 = "Web pages"
결과: "WEB PAGES"

예3:

@DTW_mUPPERCASE(string1, string2, string3)

입력: string1 = "This", string2 = "is", string3 = "upper case"
결과: string1 = "THIS", string2 = "IS", string3 = "UPPER CASE"

[ 페이지의 맨 위 | 이전 페이지 | 다음 페이지 | 목차 | 색인 ]