参考

字符串函数

下列函数是 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

MBCS 支持 OS/390、OS/2、Windows NT 和 UNIX：可以用 DTW_ MBMODE 配置值指定多字节字符集(MBCS)对单词和字符串的支持。在 Net.Data 初始化文件中指定这个 值；缺省是不支持的。可以通过在 Net.Data 宏中设置 DTW_MBMODE 变量来覆盖初始化文件中的值。参阅 Net.Data 管理与程序设计指南中的配置变量章节和 DTW_MBMODE，获取更多的信息。

MBCS 支持 OS/400：自动提供 DBCS 支持，且不要求这个变量。

DTW_ASSIGN

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

目的

为变量指定一个值。

格式

@DTW_ASSIGN(stringOut, stringIn)

参数

表 73. DTW_ASSIGN 参数

数据类型	参数	用法	说明
字符串	stringOut	OUT	包含和 stringIn 完全相同的文字串的变量。
字符串	stringIn	IN	一个变量或文字串。

返回码

表 74. DTW_ASSIGN 返回码

返回码	说明
-1001	服务器不能处理 Net.Data 请求来分配内存。
1003	在函数调用时传递的参数数目或者超过了允许的最大数目，或者小于该函数必需的最小数目。
1005	传递给函数调用的参数应该是一个字符串变量，但实际上是另一个类型的变量。
1006	传递给函数调用的参数必须是一个输出参数，但实际上传递了一个文字串。

例

例 1：

@DTW_ASSIGN(RC, "0")

• 将 RC 设置为 "0"。

例 2：

@DTW_ASSIGN(string1, string2)

• 把 string1 设置成 string2 的值。

DTW_CHARTOHEX

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

目的

将一个字符串中的每个字符转换成两个十六进制的字符。

格式

@DTW_CHARTOHEX(stringIn, stringOut)

@DTW_rCHARTOHEX(stringIn)

参数

表 75. DTW_CHARTOHEX 参数

数据类型	参数	用法	说明
字符串	stringIn	IN	要转换的变量或文字串。
字符串	stringOut	OUT	一个包含 stringIn 的变量，用十六进制格式表示。

返回码

表 76. DTW_CHARTOHEX 返回码

返回码	说明
-1001	服务器不能处理 Net.Data 请求来分配内存。
1003	在函数调用时传递的参数数目或者超过了允许的最大数目，或者小于该函数必需的最小数目。
1005	传递给函数调用的参数应该是一个字符串变量，但实际上是另一个类型的变量。
1006	传递给函数调用的参数必须是一个输出参数，但实际上传递了一个文字串。

用法注意事项

每个十六进制字符代表 4 位输入字符(每个字符用 8 位表示)。

例

例 1：EBCDIC 操作系统

@DTW_rCHARTOHEX("12345")

• 返回："F1F2F3F4F5"

例 2：ASCII 操作系统

@DTW_rCHARTOHEX("12345")

• 返回："C1C2C3C4C5"

DTW_CONCAT

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

目的

连接两个字符串。

格式

@DTW_CONCAT(stringIn1, stringIn2, stringOut)

@DTW_rCONCAT(stringIn1, stringIn2)

参数

表 77. DTW_CONCAT 参数

数据类型	参数	用法	说明
字符串	stringIn1	IN	一个变量或文字串。
字符串	stringIn2	IN	一个变量或文字串。
字符串	stringOut	OUT	包含字符串 'stringIn1stringIn2'的变量，其中 string1 后连接 string2 。

返回码

表 78. DTW_CONCAT 返回码

返回码	说明
-1001	服务器不能处理 Net.Data 请求来分配内存。
1003	在函数调用时传递的参数数目或者超过了允许的最大数目，或者小于该函数必需的最小数目。
1005	传递给函数调用的参数应该是一个字符串变量，但实际上是另一个类型的变量。
1006	传递给函数调用的参数必须是一个输出参数，但实际上传递了一个文字串。

例

例 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

AIX	HP-UX	Linux	OS/2	OS/390	OS/400	SCO	SUN	Win NT
X	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)

