字符函数

字符函数处理数据的内部数据类型都是字符型。
在字符类型进行数据处理中有时会转换文字码。详情请参照混合文字码。

字符串连接函数(Concat)

数据类型	注释
字符型	连接后的字符串。

详细参数

可以使用参数追加来追加参数。
使用参数追加按钮，一次能够追加一个"连接对象字符串&参数。

参数名	数据类型	注释
连接对象字符串	字符型	指定连接的字符串对象。
连接对象字符串	字符型	指定连接的字符串对象。

补充说明

当连接结果字符串超过4096字节，函数将异常结束。 (当函数异常结束时，视表过滤器执行状态表示为"异常结束"并结束处理。但可以使用函数异常结束捕捉函数继续此处理)
当"连接对象字符串"参数为NULL，相当于指定了一个零长度字符串参数。

字符串重复函数(Repeat)

涵义

对于给定的字符串，按指定的重复次数，重新连接成新的字符串。

返回值

数据类型	注释
字符型	重复连接的字符串。

详细参数

参数名	数据类型	注释
重复对象字符串	字符型	指定重复的字符串对象。
重复次数	数值型	指定重复次数(1～4096)

补充说明

当结果字符串超过4096字节，函数将异常结束。
当"重复次数"参数为0或更小，4097或更大，函数将异常结束。
当被输入的"重复次数"参数不是整数(小数部分不为零)，函数将异常结束。
当"重复次数"参数为NULL，函数将异常结束。
当"重复对象字符串"参数为NULL，将返回NULL。

字符串长度函数(字符单位)(Len)

涵义

返回字符串的字符数。无论半角或全角，1个字符的长度按1计数。

返回值

数据类型	注释
数值型	字符数。

详细参数

参数名	数据类型	注释
计数对象字符串	字符型	指定计数的字符串对象。

补充说明 1

此产品支持Unicode的相关文字码UCS-2。不支持4字节的Unicode字符。
若包括4字节的字符，在输入字符串中的每2字节字符算作1个字符。

补充说明 2

当"计数对象字符串"参数为NULL时，返回值也为NULL。

字符串检索函数(字符单位)(Search)

涵义

以检索模式检索指定的字符串。
检索以字符单位进行。不区分大小写，每个多字节文字以1计数。

返回值

数据类型	注释
数值型	返回检索模式在字符串中的开始位置(以字符计算)。数值从1开始，若未检索到则返回0值。

详细参数

参数名	数据类型	注释
检索对象字符串	字符型	指定检索的字符串对象。
检索模式	字符型	指定检索的模式。

补充说明

当"检索对象字符串"参数为NULL，相当于指定一个零长度字符串参数。
当"检索模式"参数长度为0，返回值也为0。这意味着要检索的模式在给定的字符串中找不到。

字符子串抽取函数(字符单位)(Substr)

涵义

从字符串中抽取一部分作为子串。位置及长度以字符为单位，位置从1开始计数。

返回值

数据类型	注释
字符型	抽取的字符子串。

详细参数

参数名	数据类型	注释
抽取对象字符串	字符型	指定抽取的字符串对象。
抽取开始位置	数值型	指定抽取的开始位置(字符单位)。
抽取字符数	数值型	指定抽取的字符数。此项未指定，将抽取抽取开始位置后的所有字符串。

补充说明

当"抽取开始位置"参数小于0，函数将异常结束。
若指定的起始位置超过了"抽取对象字符串"参数的长度，抽取的字符串将为零长度。
当"抽取字符数"参数为-1或更小，函数将异常结束。
若"抽取字符数"参数为0，返回值也将为零长度字符串。
即使"抽取字符数"超出了"抽取对象字符串"参数的长度，仍然抽取到字符串结束位置。
当"抽取开始位置"参数不是整数值(小数部分不为零)，函数将异常结束。
当"抽取字符数"参数不是整数值，函数将异常结束。
当"抽取对象字符串"参数为NULL，返回值也为NULL。
当"抽取开始位置"参数为NULL，函数将异常结束。
当"抽取字符数"参数为NULL，将被视为未指定。

字符子串抽取：分割符分割函数(Element)

涵义

按指定的分割符，将字符串分割，并从中抽取一字符子串。

返回值

数据类型	注释
字符型	抽取的字符子串。

详细参数

参数名	数据类型	注释
分割对象字符串	字符型	指定分割的字符串对象
分割符	字符型	指定使用的分割符。
抽取位置	数值型	指定抽取位置(被分割的字符串左侧算起第几位)。

补充说明

