## `.`（Map）

點運算符是 腳本表達(dá)式的基本構(gòu)建塊之一。它實現(xiàn)了許多函數(shù)式語言中常見的“for each”或“map”函數(shù)。

點運算符執(zhí)行以下邏輯：

* 對 LHS 上的表達(dá)式進(jìn)行求值以生成一個值數(shù)組。
  * 如果它計算結(jié)果為單個值，則將其視為等同于包含該單個值的數(shù)組
  * 如果計算結(jié)果為空（無匹配或為空數(shù)組），則運算符表達(dá)式的結(jié)果為空
* 依次對 LHS 數(shù)組中的每個值進(jìn)行如下操作：
  * 該值稱為上下文 *，* 用作 RHS 上任何相對路徑表達(dá)式的基礎(chǔ)。也可以使用 `$` 符號在 RHS 表達(dá)式中訪問它。
  * 計算 RHS 表達(dá)式以生成一個值或值數(shù)組（或不生成任何值）。這些值將附加到整個運算符的組合結(jié)果數(shù)組中。
* 返回運算符的組合結(jié)果。

此運算符是左結(jié)合的，這意味著表達(dá)式 `a.b.c.d` 的求值方式為 `((a.b).c).d`；即從左到右

**示例**

* `Address.City`=>`"Winchester"`
* `Phone.number`=>`[ "0203 544 1234", "01962 001234", "01962 001235", "077 7700 1234" ]`
* `Account.Order.Product.(Price * Quantity)`=>`[ 68.9, 21.67, 137.8, 107.99 ]`
* `Account.Order.OrderID.$uppercase()`=>`[ "ORDER103", "ORDER104"]`

## `[`... `]`（Filter）

過濾運算符（又名謂詞）用于僅選擇輸入序列中滿足方括號之間的謂詞表達(dá)式的項目。

如果謂詞表達(dá)式是整數(shù)，或計算結(jié)果為整數(shù)的表達(dá)式，則輸入序列中該位置（零偏移）的項目是結(jié)果序列中唯一選定的項目。如果數(shù)字不是整數(shù)，則將其向下舍入為*最接近*的整數(shù)。

如果謂詞表達(dá)式是一個整數(shù)數(shù)組，或者是計算結(jié)果為整數(shù)數(shù)組的表達(dá)式，則輸入序列中這些位置（零偏移）的項目是結(jié)果序列中唯一選定的項目。

如果謂詞表達(dá)式的計算結(jié)果為任何其他值，則將其轉(zhuǎn)換為布爾值，就像使用 `$boolean()` 函數(shù)一樣。如果計算結(jié)果為 `true`，則該項目將保留在結(jié)果序列中。否則將被拒絕。

有關(guān)更多詳細(xì)信息和示例，請參閱[導(dǎo)航 JSON 數(shù)組]()。

## `^(`... `)`(Order-by)

order-by 運算符用于根據(jù)括號內(nèi)定義的一個或多個表達(dá)式對值數(shù)組進(jìn)行升序或降序排序。

默認(rèn)情況下，數(shù)組將按升序排序。例如：

`Account.Order.Product^(Price)`

將所有產(chǎn)品按價格遞增的順序排序（`Price` 是對象中的數(shù)字字段 `Product`）。

要按降序排序，排序表達(dá)式前面必須帶有 `>` 符號。例如：

`Account.Order.Product^(>Price)`

將所有產(chǎn)品按價格降序排列。`<` 可以使用符號明確表示按價格升序排列，盡管這是默認(rèn)行為。

可以使用逗號 ( ) 分隔指定次要（及更多）排序表達(dá)式 `,`。如果主要表達(dá)式對兩個值的排名相同，則將使用次要表達(dá)式來確定順序。例如，

`Account.Order.Product^(>Price, <Quantity)`

主要按照價格降低的方式對產(chǎn)品進(jìn)行排序，但對于價格相同的產(chǎn)品，則按數(shù)量增加的方式排序。

排序表達(dá)式可以是任何有效的 JSONata 表達(dá)式，其計算結(jié)果為數(shù)字或字符串。如果計算結(jié)果為字符串，則數(shù)組按 Unicode 代碼點的順序排序。

**示例**