参数

表 79. DTW_DELSTR 参数

数据类型	参数	用法	说明
字符串	stringIn	IN	一个变量或文字串。
整数	n	IN	要删除的子串所开始的字符位置。如果 n 的值 大于 stringIn 的长度，则将 stringOut 设置成 stringIn 的值。
整数	length	IN	要删除的子串的长度。缺省是删除到 stringIn 结尾 为止的所有字符。
字符串	stringOut	OUT	包含 stringIn 的修改格式的变量。

返回码

表 80. DTW_DELSTR 返回码

返回码	说明
-1001	服务器不能处理 Net.Data 请求来分配内存。
1001	输入参数中包含一个空值。
1002	输入参数中包含一个由空终结字符组成的字符串值。
1003	在函数调用时传递的参数数目或者超过了允许的最大数目，或者小于该函数必需的最小数目。
1005	传递给函数调用的参数应该是一个字符串变量，但实际上是另一个类型的变量。
1006	传递给函数调用的参数必须是一个输出参数，但实际上传递了一个文字串。
1007	参数中包含了一个无效值。

例

例 1：

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

• 返回：result = "abe"

例 2：

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

• 返回："abce"

DTW_HEXTOCHAR

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

目的

将字符串中的每个十六进制字符转换成字符值。

格式

@DTW_HEXTOCHAR(stringIn, stringOut)

@DTW_rHEXTOCHAR(stringIn)

参数

表 81. DTW_HEXTOCHAR 参数

数据类型	参数	用法	说明
字符串	stringIn	IN	一个要转换的变量或文字串。
字符串	stringOut	OUT	一个包含 stringIn 的变量，用字符格式表示。

返回码

表 82. DTW_HEXTOCHAR 返回码

返回码	说明
-1001	服务器不能处理 Net.Data 请求来分配内存。
1003	在函数调用时传递的参数数目或者超过了允许的最大数目，或者小于该函数必需的最小数目。
1005	传递给函数调用的参数应该是一个字符串变量，但实际上是另一个类型的变量。
1006	传递给函数调用的参数必须是一个输出参数，但实际上传递了一个文字串。
1007	参数中包含了一个无效值。

用法注意事项

输入字符串中的每个十六进制字符代表结果字符串中的 4 位(每个字符由 8 位表示)。输入字符串必须包含 偶数个十六进制字符，并且可以包含以下字符：0-9、A-F 以及 a-f。

例

例 1：EBCDIC 操作系统

@DTW_rHEXTOCHAR("F0F1F2")

• 返回："123"

例 2：ASCII 操作系统

@DTW_rHEXTOCHAR("303132")

• 返回："123"

DTW_INSERT

AIX	HP-UX	Linux	OS/2	OS/390	OS/400	SCO	SUN	Win NT
X	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)

参数

表 83. DTW_INSERT 参数

数据类型	参数	用法	说明
字符串	stringIn1	IN	要出入到 stringIn2 中的变量或者文字串。
字符串	stringIn2	IN	一个变量或文字串。
整数	n	IN	stringIn2 中的字符位置，在其后插入 stringIn1。如果 n 大于 stringIn2 的长度，则在其中填满填充字 符(pad)，直至有足够个数的字符为止。缺省是插入在 stringIn2 的开始位置。
整数	length	IN	要插入的 stringIn1 的字符数。如果此参数 的值大于 stringIn1 的长度，则用填充字符 pad 来填充。缺省是 stringIn1 的长度。
整数	pad	IN	填充字符，如对 n 和 length 的描述。缺省填充字符是一个空格。
字符串	stringOut	OUT	一个包含由于插入部分或全部 stringIn1 而修改过的 stringIn2 的变量。

返回码

表 84. DTW_INSERT 返回码

返回码	说明
-1001	服务器不能处理 Net.Data 请求来分配内存。
1001	输入参数中包含一个空值。
1003	在函数调用时传递的参数数目或者超过了允许的最大数目，或者小于该函数必需的最小数目。
1005	传递给函数调用的参数应该是一个字符串变量，但实际上是另一个类型的变量。
1006	传递给函数调用的参数必须是一个输出参数，但实际上传递了一个文字串。
1007	参数中包含了一个无效值。

