BirtStr 类提供了一些函数来处理字符串,例如,用于并置字符串,修剪多余的空格,获取一个字符串的某些部分以及以小写字母或大写字母来显示字符串。此类是静态类。应用程序无法创建此类的实例。
此函数将返回所给定字符串的长度。
语法
参数
source
字符串。要对其求值的字符串。
返回
整数。所指定的字符串中的字符数。
示例
以下示例将返回特定字符串的长度:
以下示例将返回 CustomerName 字段中每个值的长度:
此函数将返回通过并置所指定的字符串而获得的字符串。
语法
参数
source1, ..., sourceN
字符串。要并置的字符串。
返回
字符串。并置一系列字符串而获得的字符串。
示例
以下示例将返回通过并置多个字段中的值而获得的完整地址:
BirtStr.concat( row["AddressLine1"], ", ", row["AddressLine2"], ", ", row["City"], " ", row["PostalCode"], "row["State"], ", ", row["Country"] )
此函数将返回所指定的子串在所给定字符串中的位置。
语法
参数
target
字符串。要搜索的子串。搜索区分大小写。
source
字符串。要在其中查找所指定的子串的字符串。
start
整数。可选。在源字符串中开始进行搜索的位置。如果您省略此自变量,那么此函数将从字符串的第一个字符开始进行搜索。
返回
整数。字符串中的子串的数字位置。字符串的第一个字符从 0 开始。如果找不到子串,那么此函数将返回 -1。
示例
以下示例将返回所指定的字符在特定字符串中的数字位置:
以下示例使用 BirtStr.indexOf( ) 和 BirtStr.left( ) 来显示位于客户名称中空格字符之前的字符。BirtStr.left( ) 函数将从第一个字符开始抽取具有指定长度的子串。在此示例中,要显示的子串的长度等于空格字符的数字位置。
如果客户名称为 Julie Murphy,那么此表达式将返回 Julie。
此函数将从字符串中最左边的字符(即,第一个字符)开始抽取指定长度的子串。
语法
参数
source
字符串。从其中抽取子串的字符串。
n
整数。要从第一个字符开始抽取的字符数。
返回
字符串。特定长度的子串。
示例
以下示例将返回特定字符串中具有不同长度的子串:
以下示例使用 BirtStr.indexOf( ) 和 BirtStr.left( ) 来显示位于客户名称中空格字符之前的字符。BirtStr.left( ) 函数将从第一个字符开始抽取具有指定长度的子串。在此示例中,要显示的子串的长度等于空格字符的数字位置。
如果客户名称为 Julie Murphy,那么此表达式将返回 Julie。
此函数将从字符串中最右边的字符(即最后一个字符)开始抽取指定长度的子串。
语法
参数
source
字符串。从其中抽取子串的字符串。
n
整数。要从最后一个字符开始抽取的字符数。
返回
字符串。特定长度的子串。
示例
以下示例将返回特定字符串中具有不同长度的子串:
以下示例使用 BirtStr.right( ) 以及 BirtStr.indexOf( ) 和 BirtStr.charLength( ) 函数来显示位于客户名称中空格字符之后的字符。此示例假定连字符后面的字符数存在变化。因此,整个字符串的长度(由 BirtStr.charLength( ) 返回)减去直到连字符为止的长度(由 BirtStr.indexOf( ) 返回)就是要显示的字符数。
如果客户名称为 Julie Murphy,那么此表达式将返回 Murphy。如果客户名称为 Kwai Li,那么此表达式将返回 Li。
此函数将返回所指定子串在所给定字符串中的位置。该子串可以包含通配符。
语法
参数
pattern
字符串。要搜索的字符串模式。搜索不区分大小写。可以在模式中使用下列通配符:
要表示字符串中的文字星号或问号本身,请在这些字符前面添加两个反斜杠(\\)字符。例如,要查找子串 R*10,请使用以下字符串模式:
source
字符串。要在其中查找所指定的子串的字符串。
index
整数。可选。在源字符串中开始进行搜索的位置。如果您省略此自变量,那么此函数将从字符串的第一个字符开始进行搜索。
返回
整数。字符串中的子串的数字位置。字符串的第一个字符从 0 开始。如果找不到子串,那么此函数将返回 -1。
示例
以下示例将返回所指定的字符串模式在特定字符串中的数字位置:
以下示例将在 ProductCode 字段的每个值中搜索字符串模式 S*A。如果产品代码为 KBS5412A,那么此表达式将返回 2。
以下示例使用 BirtStr.search( ) 和 BirtStr.left( ) 来显示位于产品名称中字符串模式 -Model* 之前的字符。BirtStr.left( ) 函数将从第一个字符开始抽取具有指定长度的子串。在此示例中,要显示的子串的长度等于字符串模式的数字位置。
如果产品名称为 XMS-ModelA-1234,那么此表达式将返回 XMS。
此函数会将字符串中的所有字母都转换为小写。
语法
参数
source
字符串。要转换为小写的字符串。
返回
字符串。所指定的字符串全部都采用小写字母
示例
以下示例将采用小写形式显示 productLine 字段中的所有值:
此函数会将字符串中的所有字母都转换为大写。
语法
参数
source
字符串。要转换为大写的字符串。
返回
字符串。所指定的字符串全部都采用大写字母
示例
以下示例将采用大写形式显示 customerName 字段中的所有值:
此函数将返回一个移除了所有前导空格和尾部空格字符的字符串。它并不会除去两个单词之间的空格字符。
语法
参数
source
字符串。要从其中移除前导空格和尾部空格字符的字符串。
返回
字符串。一个移除了所有前导空格和尾部空格字符的字符串。
示例
以下示例使用 BirtStr.trim( ) 从 FirstName 和 LastName 数据字段的值中除去所有前导空格和尾部空格字符。
此函数将返回一个移除了所有前导空格和尾部空格字符的字符串。它并不会除去两个单词之间的空格字符。
语法
参数
source
字符串。要从其中移除前导空格字符的字符串。
返回
字符串。一个移除了所有前导空格字符的字符串。
示例
以下示例会将文字串与 customerName 字段中的每个值进行并置。BirtStr.trimLeft( ) 将除去位于 customerName 值之前的所有空格字符,从而使得文字串与 customerName 值之间没有额外的空格字符。
此函数将返回一个除去了所有尾部空格字符的字符串。它并不会除去两个单词之间的空格字符。
语法
参数
source
字符串。要从其中移除尾部空格字符的字符串。
返回
字符串。一个移除了所有尾部空格字符的字符串。
示例
以下示例会将 Comment 字段中的每个值与分号进行并置,然后与 Action 字段中的值进行并置。BirtStr.trimRight( ) 将除去位于 Comment 值之后的所有空格字符,从而使得 Comment 字符串与分号之间没有额外的空格字符。