## `$map()`

**簽名:** `$map(array, function)`

返回一個數組，其中包含將函數參數應用于數組參數中每個值的結果。

作為第二個參數提供的函數必須具有以下簽名：
`function(value [, index [, array]])`

輸入數組中的每個值都作為所提供函數中的第一個參數傳入。如果指定，則該值在輸入數組中的索引（位置）將作為第二個參數傳入。如果指定，整個輸入數組將作為第三個參數傳入。

**Examples**

* `$map([1..5], $string)` => `["1", "2", "3", "4", "5"]`

使用用戶定義（lambda）函數：

```
$map(Email.address, function($v, $i, $a) {
   'Item ' & ($i+1) & ' of ' & $count($a) & ': ' & $v
})
```

評估結果為：

```
[
  "Item 1 of 4: fred.smith@my-work.com",
  "Item 2 of 4: fsmith@my-work.com",
  "Item 3 of 4: freddy@my-social.com",
  "Item 4 of 4: frederic.smith@very-serious.com"
]
```

## `$filter()`

**簽名** `$filter(array, function)`
返回一個數組，該 `array` 僅包含滿足 `function` 謂詞的數組參數中的值（即 `function` 在傳遞值時返回布爾 `true`）。

作為第二個參數提供的函數必須具有以下簽名：
`function(value [, index [, array]])`

示例，以下表達式返回價格高于平均值的所有產品：

```
$filter(Account.Order.Product, function($v, $i, $a) {
  $v.Price > $average($a.Price)
})
```

## `$single()`

**簽名:** `$single(array, function)`

返回數組參數中滿足函數謂詞的唯一一個值（即函數在傳遞值時返回布爾 `true`）。如果匹配值的數量不完全為 1，則拋出異常。

作為第二個參數提供的函數必須具有以下簽名：

`function(value [, index [, array]])`

示例以下表達式表示 SKU 為 `"0406654608"` 的訂單中的產品：

```
$single(Account.Order.Product, function($v, $i, $a) {
  $v.SKU = "0406654608"
})
```

## `$reduce()`

**簽名:** `$reduce(array, function [, init])`

返回一個聚合值，該聚合值是通過將函數參數連續應用于數組中的每個值，并結合之前應用函數的結果而得到的。

該函數必須至少接受兩個參數，并且在數組中的每個值之間表現得像中綴運算符。此提供函數的簽名必須采用以下格式：

`myfunc($accumulator, $value[, $index[, $array]])`

實例：

```
(
  $product := function($i, $j){$i * $j};
  $reduce([1..5], $product)
)
```

這將數組 `[1..5]`]中的所有值相乘，返回 `120`。

如果提供了可選的 init 參數，則該值將用作聚合（折疊）過程中的初始值。如果沒有提供，則初始值是數組參數中的第一個值。

## `$sift()`

**簽名:** `$sift(object, function)`

返回一個對象，該對象僅包含對象參數中滿足作為第二個參數傳入的謂詞函數的鍵/值對。

如果未指定對象，則使用上下文值作為對象的值。如果對象不是對象，則這是一個錯誤。

作為第二個參數提供的函數必須具有以下簽名：

`function(value [, key [, object]])`

輸入對象中的每個值都作為所提供函數中的第一個參數傳入。如果指定，則輸入對象中該值的鍵（屬性名）將作為第二個參數傳入。如果指定，整個輸入對象將作為第三個參數傳入。

實例：

```
Account.Order.Product.$sift(function($v, $k) {$k ~> /^Product/})
```

這將篩選每個 Product 對象，使其僅包含鍵以字符串“Product”開頭的字段（使用正則表達式）。此示例返回：

```
[
  {
    "Product Name": "Bowler Hat",
    "ProductID": 858383
  },
  {
    "Product Name": "Trilby hat",
    "ProductID": 858236
  },
  {
    "Product Name": "Bowler Hat",
    "ProductID": 858383
  },
  {
    "ProductID": 345664,
    "Product Name": "Cloak"
  }
]
```

23、高階函數

23、高階函數