例

例 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	Linux	OS/2	OS/390	OS/400	SCO	SUN	Win NT
X	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)

参数

表 85. DTW_LASTPOS 参数

数据类型	参数	用法	说明
字符串	stringIn1	IN	在 stringIn2 中搜索的变量或者文字串。
字符串	stringIn2	IN	一个变量或文字串。
整数	n	IN	在 stringIn2 中搜索 stringIn1 的开始字符 位置。缺省是从最后一个字符开始搜索并向后扫描(从右到左)。
整数	position	OUT	stringIn1 在 stringIn2 中最后一次出现 的位置。如果找不到这种串，就返回 0。

返回码

表 86. DTW_LASTPOS 返回码

返回码	说明
-1001	服务器不能处理 Net.Data 请求来分配内存。
1001	输入参数中包含一个空值。
1003	在函数调用时传递的参数数目或者超过了允许的最大数目，或者小于该函数必需的最小数目。
1005	传递给函数调用的参数应该是一个字符串变量，但实际上是另一个类型的变量。
1006	传递给函数调用的参数必须是一个输出参数，但实际上传递了一个文字串。
1007	参数中包含了一个无效值。

例

例 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	Linux	OS/2	OS/390	OS/400	SCO	SUN	Win NT
X	X	X	X	X	X	X	X	X

目的

返回字符串的长度。

格式

@DTW_LENGTH(stringIn, length)

@DTW_rLENGTH(stringIn)

参数

表 87. DTW_LENGTH 参数

数据类型	参数	用法	说明
字符串	stringIn	IN	一个变量或文字串。
整数	length	OUT	包含 stringIn 中字符个数的符号。

返回码

表 88. DTW_LENGTH 返回码

返回码	说明
-1001	服务器不能处理 Net.Data 请求来分配内存。
1003	在函数调用时传递的参数数目或者超过了允许的最大数目，或者小于该函数必需的最小数目。
1005	传递给函数调用的参数应该是一个字符串变量，但实际上是另一个类型的变量。
1006	传递给函数调用的参数必须是一个输出参数，但实际上传递了一个文字串。

例

例 1：

@DTW_LENGTH("abcdefgh", result)

• 返回：result = "8"

例 2：

@DTW_rLENGTH("")

• 返回："0"

DTW_LOWERCASE

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

目的

返回一个所有字符全为小写的字符串。

格式

@DTW_LOWERCASE(stringIn, stringOut)

@DTW_rLOWERCASE(stringIn)

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

参数

表 89. DTW_LOWERCASE 参数

数据类型	参数	用法	说明
字符串	stringIn	IN	一个变量或文字串，其中的字符可以是大写或小写。
字符串	stringOut	OUT	包含 stringIn (其中所有字符都是小写的)的变量。
字符串	stringMult	INOUT	输入：一个包含字符串的变量。 输出：一个包含输入字符串的变量，其中的所有字符都已转换为小写。

返回码

表 90. DTW_LOWERCASE 返回码

返回码	说明
-1001	服务器不能处理 Net.Data 请求来分配内存。
1003	在函数调用时传递的参数数目或者超过了允许的最大数目，或者小于该函数必需的最小数目。
1005	传递给函数调用的参数应该是一个字符串变量，但实际上是另一个类型的变量。
1006	传递给函数调用的参数必须是一个输出参数，但实际上传递了一个文字串。

例

例 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

AIX	HP-UX	Linux	OS/2	OS/390	OS/400	SCO	SUN	Win NT
X	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)

参数

表 91. DTW_POS 参数

数据类型	参数	用法	说明
字符串	stringIn1	IN	要搜索的变量或文字串。
字符串	stringIn2	IN	一个被搜索(在其中搜索另一个字符串)的变量或文字串。
整数	n	IN	stringIn2 中开始搜索的字符位置。缺省值 是从 stringIn2 的第一个字符开始搜索。
整数	nOut	OUT	包含 stringIn1 在 stringIn2 中第一次出现的位置值的 一个变量。如果找不到这种串，就返回 0。

