참조서

문자열 함수

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

• DTW_ASSIGN

• DTW_CHARTOHEX

• DTW_CONCAT

• DTW_DELSTR

• DTW_HEXTOCHAR

• DTW_INSERT

• DTW_LASTPOS

• DTW_LENGTH

• DTW_LOWERCASE

• DTW_POS

• DTW_REPLACE

• DTW_REVERSE

• DTW_STRIP

• DTW_SUBSTR

• DTW_TRANSLATE

• DTW_UPPERCASE

OS/390, OS/2, Windows NT 및 UNIX에 대한 MBCS 지원: DTW_MBMODE 구성 값을 갖는 단어 및 문자열 함수에 대해 다중 바이트 문자 세트(MBCS) 지원을 지정할 수 있습니다. Net.Data 초기화 파일에 이 값을 지정하십시오. 생략시 값은 지원되지 않습니다. Net.Data 매크로에서 DTW_MBMODE 변수를 설정하여 초기화 파일의 값을 겹쳐쓸 수 있습니다. 자세한 내용은 Net.Data Administration and Programming Guide와 DTW_MBMODE의 구성 변수 절을 참조하십시오.

OS/400에 대한 MBCS 지원: DBCS 지원이 자동으로 제공되지 않으며 DBCS 지원에 이 변수가 필요하지 않습니다.

DTW_ASSIGN

목적

값을 변수에 할당합니다.

형식

@DTW_ASSIGN(stringOut, stringIn)

매개변수

표 73. DTW_ASSIGN 매개변수

리턴 코드

표 74. DTW_ASSIGN 리턴 코드

예

예 1:

@DTW_ASSIGN(RC, "0")

• RC를 "0"으로 설정합니다.

예 2:

@DTW_ASSIGN(string1, string2)

• string1을 string2의 값으로 설정합니다.

DTW_CHARTOHEX

목적

문자열에 있는 각각의 문자를 두 개의 16진수 문자로 변환합니다.

형식

@DTW_CHARTOHEX(stringIn, stringOut)

@DTW_rCHARTOHEX(stringIn)

매개변수

표 75. DTW_CHARTOHEX 매개변수

리턴 코드

표 76. DTW_CHARTOHEX 리턴 코드

사용법 메모

각각의 16진수 문자는 입력 문자 중 4비트를 나타냅니다(하나의 문자는 16비트로 표시됩니다).

예

예 1: EBCDIC 운영 체제

@DTW_rCHARTOHEX("12345")

• 결과: "F1F2F3F4F5"

예 2: ASCII 운영 체제

@DTW_rCHARTOHEX("12345")

• 결과: "C1C2C3C4C5"

DTW_CONCAT

목적

두 문자열을 연결합니다.

형식

@DTW_CONCAT(stringIn1, stringIn2, stringOut)

@DTW_rCONCAT(stringIn1, stringIn2)

매개변수

표 77. DTW_CONCAT 매개변수

리턴 코드

표 78. DTW_CONCAT 리턴 코드

예

예 1:

@DTW_CONCAT("This", " is a test.", result)

• 결과: result = "This is a test."

예 2:

@DTW_CONCAT(string1, "1-2-3", result)

• 입력: string1 = "Testing "
• 결과: result = "Testing 1-2-3"

예 3:

@DTW_rCONCAT("This", " is a test.")

• 결과: "This is a test."

DTW_DELSTR

목적

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

형식

@DTW_DELSTR(stringIn, n, length, stringOut)

@DTW_DELSTR(stringIn, n, stringOut)

@DTW_rDELSTR(stringIn, n, length)

@DTW_rDELSTR(stringIn, n)

매개변수

표 79. DTW_DELSTR 매개변수

리턴 코드

표 80. DTW_DELSTR 리턴 코드

예

예 1:

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

• 결과: result = "abe"

예 2:

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

• 결과: "abce"

DTW_HEXTOCHAR

목적

문자열에 있는 각각의 16진수 문자를 문자 값으로 변환합니다.

형식

@DTW_HEXTOCHAR(stringIn, stringOut)

@DTW_rHEXTOCHAR(stringIn)

매개변수

표 81. DTW_HEXTOCHAR 매개변수

리턴 코드

표 82. DTW_HEXTOCHAR 리턴 코드

사용법 메모

입력 문자열의 각각의 16진수 문자는 결과 문자열의 4비트를 나타냅니다(하나의 문자를 8비트로 표시됩니다). 입력 문자열은 짝수의 16진수 문자를 포함해야 하며 0-9, A-F 및 a-f와 같은 문자를 포함할 수 있습니다.

예

예 1: EBCDIC 운영 체제

@DTW_rHEXTOCHAR("F0F1F2")

• 결과: "123"

예 2: ASCII 운영 체제

@DTW_rHEXTOCHAR("303132")

• 결과: "123"

DTW_INSERT

목적

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)

매개변수

표 83. DTW_INSERT 매개변수

리턴 코드

표 84. DTW_INSERT 리턴 코드

예

예 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

목적

n번째 문자에서 시작하여 역방향으로(오른쪽에서 왼쪽으로) 가면서, 또다른 문자열에 있는 마지막 문자열의 위치를 리턴합니다.

형식

@DTW_LASTPOS(stringIn1, stringIn2, n, position)

@DTW_LASTPOS(stringIn1, stringIn2, position)

@DTW_rLASTPOS(stringIn1, stringIn2, n)

@DTW_rLASTPOS(stringIn1, stringIn2)

매개변수

표 85. DTW_LASTPOS 매개변수

리턴 코드

표 86. DTW_LASTPOS 리턴 코드

