node_api_create_property_key_utf8

napi_status NAPI_CDECL node_api_create_property_key_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 two-byte code units, or NAPI_AUTO_LENGTH if it is null-terminated.

• [out] result：napi_value 代表优化的 JavaScript string，用作对象的属性键。

  ¥[out] result: A napi_value representing an optimized JavaScript string to be used as a property key for objects.

如果 API 成功，则返回 napi_ok。

¥Returns napi_ok if the API succeeded.

此 API 从 UTF8 编码的 C 字符串创建优化的 JavaScript string 值，以用作对象的属性键。复制原生字符串。

¥This API creates an optimized JavaScript string value from a UTF8-encoded C string to be used as a property key for objects. The native string is copied.

JavaScript string 类型在 ECMAScript 语言规范的 字符串类型部分 中进行了描述。

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