# 使用謂詞表達式進行查詢細化

## 謂詞

在位置路徑中的任何步驟中，都可以使用謂詞過濾所選項目 -`[expr]` 其中 `expr` 計算結果為布爾值。選擇中的每個項目都根據表達式進行測試，如果計算結果為 `true`，則保留該項目；如果為 `false`，則將其從選擇中刪除。表達式是相對于正在測試的當前（上下文）項目進行評估的，因此如果謂詞表達式執行導航，則它相對于此上下文項目。

#### 例子：

* 選擇具有等于字段 `Phone` 的項目。`type"mobile"`

```
Phone[type='mobile']
//結果
{ "type": "mobile",  "number": "077 7700 1234" }
```

* 選擇手機號碼

```
Phone[type='mobile'].number
//結果 
"077 7700 1234"
```

* 選擇辦公室電話號碼 - 有兩個！

```
Phone[type='office'].number
//結果
[ "01962 001234",  "01962 001235" ]
```

## 單例數組和值等價

在 JSONata 表達式或子表達式中，任何值（本身不是數組）和僅包含該值的數組都被視為等價。這使得語言具有可組合性，以便從對象中提取單個值的位置路徑和從數組中提取多個值的位置路徑都可以用作其他表達式的輸入，而無需對這兩種形式使用不同的語法。

請考慮以下示例：

* `Address.City` 返回單一值 `"Winchester"`
* `Phone[0].number` 匹配單個值并返回該值 `"0203 544 1234"`
* `Phone[type='home'].number` 同樣匹配單個值 `"0203 544 1234"`
* `Phone[type='office'].number` 匹配兩個值，因此返回一個數組 `[ "01962 001234", "01962 001235" ]`

在處理 JSONata 表達式的返回值時，無論匹配了多少個值，結果可能都希望格式一致。在上面的前兩個表達式中，很明顯每個表達式都在處理結構中的單個值，并且只返回該值是有意義的。然而，在最后兩個表達式中，匹配的值數量并不是很明顯，如果宿主語言必須根據返回的內容以不同的方式處理結果，那就沒有用了。

如果擔心這一點，則可以修改表達式，使其即使只匹配一個值也返回一個數組。這可以通過 `[]` 在位置路徑中的某個步驟中添加空方括號來實現。上述示例可以重寫為始終返回一個數組，如下所示：

* `Address[].City` 返回 `[ "Winchester"]`
* `Phone[0][].number` 返回 `[ "0203 544 1234" ]`
* `Phone[][type='home'].number` 返回 `[ "0203 544 1234" ]`
* `Phone[type='office'].number[]` 返回 `[ "01962 001234", "01962 001235" ]`

請注意，`[]` 可以放置在謂詞的任一側以及路徑表達式中的任何步驟上

## 通配符

使用 `*` 而不是字段名稱來選擇對象中的所有字段

#### 示例

* 選擇所有字段的值 `Address`

```
Address.*
//結果
[ "Hursley Park", "Winchester", "SO21 2JN" ]
```

* 選擇任意 `Postcode` 子對象的值

```
*.Postcode
//結果  
"SO21 2JN"
```

## 導航任意深度

后代通配符 `**` 代替 `*` 將遍歷所有后代（多級通配符）。

#### 示例

* 選擇所有 `Postcode` 值，無論它們在結構中的嵌套深度如何

```
**.Postcode 
//結果 
[ "SO21 2JN", "E1 6RF" ]
```

2、謂詞查詢