当"抽取位置"参数为0或更小，函数将异常结束。
若在"分割对象字符串"参数中的"分割符"个数大于+1，返回值将为NULL。
当"抽取位置"参数不是整数的值(小数部分不为零)，函数将异常结束。
当"分割对象字符串"参数为NULL，返回值也为NULL。
当"分割符"参数的值不包含于"分割对象字符串"参数，或是"抽取位置"参数为1，该返回值将于"分割对象字符串"参数的值相同。 If the "抽取位置"参数为2或更大，返回值将为NULL。
当"分割符"参数为零长度字符串，相当于指定了一个不包含"分割符"参数的"分割对象字符串"参数。
当"分割符"参数为NULL时，函数将异常结束。
当"抽取位置"参数为NULL时，函数将异常结束。

举例:

分割对象字符串	分割符	抽取位置	返回值
a/b/c/d/e	/	2	b
a/b/c/d/e	/	6	NULL

字符子串抽取：字符数分割函数(Separate)

涵义

将字符串按指定的字符数分割，并从中抽取1字符子串。

返回值

数据类型	注释
字符型	抽取的字符子串。

详细参数

可以使用参数追加来追加参数。
使用参数追加按钮，一次能够追加一个"抽取字符数&参数。

参数名	数据类型	注释
分割对象字符串	字符型	指定分割的字符串对象。
抽取位置	数值型	指定抽取位置(前头算起第几位)。
分割字符数	数值型	指定分割字符数(可指定多个值)。

补充说明 1

本函数同 Substr函数类似，只是指定参数的方法不同。

补充说明 2

当"抽取位置"参数为0或更小，函数将异常结束。
当"分割字符数"参数为0或更小，函数将异常结束。
当"抽取位置"参数大于"分割字符数"参数+1，函数将异常结束。
当"抽取位置"参数不是整数值(小数部分不为零)，函数将异常结束。
当"分割字符数"参数不是整数值，函数将异常结束。
当"分割对象字符串"参数为NULL，返回值也将为NULL。
当"抽取位置"参数为NULL，函数将异常结束。
当"分割字符数"参数为NULL，函数将异常结束。

举例 1 ：当"抽取字符数"参数不被追加时

分割对象字符串	抽取位置	分割字符数	返回值
abcdef	1	2	ab
abcdef	2	2	cdef

若给定的字符串为"abcdef"并以"分割字符数" = "2"来分割，那么字符串将被分割为两部分。第一部分为"ab"(从头部开始的前2个字符)，第二部分为"cdef"(给定字符串的剩余字符)。 "抽取位置" = "1"抽出的第一部分为("ab")，"抽取位置" = "2"抽出的第二部分为("cdef")。

分割前 abcdef

分割后 ab cdef

从头部开始的前2个字符剩余字符

"抽取位置" = "1" "抽取位置" = "2"
若"抽取位置"指定为"1"，则获取"ab"。
若"抽取位置"指定为"2"，则获取"cdef"。

举例 2 ：当使用参数追加按钮追加"抽取字符数"参数时

分割对象字符串	抽取位置	分割字符数 - 1	分割字符数 - 2	返回值
abcdef	1	2	3	ab
abcdef	2	2	3	cde
abcdef	3	2	3	f

若在给定字符串"abcdef"中以"分割字符数"2和3进行抽取，那么字符串将被分割为三部分。第一部分为"ab"(从头部开始的前2个字符)，第二部分为"cde"(剩余字符开始的前3个字符)，第三部分为"f"(剩余字符)。 "抽取位置" = "1"抽出的第一部分为("ab")，"抽取位置" = "2"抽出的第二部分为("cde")，"抽取位置" = "3"抽出的第三部分为("f")。

分割前 abcdef

分割后 ab cde f

从头部开始的前2个字符剩余字符开始的前3个字符剩余字符

"抽取位置" = "1" "抽取位置" = "2" "抽取位置" = "3"
若"抽取位置"指定为"1"，则获得"ab"。
若"抽取位置"指定为"2"，则获得"cde"。
若"抽取位置"指定为"3"，则获得"f"。

字符子串抽取：左抽取字符子串函数(字符单位)(Left)

涵义

从字符串左侧，按指定的字符数抽取字符子串。

返回值

数据类型	注释
字符型	抽取的字符子串。

详细参数

参数名	数据类型	注释
抽取对象字符串	字符型	指定抽取的字符串对象。
抽取字符数	数值型	指定抽取的字符数。

补充说明

当"抽取字符数"参数为-1或更小，函数将异常结束。
若"抽取字符数"参数为0，那返回值将是一个零长度字符串。
若"抽取字符数"参数值大于"抽取对象字符串"参数的长度，将抽取到字符串结束位置。
当"抽取字符数"参数不是整数值(小数部分不为零)，函数将异常结束。
当"抽取对象字符串"参数为NULL，返回值也将为NULL。
当"抽取字符数"参数为NULL，函数将异常结束。