* `Account.Order.Product^(Price * Quantity)`=> 按價格乘以數(shù)量遞增的順序排列。
* `student[type='fulltime']^(DoB).name`=> 所有全日制學(xué)生的姓名按出生日期排序（DoB 值是 ISO 8601 日期格式）

## `{`... `}`（Reduce）

歸約運算符可用作路徑表達(dá)式的最后一步，以將其輸入序列分組并聚合為單個對象。花括號之間的鍵/值對確定分組（通過評估鍵表達(dá)式）和每個組的聚合值。有關(guān)更多詳細(xì)信息，請參閱[分組和聚合]()。

## `*`（Wildcard）

此通配符選擇上下文對象的所有屬性的值。它可以在路徑表達(dá)式中代替屬性名稱使用，但不能與其他字符（如 glob 模式）組合使用。結(jié)果序列中這些值的順序取決于實現(xiàn)。有關(guān)示例，請參閱[通配符]()。

## `**`（Descendants）

此通配符會以遞歸方式選擇上下文對象的所有屬性值，以及在沿層次結(jié)構(gòu)下降時包含這些值的任何對象的屬性。請參閱[導(dǎo)航任意深度]()。

## `%`（Parent）

這將選擇當(dāng)前上下文值的“父級”。這里，我們將“父級”定義為具有表示上下文值的屬性的封閉對象。

這是唯一在輸入數(shù)據(jù)結(jié)構(gòu)中“向后”搜索的操作。它通過[編譯時]()對表達(dá)式的靜態(tài)分析來實現(xiàn)，并且只能在首先瀏覽該目標(biāo)父值的表達(dá)式中使用。如果由于任何原因無法確定父位置，則會引發(fā)靜態(tài)錯誤 (S0217)。

**例子**

```
Account.Order.Product.{
  'Product': `Product Name`,
  'Order': %.OrderID,
  'Account': %.%.`Account Name`
}
```

這將返回每個帳戶中每個訂單中每個產(chǎn)品的對象數(shù)組。可以使用 parent 運算符訪問封閉的 Order 和 Account 對象中的信息。重復(fù)的組合 `%.%.` 用于訪問祖父級和更高的祖先級。

## `#`（Positional variable binding）

這可用于確定當(dāng)前上下文項在序列中的哪個位置。它可在路徑中的任何映射、過濾器或排序階段之后使用。該變量可用于路徑的后續(xù)階段（例如在過濾器謂詞內(nèi)），并在路徑表達(dá)式的末尾超出范圍。

**例子**

```
library.books#$i['Kernighan' in authors].{
  'title': title,
  'index': $i
}
```

這將返回圖書館中每本 Kernighan 是作者之一的書籍的對象數(shù)組。每個對象都包含書籍的標(biāo)題及其在篩選之前在書籍?dāng)?shù)組中的位置。

## `@`（Context variable binding）

這用于將當(dāng)前上下文項 ( `$`) 綁定到命名變量。它只能在映射階段之后直接使用，而不能在篩選或排序階段之后使用。變量綁定在路徑表達(dá)式的其余部分中仍然有效。

由于當(dāng)前上下文現(xiàn)已明確綁定到命名變量，因此該上下文將被轉(zhuǎn)為路徑中下一階段的上下文。例如，在此路徑片段中，`library.loans@$l.books` 貸款數(shù)組是圖書館對象的屬性，而每筆貸款又將綁定到變量 `$l`。然后將選擇也是圖書館對象的屬性的書籍?dāng)?shù)組。

由于該運算符具有跨對象交叉引用的能力，因此可用于執(zhí)行路徑內(nèi)的數(shù)據(jù)連接。

**例子**

```
library.loans@$l.books@$b[$l.isbn=$b.isbn].{
  'title': $b.title,
  'customer': $l.customer
}
```

這會在貸款數(shù)組中的對象和書籍?dāng)?shù)組中的對象之間執(zhí)行“內(nèi)連接”，其中結(jié)構(gòu)之間的 ISBN 匹配。

塊表達(dá)式可用于擴(kuò)大數(shù)據(jù)交叉引用的范圍，如下例所示：

```
(library.loans)@$l.(catalog.books)@$b[$l.isbn=$b.isbn].{
  'title': $b.title,
  'customer': $l.customer
}
```

11、路徑運算符