第十四章 ObjectScript - 系统函数

系统函数

本节重点介绍 ObjectScript 中一些最常用的系统函数。

这些函数的名称不区分大小写。

类库还提供了大量实用方法，可以像使用函数一样使用它们。

Value Choice

在给定一些输入的情况下，可以使用以下函数来选择一个值：
- $CASE 将给定的测试表达式与一组比较值进行比较，然后返回与匹配的比较值关联的返回值。例如：

TESTNAMESPACE>set myvar=1

TESTNAMESPACE>write $CASE(myvar,0:"zero",1:"one",:"other")
one

• $SELECT 检查一组表达式并返回与第一个 true 表达式关联的返回值。例如：

TESTNAMESPACE>set myvar=1

TESTNAMESPACE>write $SELECT(myvar=0:"branch A",1=1:"branch B")
branch B

存在函数

可以使用以下函数来测试变量或变量节点是否存在。
- 要测试特定变量是否存在，请使用 $DATA 函数。

对于包含多个节点的变量，该函数可以指示给定节点是否存在，以及给定节点是否有值和子节点。

• 要获取变量的值（如果存在）或获取默认值（如果不存在），请使用 $GET 函数。

列表函数

ObjectScript 提供本机列表格式。可以使用以下函数来创建和使用这些列表：

• $LISTBUILD 返回一种称为列表的特殊字符串。有时这称为 $LIST 格式，以将此类列表与其他类型（例如逗号分隔列表）区分开。

使用 $LIST 列表的唯一受支持的方法是使用 ObjectScript 列表函数。此类列表的内部结构没有记录，如有更改，恕不另行通知。
- $LIST 返回列表元素或可用于替换列表元素。
- $LISTLENGTH 返回列表中的元素数量。
- $LISTFIND 返回给定列表中给定元素的位置。

还有其他列表功能。

如果使用的列表函数的值不是列表，会收到 <LIST>错误。

注意：系统类 %Library.List 相当于 $LISTBUILD 返回的列表。也就是说，当类中具有 %Library.List 类型的属性时，可以使用此处命名的函数来处理该属性。可以通过其短名称 %List中引用此类。

IRIS 提供了与 $LISTBUILD 返回的列表不同的其他列表类。如果更喜欢使用类，这些将非常有用。