字符子串抽取：右抽取字符子串函数(字符单位)(Right)

涵义

从字符串右侧，按指定的字符数抽取字符子串。

返回值

数据类型	注释
字符型	抽取的字符子串。

详细参数

参数名	数据类型	注释
抽取对象字符串	字符型	指定抽取的字符串对象。
抽取字符数	数值型	指定抽取的字符数。

补充说明

当"抽取字符数"参数为-1或更小，函数将异常结束。
若"抽取字符数"参数为0，那返回值将是一个零长度字符串。
若"抽取字符数"参数值大于"抽取对象字符串"参数的长度，将抽取到字符串结束位置。
当"抽取字符数"参数不是整数值(小数部分不为零)，函数将异常结束。
当"抽取对象字符串"参数为NULL，返回值也将为NULL。
当"抽取字符数"参数为NULL，函数将异常结束。

字符子串抽取：正规表示字符子串抽取函数(MatchRE)

涵义

抽取与抽取模式(正规表示)相匹配的字符子串。

返回值

数据类型	注释
字符型	匹配的字符子串。

详细参数

参数名	数据类型	注释
抽取对象字符串	字符型	指定抽取的字符串对象。
抽取模式	字符型	通过正规表示指定必须被抽取的字符串。正规表示的详情请参照正规表示。字符常量的最大长度为250，250个字节以上的正规表示用字符串连接函数连接。
匹配顺序	数值型	指定匹配字符子串的顺序位置。若"匹配顺序"没有被指定，则视其值为1。

补充说明 1

正规表示以Unicode进行处理。
抽取字符串/参数并以Unicode进行处理(Little endian)。此进程完成后正规表示将被处理，Unicode(Little endian)也将被保存并返回Unicode值。
有关Unicode文字码的连接的注意事项，详情请参照正规表示的文字码。

补充说明 2

当"抽取模式"参数设置错误时，函数将异常结束。
详情请参照正规表示。
当"匹配顺序"参数为0或更小，4097或更大，函数将异常结束。
当"匹配顺序"参数不是整数值(小数部分不为零)，函数将异常结束。
当函数是无法提取的字符串(若在字符串中没有相匹配的)时，返回值为NULL。
当"抽取对象字符串"参数或"抽取模式"参数为零长度字符串，详情请参照正规表示。
当"抽取对象字符串"参数为NULL，返回值也为NULL。
当"抽取模式"参数为NULL，返回值也为NULL。
当"匹配顺序"参数为NULL，"匹配顺序"参数将视为未指定。

字符串置换函数(Replace)

涵义

对于指定的字符串，以特定的检索模式检索，若存在相应的检索模式，则用指定的置换模式将其置换。
当存在多个相应的检索模式时，则全部置换。

返回值

数据类型	注释
字符型	置换后的字符串

详细参数

参数名	数据类型	注释
置换对象字符串	字符型	指定置换的字符串对象，必须指定。
检索模式	字符型	指定检索的模式。通常可以指定十六进制值，而不是指定普通字符串。十六进制规格的详情，请参照补充说明 2。
置换模式	字符型	指定置换的模式。若"置换模式"参数没有被指定，那将删除与"检索模式"参数相匹配的字符串。通常可以指定十六进制值，而不是指定普通字符串。十六进制规格的详情，请参照补充说明 2。

补充说明 1

当置换结果字符串超过4096字节，函数将异常结束。

当不正确的十六进制值用于"检索模式"参数或"置换对象字符串"参数(若该值以"&H"开头并不包含十六进制值)时，函数将异常结束。

在"检索模式"参数或"置换对象字符串"参数中使用十六进制值或是将外部码转换为内部码时，一旦发生相应的读错误，函数将异常结束。
有关将外部码转换为内部码的详情，请参照文字码关系的补充说明 2。
有关读错误的详情，请参照文字码校验。
当"置换对象字符串"参数为NULL，函数将异常结束。
当"检索模式"参数为零长度字符串或NULL值，函数将返回没有任何变更过程的"置换对象字符串"。
当"检索模式"参数为零长度字符串或NULL值，"检索模式"参数将视为未指定。

补充说明 2

"检索模式"参数或"置换对象字符串"参数可以指定十六进制值。作为十六进制规格，要在字符串头部追加"&H"，其值表示为"&H09"。在使用十六进制值时，确保一下几点。

文字码关系
十六进制字节数据的规格是由文字码(外部码)表示的"置换对象字符串"参数。十六进制规格必须做以下具体处理。

