napi_create_string_utf8

napi_status napi_create_string_utf8(napi_env env,
                                    const char* str,
                                    size_t length,
                                    napi_value* result) 拷贝

• [in] env：调用 API 的环境。

  ¥[in] env: The environment that the API is invoked under.

• [in] str：表示 UTF8 编码字符串的字符缓冲区。

  ¥[in] str: Character buffer representing a UTF8-encoded string.

• [in] length：字符串的长度（以字节为单位），如果它以 null 结尾则为 NAPI_AUTO_LENGTH。

  ¥[in] length: The length of the string in bytes, or NAPI_AUTO_LENGTH if it is null-terminated.

• [out] result：代表 JavaScript string 的 napi_value。

  ¥[out] result: A napi_value representing a JavaScript string.

如果 API 成功，则返回 napi_ok。

¥Returns napi_ok if the API succeeded.

此 API 从 UTF8 编码的 C 字符串创建 JavaScript string 值。复制原生字符串。

¥This API creates a JavaScript string value from a UTF8-encoded C string. The native string is copied.

JavaScript string 类型在 ECMAScript 语言规范的 第 6.1.4 节 中进行了描述。

¥The JavaScript string type is described in Section 6.1.4 of the ECMAScript Language Specification.