參考手冊

字串函數

下列的函數是由 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 管理及程式設計手冊中的架構變數部分， 與DTW_MBMODE以取得有關詳細資訊。

OS/400 的 MBCS 支援：自動提供 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

目的

將字串中每一個字元轉換成兩個十六進位字元。

格式

@DTW_CHARTOHEX(stringIn, stringOut)

@DTW_rCHARTOHEX(stringIn)

參數

表 75. DTW_CHARTOHEX 參數

回覆碼

表 76. DTW_CHARTOHEX 回覆碼

用法注意事項

每一個十六進位字元代表輸入字元的 4 位元 (一個字元以 8 位元代表)。

範例

範例 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

目的

將字串中每一個十六進位字元轉換成一個字元值。

格式

@DTW_HEXTOCHAR(stringIn, stringOut)

@DTW_rHEXTOCHAR(stringIn)

參數

表 81. DTW_HEXTOCHAR 參數

回覆碼

表 82. DTW_HEXTOCHAR 回覆碼

用法注意事項

輸入字串中每一個十六進位字元代表結果字串中的 4 位元 (一個字元以 8 位元代表)。 輸入字串必須包含偶數個十六進位字元，並可包含下列字元：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"