当在"检索模式"参数和"置换模式"参数中均指定了十六进制值，那在"检索模式"参数或"置换模式"参数中不能包含文字码属性，而只有在"置换对象字符串"参数中可以包含文字码属性。基于该原因，每个参数文字码没有太大差异。因此，在这里不会发生文字码转换。
在这种情况下，在转换过程中外部码字节数据将转换为内部码字节数据。其间可能发生读错误。
当在"检索模式"参数中指定十六进制值或是在"置换模式"参数中指定一个字符串(非十六进制值)，"置换模式"参数将先背转换为"外部码(类似置换对象字符串参数中的文字码)"，然后进行转换。
即使在这种情况下，在转换过程中外部码字节数据将转换为内部码字节数据。其间可能发生读错误。
当在"检索模式"参数中指定一个字符串(非十六进制值)或是在"置换模式"参数中指定十六进制值， "置换模式"参数的十六进制值先将转换为"外部码(类似置换对象字符串参数中的文字码)"，然后文字码将在下一个项目(当在"检索模式"参数和"置换模式"参数中均指定了一个字符串(非十六进制值))以同一规律进行匹配，然后被才被处理。
即使在这种情况下，在转换过程中"置换模式"参数中指定的十六进制值将从外部码字节数据将转换为内部码字节数据。其间可能发生读错误。
当在"检索模式"参数和"置换模式"参数中均指定了一个字符串(非十六进制值)，每个参数都可以包含各自的文字码属性。上述为混合文字码，当所有文字码相同时它以相同文字码进行处理，但当文字码相异时，所有参数都转换为文字码的第一输出视表，然后进行处理。

正规表示字符串置换函数(ReplaceRE)

涵义

置换与检索模式(正规表示)相匹配的字符串。

返回值

数据类型	注释
字符型	置换后的字符串。

详细参数

