本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 在 $util.list 中列出協助程式
<a name="list-helpers-in-util-list"></a>

**注意**  
我們現在主要支援 APPSYNC\_JS 執行期及其文件。請考慮[在此處](https://docs.aws.amazon.com/appsync/latest/devguide/resolver-reference-js-version.html)使用 APPSYNC\_JS 執行期及其指南。

`$util.list` 包含有助於常見清單操作的方法，例如從清單中移除或保留項目以篩選使用案例。

## 列出 utils
<a name="utility-helpers-in-list-utils"></a>

** `$util.list.copyAndRetainAll(List, List) : List` **  
製作第一個引數中所提供清單的淺層副本，如果項目存在，則僅保留第二個引數中指定的項目。所有其他項目將從副本中刪除。

** `$util.list.copyAndRemoveAll(List, List) : List` **  
製作第一個引數中所提供清單的淺層副本，同時移除在第二個引數中指定項目的任何項目，如果有的話。所有其他項目將保留在副本中。

** `$util.list.sortList(List, Boolean, String) : List` **  
排序在第一個引數中提供的物件清單。如果第二個引數為 true，清單會以遞減方式排序；如果第二個引數為 false，清單會以遞增方式排序。第三個引數是用來排序自訂物件清單的 屬性字串名稱。如果只是字串、整數、浮點數或雙數的清單，則第三個引數可以是任何隨機字串。如果所有物件不是來自相同類別，則會傳回原始清單。僅支援最多包含 1000 個物件的清單。以下是此公用程式使用的範例：  

```
 INPUT:      $util.list.sortList([{"description":"youngest", "age":5},{"description":"middle", "age":45}, {"description":"oldest", "age":85}], false, "description")
 OUTPUT:     [{"description":"middle", "age":45}, {"description":"oldest", "age":85}, {"description":"youngest", "age":5}]
```