本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# $util.str 中的字符串帮助程序
<a name="str-helpers-in-util-str"></a>

**注意**  
我们现在主要支持 APPSYNC\_JS 运行时系统及其文档。请考虑使用 APPSYNC\_JS 运行时系统和[此处](https://docs.aws.amazon.com/appsync/latest/devguide/resolver-reference-js-version.html)的指南。

 `$util.str` 包含一些方法以帮助执行常见的字符串操作。

## $util.str 实用程序列表
<a name="str-helpers-in-util-str-list"></a>

** `$util.str.toUpper(String) : String` **  
获取一个字符串，并将其转换为完全大写。

** `$util.str.toLower(String) : String` **  
获取一个字符串，并将其转换为完全小写。

** `$util.str.toReplace(String, String, String) : String` **  
将字符串中的子字符串替换为另一个字符串。第一个参数指定要执行替换操作的字符串。第二个参数指定要替换的子字符串。第三个参数指定要替换第二个参数的字符串。以下是该实用程序的用法示例：  

```
 INPUT:      $util.str.toReplace("hello world", "hello", "mellow")
 OUTPUT:     "mellow world"
```

** `$util.str.normalize(String, String) : String` **  
使用以下 4 种 unicode 规范化形式之一规范化字符串：NFC、NFD、NFKC 或 NFKD。第一个参数是要规范化的字符串。第二个参数是 "nfc"、"nfd"、"nfkc" 或 "nfkd"，它指定用于规范化过程的规范化类型。