Skip to main content

测试函数

测试函数执行数据比较。使用测试函数识别值的数据类型，或确定某个值是否存在。您可以对所有 数据类型 使用测试函数。

CompareDictionary

CompareDictionary(a,b) ：比较 2 个字符串，忽略大小写差异，并比较由数字组成的文本（按数字顺序）。如果 a < b，则函数返回 -1；如果 a==b；则返回 0；如果 a > b，则返回 1。

此函数与字典比较的顺序不完全相同，区别在于它不像“排序”工具在设置为根据特定语言的约定进行字典排序时一样处理变音符号。

示例

CompareDictionary("apples","bananas") 返回 -1。

CompareDictionary("APPLES","bananas") 返回 -1。

CompareDictionary("apples","BANANAS") 返回 -1。

CompareDictionary("Cherries","Bananas") 返回 1。

CompareDictionary("Bananas","bananas") 返回 0。

CompareDictionary("2","10") 返回 -1（2 小于 10，即使字符“2”大于字符“1”）。

CompareDictionary("minus -2","minus -10") 返回 1（-2 大于 -10）。减号只在开头或空格后识别。

CompareDictionary("minus-2","minus-10") 返回 -1（2 小于 10）。未在空格后面的减号不被视为数字的一部分）。

CompareDictionary("pi 3.14","pi 6.28e-1") 返回 1（是，它可识别浮点数字语法，并且 3.14 大于 0.628）。

CompareDictionary("12.00","12.0") 返回 1（当数字具有相同的值时，较长的数字字符串被视为较大值）。

CompareDictionary("a", "À") 返回 -1。

CompareDictionary("n","ñ") 返回 -1（带有标记的字母在拉丁字母表中比所有无标记的字母大）。

CompareDictionary("o","ñ") 返回 -1（使用西班牙语字典比较时，Ñ 应小于 O。这不是语言字典比较）。

CompareDictionary("ñ","Ñ") 返回 0（带标记的字符比较也忽略大小写）。

CompareDigits

CompareDigits(a, b, nNumDigits) ：比较 2 个数字并确定它们是否与给定的位数 (nNumDigits) 相同。

此比较函数先找到数字之间的差值，当差值的首个有效数字位于 A 和 B 中较大数字的首个有效数字右侧 nNumDigits 位数或更多位数时，函数就报告 A 和 B 相同。

nNumDigits 参数不能为 null 并且必须介于 1 和 19 之间。否则，会发生错误。如果提供了一个非整数，则数字将被四舍五入到最接近的整数（nNumDigits 可以在 0.5 和 19.499 之间）。

示例

CompareDigits(12345, 12444, 3) 返回“True”（因为差值为 99，且其首个有效数字位于 A 的首个有效数字右侧 3 位数）。

CompareDigits(12345, 12445, 3) 返回“False”（因为差值为 100，且其首个有效数字仅位于 A 的首个有效数字右侧 2 位数）。

CompareDigits(12.345, 12.347, 3) 返回“True”（因为差值为 0.002，且其首个有效数字位于 A 的首个有效数字右侧 4 位数）。

CompareDigits(12.345, 12.435, 3) 返回“True”（因为差值为 0.09，且其首个有效数字位于 A 的首个有效数字右侧 3 位数）。

CompareDigits( .91234, .91334, 3) 返回“False”（因为差值为 .001，且其首个有效数字仅位于 A 的首个有效数字右侧 2 位数）。

CompareEpsilon

CompareEpsilon(a, b, epsilon) ：比较 2 个浮点数，如果它们在极小值范围内，则返回 True。

示例

CompareEpsilon(123.456789101112, 123.456789101114, 0.0001) 返回“True”。

CompareEpsilon(123.456, 123.456789101112, 0.0001) 返回“False”。

EqualStrings

EqualStrings(a,b) ：将字符串 (a) 和字符串 (b) 相比较以确定它们是否完全匹配。如果字符串 a 和 b 中的所有字符都相同，则该函数将返回 True；如果有一个或多个字符不相同，则将返回 False。

请注意，此函数区分大小写。

示例

EqualStrings('Hello','Hello') 返回 True。

EqualStrings('Hello','hello') 返回 False。

EqualStrings('happy birthday','happy birthday') 返回 True。