返回码

表 92. DTW_POS 返回码

返回码	说明
-1001	服务器不能处理 Net.Data 请求来分配内存。
1001	输入参数中包含一个空值。
1002	输入参数中包含一个由空终结字符组成的字符串值。
1003	在函数调用时传递的参数数目或者超过了允许的最大数目，或者小于该函数必需的最小数目。
1005	传递给函数调用的参数应该是一个字符串变量，但实际上是另一个类型的变量。
1006	传递给函数调用的参数必须是一个输出参数，但实际上传递了一个文字串。
1007	参数中包含了一个无效值。

例

例 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

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

目的

替换字符串中的字符。

格式

@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 参数

数据类型	参数	用法	说明
字符串	stringIn	IN	要搜索的变量或文字串。
字符串	stringFrom	IN	要替换的变量或文字串。
字符串	stringTo	IN	一个要替换 stringFrom 的变量或文字串。
整数	n	IN	开始搜索的字符位置。
字符串	option	IN	指定是否替换所有的地方，还是只在第一次出现的地方进行替换，可以是以下值： A 或 a 在所有出现的地方都进行替换。缺省值是 A。 F 或 f 仅在首次出现的地方进行替换。
字符串	stringOut	OUT	包含 stringIn 的变量，其中的 stringFrom 已被 替换为 stringTo。

返回码

表 94. DTW_REPLACE 返回码

返回码	说明
-1001	服务器不能处理 Net.Data 请求来分配内存。
1003	在函数调用时传递的参数数目或者超过了允许的最大数目，或者小于该函数必需的最小数目。
1005	传递给函数调用的参数应该是一个字符串变量，但实际上是另一个类型的变量。
1006	传递给函数调用的参数必须是一个输出参数，但实际上传递了一个文字串。

例

例 1：

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

• 返回："1234C1234C1234C"

DTW_REVERSE

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

目的

反转字符串，这样，最后一个字符成了第一个字符，最后第二个成了第二个，直至整个字符串都被反转。

格式

@DTW_REVERSE(stringIn, stringOut)

@DTW_rREVERSE(stringIn)

参数

表 95. DTW_REVERSE 参数

数据类型	参数	用法	说明
字符串	stringIn	IN	要进行反转的变量或文字串。
字符串	stringOut	OUT	包含 stringIn 的反转格式的变量。

返回码

表 96. DTW_REVERSE 返回码

返回码	说明
-1001	服务器不能处理 Net.Data 请求来分配内存。
1003	在函数调用时传递的参数数目或者超过了允许的最大数目，或者小于该函数必需的最小数目。
1005	传递给函数调用的参数应该是一个字符串变量，但实际上是另一个类型的变量。
1006	传递给函数调用的参数必须是一个输出参数，但实际上传递了一个文字串。

例

例 1：

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

• 返回：result = ".ti si sihT"

例 2：

@DTW_rREVERSE(string1)

• 输入：string1 = "reversed"
• 返回："desrever"

DTW_STRIP

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

目的

从字符串删除前导空格或尾随空格(或同时删除)。

格式

@DTW_STRIP(stringIn, option, stringOut)

@DTW_STRIP(stringIn, stringOut)

@DTW_rSTRIP(stringIn, option)

@DTW_rSTRIP(stringIn)

参数

表 97. DTW_STRIP 参数

数据类型	参数	用法	说明
字符串	stringIn	IN	一个变量或文字串。
字符串	option	IN	指定从 stringIn 删除哪些空格。缺省值是 B。 B 或 b - 同时删除前导和尾随空格 L 或 l - 只删除前导空格 T 或 t - 只删除尾随空格
字符串	stringOut	OUT	一个包含按照选项所指去除了空格的 stringIn 的变 量。

返回码

表 98. DTW_STRIP 返回码

