startsWith
startsWith 评估表达式是否以您指定的子字符串开头。如果表达式以子字符串开头,startsWith 返回 true,否则返回 false。
语法
startsWith(expression,substring,string-comparison-mode)
Arguments
- expression
-
表达式必须是字符串。它可以是使用字符串数据类型的字段的名称、文本值(如
'12 Main Street')或对输出字符串的其他函数的调用。 - substring
-
要根据表达式检查的字符集。子字符串可在表达式中出现一次或多次。
- string-comparison-mode
-
(可选)指定要使用的字符串比较模式:
-
CASE_SENSITIVE– 字符串比较区分大小写。 -
CASE_INSENSITIVE– 字符串比较不区分大小写。
留空时此值默认为
CASE_SENSITIVE。 -
返回类型
布尔值
示例
默认区分大小写的示例
以下区分大小写的示例评估 state_nm 是否以 New 开头。
startsWith(state_nm,"New")
以下是给定的字段值。
New York new york
对于这些字段值,将返回以下值。
true false
不区分大小写的示例
以下不区分大小写的示例评估 state_nm 是否以 new 开头。
startsWith(state_nm,"new", CASE_INSENSITIVE)
以下是给定的字段值。
New York new york
对于这些字段值,将返回以下值。
true true
带条件语句的示例
startsWith 函数可用作以下 If 函数中的条件语句:avgIf、minIf、distinct_countIf、countIf、maxIf、medianIf、stdevIf、stdevpIf、sumIf、varIf 和 varpIf。
以下示例仅当 state_nm 以 New 开头时才对 Sales 求和。
sumIf(Sales,startsWith(state_nm,"New"))
不包含示例
条件 NOT 运算符可用于评估表达式是否不以指定的子字符串开头。
NOT(startsWith(state_nm,"New"))
使用数值的示例
通过应用 toString 函数,可以在表达式或子字符串参数中使用数值。
startsWith(state_nm, toString(5) )