参数名	数据类型	注释
置换对象字符串	字符型	指定置换的字符串对象。
置换前字符串	字符型	指定置换前的字符串(检索模式)。详情请参照正规表示。
置换后字符串	字符型	指定置换后的字符串(置换模式)。以下的Meta字符可以使用于"置换模式"参数。 $num 参照保存在正规表示"(...)" 中的num-th字符串，即在"抽取模式"参数中被指定的格式为$1、$2、...的字符串。它相当于正规表示中的"\num"。 (在使用"$"和"\"时注意区分) 相关详情请参照反向引用。若被指定为$0，所有与该匹配的字符将被置换。在本产品中也可以把"$"用于变量。在这种情况下，当"置换模式"参数被指定为字符常量，"$1"必须被记作"$$1"。 \ 若"$"被用作字面 (不是用作Meta字符好比"$num")，那么记作"\$"。同样，若"\"被用作字面，那么将记作"\\"。这相当于正规表示的\。 \uhhhh 显示指定在hhhh部分中的4位十六进制文字码。用Unicode(UCS-2)指定，相当于正规表示中的\uhhhh。若该未指定，于"抽取模式"参数匹配的字符串将在"置换对象字符串"中被删除。
匹配顺序	数值型	指定匹配字符串中置换字符串的匹配顺序。若指定为0所有匹配的字符将被置换。若不指定该值，则其值为0。

补充说明 1

以Unicode来处理正规表示。
"置换对象字符串"参数、"抽取模式"参数、"置换模式"参数中的数据在处理过程中被转换为Unicode(Little endian)。转换后将以Unicode(Little endian)返回一个用正规表示置换了的字符串数据。
有关Unicode使用的注意事项和有关详细信息，请参照正规表示的文字码。
由于有一些规范的字符之间的十六进制值的差异，比如在正规表示字符串置换函数中被执行的\uhhhh又如在字符串重复函数中的十六进制规格，因此请注意以下几点。
- 正规表示字符串置换函数是在UCS-2的内部码中指定的，字符串重复函数是在外部码中指定的。
  有关内部码的详细资料/外部码，请参照外部码和内部码中的文字码校验。
- 在正规表示字符串置换函数中，十六进制值指定单位为1个字符。而在字符串重复函数中使用的十六进制值可以是倍数。
  也就是说，它可以打破字符的一对一并在正规表示字符串置换函数中指定(举个例子，字符"ab"可以细分为"\u0061\u0062")。而在字符串重复函数中，字符不能被打破，但它可以不断的被指定(举个例子，字符"ab"可以细分为"&H00610062")。

补充说明 2

当结果字符串超过4096字节，函数将异常结束。
当"置换前字符串"参数不正确时，函数将异常结束。
详情请参照正规表示。
当"置换后字符串"参数不正确时，函数将异常结束。
相应的案件如下。
- 当在"置换后字符串"参数中指定的"$num"的num值大于在"抽取模式"参数中所指定的"(...)"的数值。
- 当在"置换后字符串"参数中的meta字符不正确。
当"匹配顺序"参数为-1或更小，4097或更大，函数将异常结束。
当"匹配顺序"参数不是整数值(小数部分不为零)，函数将异常结束。
当字符串不能被置换(当匹配的字符串不存在)，返回值将与"置换对象字符串"参数相同。
当"置换对象字符串"参数为NULL值，返回值也将为NULL。
当"置换对象字符串"参数和"置换前字符串"参数为零长度字符串，请参照正规表示。
当"置换前字符串"参数为NULL，返回值将与"置换对象字符串"参数相同。
当"置换后字符串"参数为零长度字符串或者NULL值，则视"置换后字符串"参数为未指定。
当"置换后字符串"参数为NULL，返回值也将为NULL。
当"匹配顺序"参数为NULL值，将视其参数为未指定。

前后空格删除函数(Trim)

涵义

删除字符串前后的空格。全角空格，半角空格均为删除对象。

返回值

数据类型	注释
字符型	前后空格被删除后的字符串。

详细参数

参数名	数据类型	注释
空格删除对象字符串	字符型	指定空格删除的字符串对象。

补充说明 1

当Unicode文字码被指定，按以下参数删除空格。
U+0020 (SPACE)
U+00A0 (NO-BREAK SPACE)
U+1680 (OGHAM SPACE MARK)
U+180E (MONGOLIAN VOWEL SEPARATOR)
U+2000 to U+200A (EN QUAD to HAIR SPACE)
U+2028 (LINE SEPARATOR)
U+2029 (PARAGRAPH SEPARATOR)
U+202F (NARROW NO-BREAK SPACE)
U+205F (MEDIUM MATHEMATICAL SPACE)
U+3000 (IDEOGRAPHIC SPACE)

补充说明 2

当"空格删除对象字符串参数"为NULL值，返回值也将为NULL。

右侧空格删除函数(RTrim)

涵义

删除字符串右侧(尾部)的空格。全角空格、半角空格均为删除对象。

返回值

数据类型	注释
字符型	尾部空格被删除后的字符串。

详细参数

参数名	数据类型	注释
空格删除对象字符串	字符型	指定空格删除的字符串对象。

补充说明

当"空格删除对象字符串参数"为NULL值，返回值也将为NULL。

左侧空格删除函数(LTrim)

涵义

删除字符串左侧(首部)的空格。全角空格、半角空格均为删除对象。

返回值

数据类型	注释
字符型	首部空格被删除后的字符串。

详细参数

参数名	数据类型	注释
空格删除对象字符串	字符型	指定空格删除的字符串对象。

补充说明

当"空格删除对象字符串参数"为NULL值，返回值也将为NULL。

大写英文字母转换函数(ToUpper)

涵义

将字符串中半角英文小写字母转换为半角英文大写字母。

返回值

数据类型	注释
字符型	转换后的字符串。

详细参数

参数名	数据类型	注释
转换对象字符串	字符型	指定转换的字符串对象。

补充说明 1

当Unicode文字码被指定，字符的转换与其它文字码相同。举个例子，Unicode的小写和大写字符像À(U+00C0)和à(U+00E0)，但这些都不能进行转换。

补充说明 2

当"转换对象字符串"参数为NULL，返回值也将为NULL。

小写英文字母转换函数(ToLower)

涵义

将字符串中半角英文大写字母转换为半角英文小写字母。

返回值

数据类型	注释
字符型	转换后的字符串。

详细参数

参数名	数据类型	注释
转换对象字符串	字符型	指定转换的字符串对象。

补充说明 1

当Unicode文字码被指定，字符的转换与其它文字码相同。举个例子，Unicode的小写和大写字符像"À(U+00C0)"和"à(U+00E0)"，但这些都不能进行转换。

补充说明 2

当"转换对象字符串"参数为NULL，返回值也将为NULL。

文字码变换函数(CodeConvert)

涵义

分割前	abcdef
分割后	ab	cdef
	从头部开始的前2个字符	剩余字符
	"抽取位置" = "1"	"抽取位置" = "2"

参数名	数据类型	注释
变换对象字符串	字符型	指定变换的字符串对象。
文字码种类	数值型	种类 10：Unicode(Big endian) 11：Unicode(Little endian) 12：UTF-8 13：GB18030 14：BIG5 17：IBM GB HOST 若该值未指定，将视其与 "13：GB18030"相同。