## `$count()`

**用法:** `$count(array)`

返回 `array` 參數中的項數。如果 `array` 參數不是數組，而是另一種 JSON 類型的值，則該參數被視為包含該值的單例 array，此函數返回 `1`。

如果未指定 `array`，則使用上下文值作為 `array` 的值。

舉例：

* `$count([1,2,3,1])` => `4`
* `$count("hello")` => `1`

## `$append()`

**用法:** `$append(array1, array2)`

返回一個數組，其中包含 `array1` 中的值，后跟 `array2` 中的值。如果任一參數不是數組，則將其視為包含該值的單例數組。

舉例：

* `$append([1,2,3], [4,5,6])` => `[1,2,3,4,5,6]`
* `$append([1,2,3], 4)` => `[1,2,3,4]`
* `$append("Hello", "World")` => `["Hello", "World"]`

## `$sort()`

**用法:** `$sort(array [, function])`

返回一個數組，其中包含 `array` 參數中的所有值，但按順序排序。如果沒有提供 `function` 參數，則 `array` 參數必須僅包含數字或僅包含字符串，并且它們將分別按數字遞增或 unicode 代碼點遞增的順序排序。

如果提供了比較器 `function`，則 is 必須是一個接受兩個參數的函數：

`function(left, right)`

排序算法調用此函數來比較 `left` 和 `right` 兩個值。如果 `left` 的值應該按照所需的排序順序放在 `right` 的值之后，那么函數必須返回布爾值 `true` 以表示交換。否則，它必須返回 `false`。

舉例：

```
$sort(Account.Order.Product, function($l, $r) {
  $l.Description.Weight > $r.Description.Weight
})
```

這是按 Weight 增加的順序對產品進行排序。

排序算法是穩定的，這意味著原始數組中根據比較器函數相同的值將在排序后的數組中保持原始順序。

## `$reverse()`

**語法:** `$reverse(array)`

返回一個數組，其中包含 `array` 參數中的所有值，但順序相反。

舉例：

* `$reverse(["Hello", "World"])` => `["World", "Hello"]`
* `[1..5] ~> $reverse()` => `[5, 4, 3, 2, 1]`

## `$shuffle()`

**用法:** `$shuffle(array)`

返回一個數組，其中包含 `array` 參數中的所有值，但按隨機順序排列。

舉例：

* `$shuffle([1..9])` => `[6, 8, 2, 3, 9, 5, 1, 4, 7]`

## `$distinct()`

**用法** `$distinct(array)`

返回一個數組，其中包含 `array` 參數中的所有值，但刪除了所有重復值。對值進行深度相等性測試，就像使用相等運算符一樣。

舉例：

* `$distinct([1,2,3,3,4,3,5])` => `[1, 2, 3, 4, 5]`
* `$distinct(Account.Order.Product.Description.Colour)` => `[ "Purple", "Orange", "Black" ]`

## `$zip()`

**用法:** `$zip(array1, ...)`

返回一個卷積（壓縮）數組，其中包含 `array1`...`arrayN` 個來自索引 0、1、2 等的參數。

此函數接受可變數量的參數。返回數組的長度等于參數中最短數組的長度。

舉例：

* `$zip([1,2,3], [4,5,6])` => `[[1,4] ,[2,5], [3,6]]`
* `$zip([1,2,3],[4,5],[7,8,9])` => `[[1,4,7], [2,5,8]]`

20、數組函數