예

예 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

목적

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

형식

@DTW_LENGTH(stringIn, length)

@DTW_rLENGTH(stringIn)

매개변수

표 87. DTW_LENGTH 매개변수

리턴 코드

표 88. DTW_LENGTH 리턴 코드

예

예 1:

@DTW_LENGTH("abcdefgh",
result)

• 결과: result = "8"

예 2:

@DTW_rLENGTH("")

• 결과: "0"

DTW_LOWERCASE

목적

모두 소문자로 된 문자열을 리턴합니다.

형식

@DTW_LOWERCASE(stringIn, stringOut)

@DTW_rLOWERCASE(stringIn)

@DTW_mLOWERCASE(stringMult1, stringMult2, ..., stringMultn)

매개변수

표 89. DTW_LOWERCASE 매개변수

리턴 코드

표 90. DTW_LOWERCASE 리턴 코드

예

예 1:

@DTW_LOWERCASE("This", stringOut)

• 결과: stringOut = "this"

예 2:

@DTW_rLOWERCASE(string1)

• 입력: string1 = "Hello"
• 결과: "hello"

예 3:

@DTW_mLOWERCASE(string1, string2, string3)

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

DTW_POS

목적

정방향 검색 패턴을 사용하여 또다른 문자열에 있는 첫번째 문자열의 위치를 리턴합니다.

형식

@DTW_POS(stringIn1, stringIn2, n, nOut)

@DTW_POS(stringIn1, stringIn2, nOut)

@DTW_rPOS(stringIn1, stringIn2, n)

@DTW_rPOS(stringIn1, stringIn2)

매개변수

표 91. DTW_POS 매개변수

리턴 코드

표 92. DTW_POS 리턴 코드

예

예 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_REPLACE

목적

문자열의 문자를 대체합니다.

형식

@DTW_REPLACE(stringIn, stringFrom, stringTo, n, option, stringOut)

@DTW_REPLACE(stringIn, stringFrom, stringTo, n, stringOut)

@DTW_REPLACE(stringIn, stringFrom, stringTo, stringOut)

@DTW_rREPLACE(stringIn, stringFrom, stringTo, n, option)

@DTW_rREPLACE(stringIn, stringFrom, stringTo, n)

@DTW_rREPLACE(stringIn, stringFrom, stringTo)

매개변수

표 93. DTW_REPLACE 매개변수

리턴 코드

표 94. DTW_REPLACE 리턴 코드

예

예 1:

@DTW_rREPLACE("ABCABCABC", "AB", "1234")

• 리턴: "1234C1234C1234C"

DTW_REVERSE

목적

마지막 문자가 첫번째 문자가 되고, 마지막에서 두 번째 문자가 두 번째 문자가 되도록 전체 문자열이 뒤바뀔 때까지 문자열을 역전합니다.

형식

@DTW_REVERSE(stringIn, stringOut)

@DTW_rREVERSE(stringIn)

매개변수

표 95. DTW_REVERSE 매개변수

리턴 코드

표 96. DTW_REVERSE 리턴 코드

예

예 1:

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

• 결과: result = ".ti si sihT"

예 2:

@DTW_rREVERSE(string1)

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

DTW_STRIP

목적

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

형식

@DTW_STRIP(stringIn, option, stringOut)

@DTW_STRIP(stringIn, stringOut)

@DTW_rSTRIP(stringIn, option)

@DTW_rSTRIP(stringIn)

매개변수

표 97. DTW_STRIP 매개변수

리턴 코드

표 98. DTW_STRIP 리턴 코드

예

예 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

목적

선택적 채움 문자를 사용하여, 문자열의 부속 문자열을 리턴합니다.

형식

@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)

매개변수

표 99. DTW_SUBSTR 매개변수

리턴 코드

표 100. DTW_SUBSTR 리턴 코드

예

예 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

목적

각각의 문자가 다른 문자로 변환되거나 변환되지 않은 문자열을 리턴합니다.

형식

@DTW_TRANSLATE(stringIn, tableO, tableI, default, stringOut)

@DTW_TRANSLATE(stringIn, tableO, tableI, stringOut)

@DTW_TRANSLATE(stringIn, tableO, stringOut)

@DTW_TRANSLATE(stringIn, stringOut)

@DTW_rTRANSLATE(stringIn, tableO, tableI, default)

@DTW_rTRANSLATE(stringIn, tableO, tableI)

@DTW_rTRANSLATE(stringIn, tableO)

@DTW_rTRANSLATE(stringIn)

매개변수

표 101. DTW_TRANSLATE 매개변수

리턴 코드

표 102. DTW_TRANSLATE 리턴 코드

사용법 메모

1. tableI, tableO 및 default 문자가 매개변수 목록에 없는 경우, stringIn 매개변수가 대문자로 변환됩니다.

2. tableI 및 tableO이 목록에 있는 경우, tableI에서 입력 문자열의 각 문자가 탐색되고 tableO의 해당 문자로 변환됩니다. tableI의 문자에 대해 tableO에 해당 문자가 없는 경우, default 문자가 대신 사용됩니다.

예

예 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

목적

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

형식

@DTW_UPPERCASE(stringIn, stringOut)

@DTW_rUPPERCASE(stringIn)

@DTW_mUPPERCASE(stringMult1, stringMult2, ..., stringMultn)

매개변수

표 103. DTW_UPPERCASE 매개변수

리턴 코드

표 104. DTW_UPPERCASE 리턴 코드

예

예 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 = "uppercase"
• 결과: string1 = "THIS", string2 = "IS", string3 = "UPPERCASE"