# 簡單查詢

為了支持從 JSON 結構中提取值，定義了位置路徑語法。與 XPath 一樣，這將選擇文檔中與指定位置路徑匹配的所有可能值。JSON 的兩個結構構造是對象和數組。

## 瀏覽 JSON 對象

JSON 對象是關聯數組（又稱為映射或哈希）。用于導航到任意深度嵌套的 JSON 對象結構的位置路徑語法包括由點“.”分隔符分隔的字段名稱。表達式返回導航到位置路徑中的最后一步后引用的 JSON 值。如果在位置路徑導航過程中未找到字段，則表達式不返回任何內容（由 Javascript *undefined* 表示）。不會因輸入文檔中不存在數據而引發任何錯誤。

除非另有說明，本指南中的示例均使用以下示例 JSON 文檔：

```json
{
  "FirstName": "Fred",
  "Surname": "Smith",
  "Age": 28,
  "Address": {
    "Street": "Hursley Park",
    "City": "Winchester",
    "Postcode": "SO21 2JN"
  },
  "Phone": [
    {
      "type": "home",
      "number": "0203 544 1234"
    },
    {
      "type": "office",
      "number": "01962 001234"
    },
    {
      "type": "office",
      "number": "01962 001235"
    },
    {
      "type": "mobile",
      "number": "077 7700 1234"
    }
  ],
  "Email": [
    {
      "type": "work",
      "address": ["fred.smith@my-work.com", "fsmith@my-work.com"]
    },
    {
      "type": "home",
      "address": ["freddy@my-social.com", "frederic.smith@very-serious.com"]
    }
  ],
  "Other": {
    "Over 18 ?": true,
    "Misc": null,
    "Alternative.Address": {
      "Street": "Brick Lane",
      "City": "London",
      "Postcode": "E1 6RF"
    }
  }
}
```

#### 示例

以下是一些示例表達式及其應用于上述 JSON 文檔的結果：

* 返回 JSON 字符串（“雙引號”）

```
Surname
// 結果
“smith”
```

* 返回 JSON 數字

```
Age
// 結果
  28
```

* 字段引用以“.”分隔。

```
Address.City
//結果
"Winchester"
```

* 匹配路徑并返回空值

```
Other.Misc
// 結果 
null
```

* 未找到路徑。不返回任何內容（即 Javascript *未定義* ）
  
  ```
  Other.nothing 
  //結果
  ```
* 包含空格或保留標記的字段引用可以用反引號括起來

```
Other.`Over 18 ?` 
// 結果
true
```

## 瀏覽 JSON 數組

當需要有序的值集合時，將使用 JSON 數組。數組中的每個值都與一個索引（位置）而不是名稱相關聯，因此為了尋址數組中的各個值，需要額外的語法來指定索引。這是通過使用數組字段名稱后的方括號來完成的。如果方括號包含數字或計算結果為數字的表達式，則該數字代表要選擇的值的索引。索引是零偏移，即數組中的第一個值 `arr` 是 `arr[0]`。如果數字不是整數，則將其向下舍入*為*整數。如果方括號中的表達式是非數字的，或者是不能計算為數字的表達式，則將其視為[謂詞](http://docs.jsonata.org/predicate#predicates)。

負索引從數組末尾開始計數，例如，`arr[-1]` 將選擇最后一個值、`arr[-2]` 倒數第二個值等等。如果指定的索引超出了數組的大小，則不會選擇任何內容。

如果數組未指定索引（即字段引用后沒有方括號），則選擇整個數組。如果數組包含對象，并且位置路徑選擇這些對象中的字段，則將查詢數組中的每個對象以進行選擇。

#### 示例

* 返回第一項（一個對象）

```
Phone[0]
// 結果
{ "type": "home", "number": "0203 544 1234" } `
```

* 返回第二項

```
Phone[1]
//結果
{ "type": "office", "number": "01962 001234" }
```

* 返回最后一項

```
Phone[-1]
// 結果
{ "type": "mobile", "number": "077 7700 1234"
```

* 從末尾開始的負索引計數

```
Phone[-2]
//結果
{ "type": "office", "number": "01962 001235" }
```

* 不存在 - 不返回任何內容

```
Phone[8]
//結果
```

* 選擇 `number` 第一項中的字段

```
Phone[0].number 
 //結果 
"0203 544 1234"
```

* 由于沒有給出索引，`Phone` 因此它選擇所有元素（整個數組），然后選擇 `number` 每個元素的所有字段

```
Phone.number  
//結果   
[ "0203 544 1234", "01962 001234", "01962 001235", "077 7700 1234" ]
```

* 可能期望它只返回第一個數字，但它返回所選的每個項目的第一個數字 `Phone`

```
Phone.number[0]
// 結果  
[ "0203 544 1234", "01962 001234", "01962 001235", "077 7700 1234" ]
```

* 將索引應用于 返回 `Phone.number` 的數組。使用一次[括號](http://docs.jsonata.org/composition#parenthesized-expressions-and-blocks)。
  
  ```
  (Phone.number)[0]
  //結果
  "0203 544 1234"
  ```
  
  ```
  
  ```
* 通過創建索引數組返回一系列項目

```
Phone[[0..1]]|
// 結果
[{ "type": "home", "number": "0203 544 1234" },{ "type": "office", "number": "01962 001234" }]
```

## 結果序列

## 序列扁平化

## 空序列和單例序列

### 頂層數組、嵌套數組和數組展平

考慮 JSON 文檔：

```
[
{ "ref": [ 1,2 ] },
{ "ref": [ 3,4 ] }
]
```

在頂層，我們有一個數組而不是一個對象。如果我們想選擇這個頂層數組中的第一個對象，我們沒有字段名稱來附加它 `[0]`。我們不能 `[0]` 單獨使用它，因為這與[數組構造函數]() 語法沖突。但是，我們可以使用*上下文*引用 `$` 來引用文檔的開頭，如下所示：

* `$` 表達式開頭指的是整個輸入文檔

```
$[0] 
//結果
{ "ref": [ 1,2 ] }
```

* `.ref` 這里返回整個內部數組

```
$[0].ref
 //結果
[ 1,2 ]
```

* 返回內部數組第一個位置的元素

```
$[0].ref[0]
// 結果
1
```

* 盡管嵌套數組的結構如此，但結果選擇仍會展平為單個平面數組。輸入數組的原始嵌套結構已丟失。請參閱[數組構造函數]()以了解如何在結果中保留原始結構。

```
$.ref
//結果 
[ 1, 2, 3, 4 ]

```

1 、簡單查詢

1 、簡單查詢