參考手冊

字組函數

這些函數藉由修改字組或字組集來支援字串函數。Net.Data 將字組解譯為一個以空白做分隔的字串， 或者一個在兩端均具有空白的字串。這裡是幾個範例：

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 支援， 無須這個變數。

下列函數是 Net.Data 支援的字組函數：

• DTW_DELWORD
• DTW_SUBWORD
• DTW_WORD
• DTW_WORDINDEX
• DTW_WORDLENGTH
• DTW_WORDPOS
• DTW_WORDS

DTW_DELWORD

目的

刪除字串中的字組， 從第 n 個字組開始刪除 length 所指定的字組數。

格式

@DTW_DELWORD(stringIn, n, length, stringOut)

@DTW_DELWORD(stringIn, n, stringOut)

@DTW_rDELWORD(stringIn, n, length)

@DTW_rDELWORD(stringIn, n)

參數

表 105. DTW_DELWORD 參數

回覆碼

表 106. DTW_DELWORD 回覆碼

範例

範例 1

@DTW_DELWORD("Now is the time", "5", result)

• 傳回：result = "Now is the time"

範例 2：

@DTW_DELWORD("Now is the time", "2", result)

• 傳回：result = "Now"

範例 3：

@DTW_DELWORD("Now is the time", "2", "2", result)

• 傳回：result = "Now time"

範例 4：

@DTW_rDELWORD("Now is the time.", "3")

• 傳回："Now is"

DTW_SUBWORD

目的

傳回字串的子字串，從第 n 個字組開始傳回 length 所指定的字組數。

格式

@DTW_SUBWORD(stringIn, n, length, stringOut)

@DTW_SUBWORD(stringIn, n, stringOut)

@DTW_rSUBWORD(stringIn, n, length)

@DTW_rSUBWORD(stringIn, n)

參數

表 107. DTW_SUBWORD 參數

回覆碼

表 108. DTW_SUBWORD 回覆碼

範例

範例 1：

@DTW_SUBWORD("Now is the   time", "5", result)

• 傳回：result = ""

範例 2：

@DTW_SUBWORD("Now is the   time", "2", result)

• 傳回：result = "is the time"

範例 3：

@DTW_SUBWORD(Now is the   time", "2", "2", result)

• 傳回：result = "is the"

範例 4：

@DTW_rSUBWORD("Now is the   time", "3")

• 傳回："the time"

DTW_WORD

目的

傳回字串中的第 n 個字組。

格式

@DTW_WORD(stringIn, n, stringOut)

@DTW_rWORD(stringIn, n)

參數

表 109. DTW_WORD 參數

回覆碼

表 110. DTW_WORD 回覆碼

範例

範例 1：

@DTW_WORD("Now is the time", "3", result)

• 傳回：result = "the"

範例 2：

@DTW_WORD("Now is the time", "5", result)

• 傳回：result = ""

範例 3：

@DTW_rWORD("Now is the time", "4")

• 傳回："time"

DTW_WORDINDEX

目的

傳回字串第 n 個字組中第一個字元的字元位置。

格式

@DTW_WORDINDEX(stringIn, n, stringOut)

@DTW_rWORDINDEX(stringIn, n)

參數

表 111. DTW_WORDINDEX 參數

回覆碼

表 112. DTW_WORDINDEX 回覆碼

範例

範例 1：

@DTW_WORDINDEX("Now is the time", "3", result)

• 傳回：result = "8"

範例 2：

@DTW_WORDINDEX("Now is the time", "6", result)

• 傳回：result = "0"

範例 3：

@DTW_rWORDINDEX("Now is the time", "2")

• 傳回："5"

DTW_WORDLENGTH

目的

傳回字串第 n 個字組的長度。

格式

@DTW_WORDLENGTH(stringIn, n, stringOut)

@DTW_rWORDLENGTH(stringIn, n)

參數

表 113. DTW_WORDLENGTH 參數

回覆碼

表 114. DTW_WORDLENGTH 回覆碼

範例

範例 1：

@DTW_WORDLENGTH("Now is the time", "1", result)

• 傳回：result = "3"

範例 2：

@DTW_rWORDLENGTH("Now is the time", "6")

• 傳回："0"

DTW_WORDPOS

目的

傳回在另一個字串中，某一個字串第一次出現的字組號碼。

格式

@DTW_WORDPOS(stringIn1, stringIn2, n, stringOut)

@DTW_WORDPOS(stringIn1, stringIn2, stringOut)

@DTW_rWORDPOS(stringIn1, stringIn2, n)

@DTW_rWORDPOS(stringIn1, stringIn2)

參數

表 115. DTW_WORDPOS 參數

回覆碼

表 116. DTW_WORDPOS 回覆碼

用法注意事項

多重空白將以一個單一空白來看待，以供比較。

範例

範例 1：

@DTW_WORDPOS("the", "Now is the time", result)

• 傳回：result = "3"

範例 2：

@DTW_WORDPOS("The", "Now is the time", result)

• 傳回：result = "0"

範例 3：

@DTW_WORDPOS("The", "Now is the time", "5", result)

• 傳回：result = "0"

範例 4：

@DTW_WORDPOS("is  the", "Now is     the time", result)

• 傳回：result = " 2"

範例 5：

@DTW_rWORDPOS("be", "To be or not to be", "3")

• 傳回："6"

DTW_WORDS

目的

傳回在字串中的字組數目。

格式

@DTW_WORDS(stringIn, stringOut)

@DTW_rWORDS(stringIn)

參數

表 117. DTW_WORDS 參數

回覆碼

表 118. DTW_WORDS 回覆碼

範例

範例 1：

@DTW_WORDS("Now is the time", result)

• 傳回：

  result = "4"

範例 2：

@DTW_rWORDS(" ")

• 傳回："0"