返回码	说明
-1001	服务器不能处理 Net.Data 请求来分配内存。
1001	输入参数中包含一个空值。
1003	在函数调用时传递的参数数目或者超过了允许的最大数目，或者小于该函数必需的最小数目。
1005	传递给函数调用的参数应该是一个字符串变量，但实际上是另一个类型的变量。
1006	传递给函数调用的参数必须是一个输出参数，但实际上传递了一个文字串。
1007	参数中包含了一个无效值。

例

例 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	Linux	OS/2	OS/390	OS/400	SCO	SUN	Win NT
X	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)

参数

表 99. DTW_SUBSTR 参数

数据类型	参数	用法	说明
字符串	stringIn	IN	一个被搜索(在其中搜索另一个字符串)的变量或文字串。
整数	n	IN	子字符串第一个字符的位置。缺省是从 stringIn 的开始位置开始
整数	length	IN	子串的字符个数。缺省值是字符串的剩余部分。
字符串	pad	IN	如果 n 大于 stringIn 的长度或者如果 length比 stringIn 长的时侯所使用的填充字符。缺省值是一个空格。
字符串	stringOut	OUT	包含 stringIn 的子字符串的变量。

返回码

表 100. DTW_SUBSTR 返回码

返回码	说明
-1001	服务器不能处理 Net.Data 请求来分配内存。
1001	输入参数中包含一个空值。
1003	在函数调用时传递的参数数目或者超过了允许的最大数目，或者小于该函数必需的最小数目。
1005	传递给函数调用的参数应该是一个字符串变量，但实际上是另一个类型的变量。
1006	传递给函数调用的参数必须是一个输出参数，但实际上传递了一个文字串。
1007	参数中包含了一个无效值。

例

例 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	Linux	OS/2	OS/390	OS/400	SCO	SUN	Win NT
X	X	X	X	X	X	X	X	X

目的

返回一个字符串，其中每个字符都被翻译为另一个字符，或保持不变。

格式

@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 参数

数据类型	参数	用法	说明
字符串	stringIn	IN	一个变量或文字串。
字符串	tableO	IN	一个作为转换表使用的变量或文字串。使用空("")指定 tableI或 default；否则这个参数是可选的。
字符串	tableI	IN	在 stringIn 中搜索的变量或者文字串。使用空( "")指定 default；否则这个参数是可选的。
字符串	default	IN	要使用的缺省字符。缺省值是一个空格。
字符串	stringOut	OUT	包含 stringIn 的转换结果的变量。

返回码

表 102. DTW_TRANSLATE 返回码

返回码	说明
-1001	服务器不能处理 Net.Data 请求来分配内存。
1001	输入参数中包含一个空值。
1003	在函数调用时传递的参数数目或者超过了允许的最大数目，或者小于该函数必需的最小数目。
1005	传递给函数调用的参数应该是一个字符串变量，但实际上是另一个类型的变量。
1006	传递给函数调用的参数必须是一个输出参数，但实际上传递了一个文字串。
1007	参数中包含了一个无效值。

用法注意事项

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

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

目的

返回一个大写的字符串。

格式

@DTW_UPPERCASE(stringIn, stringOut)

@DTW_rUPPERCASE(stringIn)

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

参数

表 103. DTW_UPPERCASE 参数

数据类型	参数	用法	说明
字符串	stringIn	IN	一个变量或文字串，其中的字符可以是大写或小写。
字符串	stringOut	OUT	包含 stringIn (其中所有字符都是大写的)的变量。
字符串	stringMult	INOUT	输入：一个包含字符串的变量。 输出：一个包含输入字符串的变量，其中的所有字符都已转换为大写。

返回码

表 104. DTW_UPPERCASE 返回码

返回码	说明
-1001	服务器不能处理 Net.Data 请求来分配内存。
1003	在函数调用时传递的参数数目或者超过了允许的最大数目，或者小于该函数必需的最小数目。
1005	传递给函数调用的参数应该是一个字符串变量，但实际上是另一个类型的变量。
1006	传递给函数调用的参数必须是一个输出参数，但实际上传递了一个文字串。

例

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