## `.`（Map）

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

點(diǎn)運(yùn)算符執(zhí)行以下邏輯：

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

此運(yùn)算符是左結(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）

過(guò)濾運(yùn)算符（又名謂詞）用于僅選擇輸入序列中滿足方括號(hào)之間的謂詞表達(dá)式的項(xiàng)目。

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

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

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

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

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

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

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

`Account.Order.Product^(Price)`

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

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

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

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

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

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

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

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

**示例**

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

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

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

## `*`（Wildcard）

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

## `**`（Descendants）

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

## `%`（Parent）

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

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

**例子**

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

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

## `#`（Positional variable binding）

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

**例子**

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

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

## `@`（Context variable binding）

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

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

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

**例子**

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

這會(huì)在貸款數(shù)組中的對(duì)象和書籍?dāng)?shù)組中的對(duì)象之間執(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、路徑運(yùn)算符