第十四章 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
返回的列表不同的其他列表类。如果更喜欢使用类,这些将非常有用。
网友评论