功能¶

当前节点¶

这个 current-node 令牌可用于表示正在计算的当前节点。这个 current-node 令牌对于需要将当前节点作为参数求值的函数很有用。例如，下面的表达式创建一个数组，其中包含 foo 对象后跟的值 foo["bar"] .

foo[].[count(@), bar]

JMESPath假定所有函数参数都在当前节点上操作，除非参数是 literal 或 number 令牌。因此，一个像 @.bar 相当于 bar ，因此当前节点只允许作为裸表达式。

防抱死制动系统¶

number abs(number $value)

Returns the absolute value of the provided argument. The signature indicates that a number is returned, and that the input argument $value must resolve to a number, otherwise a invalid-type error is triggered.

下面是一个成功的例子。鉴于：：

{"foo": -1, "bar": "2"}

评价 abs(foo) 工程如下：

1. 根据当前数据计算输入参数：

   search(foo, {"foo": -11, "bar": 2"}) -> -1
   

2. 验证已解析参数的类型。在这种情况下 -1 属于类型 number 所以它通过了类型检查。

3. 使用已解析的参数调用函数：：

   abs(-1) -> 1
   

4. 价值 1 函数表达式的解析值

   abs(foo) .

以下是评估的相同步骤 abs(bar) ：

1. 根据当前数据计算输入参数：

   search(foo, {"foo": -1, "bar": 2"}) -> "2"
   

2. 验证已解析参数的类型。在这种情况下 "2 属于类型 string 所以直接表示 invalid-type 发生错误。

作为最后一个例子，下面是评估 abs(to_number(bar)) ：

1. 根据当前数据计算输入参数：

   search(to_number(bar), {"foo": -1, "bar": "2"})
   

2. 为了计算上述表达式，我们需要计算 to_number(bar) ：：

   search(bar, {"foo": -1, "bar": "2"}) -> "2"
   # Validate "2" passes the type check for to_number, which it does.
   to_number("2") -> 2
   

3. 现在我们可以计算原始表达式：

   search(to_number(bar), {"foo": -1, "bar": "2"}) -> 2
   

4. 使用最终解析的值调用函数：：

   abs(2) -> 2
   

5. 价值 2 函数表达式的解析值 abs(to_number(bar)) .

平均¶

number avg(array[number] $elements)

返回所提供数组中元素的平均值。

空数组将产生null的返回值。

包含¶

boolean contains(array|string $subject, array|object|string|number|boolean $search)

返回 true 如果给定 $subject 包含提供的 $search 字符串。

如果 $subject 是一个数组，如果数组中的一个元素等于提供的 $search 价值。

如果提供 $subject 是字符串，如果字符串包含提供的 $search 争论。

塞尔¶

number ceil(number $value)

如果需要，通过向上舍入返回下一个最大的整数值。

地板¶

number floor(number $value)

如果需要，通过向下舍入返回下一个最小的整数值。

参加¶

string join(string $glue, array[string] $stringsarray)

返回所提供的 $stringsarray 数组使用 $glue 参数作为每个参数之间的分隔符。

钥匙¶

array keys(object $obj)

返回包含所提供对象的键的数组。

长度¶

number length(string|array|object $subject)

使用以下类型规则返回给定参数的长度：

1. 字符串：返回字符串中代码点的数目

2. array：返回数组中的元素数

3. object：返回对象中键值对的数目

最大值¶

number max(array[number] $collection)

返回在提供的数组参数中找到的最大值。

空数组将产生null的返回值。

闽¶

number min(array[number] $collection)

返回在提供的 $collection 争论。

分类¶

array sort(array $list)

此函数接受数组 $list 参数，并返回 $list 作为一个数组。

数组必须是字符串或数字的列表。字符串排序基于代码点。不考虑区域设置。

to_string¶

string to_string(string|number|array|object|boolean $arg)

• 字符串-返回传入的值。

• number/array/object/boolean—对象的JSON编码值。JSON编码器应该发出编码的JSON值，而不添加任何额外的新行。

to_number¶

number to_number(string|number $arg)

• 字符串-返回解析后的数字。任何符合 json-number 支持生产。

• number-返回传入的值。

• 数组-空

• 对象-空

• 布尔值-空

类型¶

string type(array|object|string|number|boolean|null $subject)

返回给定的 $subject 参数作为字符串值。

返回值必须是以下值之一：

• 数

• 一串

• 布尔

• 数组

• 对象

• 无效的

价值观¶

array values(object $obj)

返回所提供对象的值。