参数

参数部分描述了原语格式中每个输入参数所代表的含义。您必须在参数位置提供的数据类型使用数据类型代码表示,如 (num)、[num] 和 {num}。任何带圆括号的数据类型代码,如 (num),表示您在参数位置放置的表达式必须返回单个值。带方括号的代码,如 [num],表示指定数据类型的列表。带花括号的代码,如 {num},表示输入数据可以是列表,但列表中的每个项被独立处理。

代码 [num] 和 {num} 都表示值的列表。区别在于 [num] 表示列表作为整体处理,而 {num} 不是。例如,sum 原语的输入数据类型为 [num]。Sum 将输入列表中的所有值相加并返回单个总计。abs 原语的输入数据类型为 {num}。这意味着如果您提供一组输入数字,abs 将返回一个包含列表中每个项绝对值的列表。

以下是原语描述的参数部分中使用的所有数据类型代码的完整列表:

参数

参数 描述
any 数字、文本字符串或布尔值
int 整数(例如,-1、0、5、3e89)
real 实数(例如,-3.14、5、3e-89)
unit 带可选单位的实数(例如,3.5sec)
comp 实数或复数(例如,3.1+2.3i、i、5)
num 带可选单位的实数或复数
text 文本字符串(例如,"A text string")
bool Truefalse 或任何数字;零被视为 false,所有其他数字为 true
(node) 节点或变量的名称(不带引号)
[node] 以文本字符串表示的节点名称列表;[node] 与 [text] 相同,但允许使用缩写表示法,例如,"node1,node2,node3" 等效于 ["node1","node2","node3"]。

数据类型代码和参数描述适用于参数位置中表达式返回的值,而不是表达式本身。例如,sin 原语的格式为 sin(x),其中参数 x 是任意数字(num)。这并不意味着您在参数位置输入的表达式必须是数字字面量,如 sin(3)。相反,参数可以是任何返回数字的表达式。因此,诸如

sin(PI/2)

sin(asknumber("Give me a number:"))

这样的表达式是可以的。

参见 原语描述格式