EqualStrings('happy birthday','happy birthday') 返回 False。

EqualStrings('Happy 10th birthday!', 'Happy 10th birthday') 返回 False。

EqualStrings('Hello','') 返回 False。

EqualStrings('Hello', Null) 返回 False。

EqualStrings(Null(), Null()) 返回 True。

EqualStrings('Hello') 返回错误。该函数正好需要 2 个参数。

IsEmpty

IsEmpty(v) ：测试 v 是否为 NULL 或等于""。

示例

姓名 (v)

IsEmpty

John

False

True

Mary

False

[Null]

True

IsInteger

IsInteger(v) ：测试 (v) 是否包含可以转换为整数的值。如果是，则返回 True。

所属部分

值 (v)

IsInteger

1

True

1.23

False

B

False

IsLowerCase

IsLowerCase(String) ：如果字符串中的所有（1 个或多个）字母字符均为小写，则返回 True；如果一个或多个字母字符为大写，则返回 False。该函数将忽略非字母字符。请注意，此函数仅适用于区分大小写的字符，可能不适用于所有语言中的字符。

  • 此函数仅适用于字符串数据类型。

  • 仅当至少有一个小写字符且没有大写字符时，此函数才返回 True。

  • 此函数仅对区分大小写的字符返回 True。它可能不适用于所有语言（例如日语）的字符。

  • 如果将数值数据作为字符串传入，则函数将返回 False，因为在这种情况下，没有字母字符可供评估。字符串必须至少包含 1 个字母字符，函数才能将其评估为小写。

  • 此函数忽略空格，因为空格是非字母字符。如果表达式仅包含空格，则评估结果为 False，因为空格不区分大小写。

  • 如果传入 Null 值，该函数将返回 False。

示例

IsLowerCase('nicole') 返回 True。

IsLowerCase('happy birthday!') 返回 True。

IsLowerCase('niCOLE') 返回 False。

IsLowerCase('2023') 返回 False。该函数将忽略非字母字符，因此会将此值评估为空字段，例如：('')。

IsLowerCase(nicole) 返回错误。

IsLowerCase(2023) 返回错误。

IsLowerCase(null) 返回 False。

IsLowerCase(' ') 返回 False。空格不区分大小写。

IsNull

IsNull(v) ：测试 (v) 是否为 NULL。如果 v 为 NULL，则返回 True，否则返回 False。

要使用 NULL 值填充行，请使用 NULL() 函数。

示例

姓名 (v)

IsNull

John

False

[Null]

True

Mary

False

IsNumber

IsNumber(v) ：测试 (v) 的字段类型是否为数字。

IsSpatialObj

IsSpatialObj(v) ：测试 (v) 的字段类型是否为空间对象。

IsString

IsString(v) ：测试 (v) 的字段类型是否为字符串。

IsUpperCase

IsUpperCase(String) ：如果字符串中的所有（1 个或多个）字母字符均为大写，则返回 True；如果一个或多个字母字符为小写，则返回 False。该函数将忽略非字母字符。请注意，此函数仅适用于区分大小写的字符，可能不适用于所有语言中的字符。

  • 此函数仅适用于字符串数据类型。

  • 仅当至少有一个大写字符且没有小写字符时，此函数才返回 True。

  • 此函数仅对区分大小写的字符返回 True。它可能不适用于所有语言（例如日语）的字符。

  • 如果将数值数据作为字符串传入，则函数将返回 False，因为在这种情况下，没有需要评估的字母字符。字符串必须至少包含 1 个字母字符，函数才能将其评估为大写。

  • 此函数忽略空格，因为空格是非字母字符。如果表达式仅包含空格，则评估结果为 False，因为空格不区分大小写。

  • 如果传入 Null 值，该函数将返回 False。

示例

IsUpperCase('NICOLE') 返回 True。

IsUpperCase('HAPPY BIRTHDAY!') 返回 True。

IsUpperCase('NicOLE') 返回 False。

IsUpperCase('2023') 返回 False。该函数将忽略非字母字符，因此会将此值评估为空字段，例如：('')。

IsUpperCase(NICOLE) 返回错误。

IsUpperCase(2023) 返回错误。

IsUpperCase(null) 返回 False。

IsUpperCase(' ') 返回 False。空格不区分大小写。

本节内容如下: