node_api_create_property_key_utf16


napi_status NAPI_CDECL node_api_create_property_key_utf16(napi_env env,
                                                          const char16_t* str,
                                                          size_t length,
                                                          napi_value* result); 
  • [in] env:调用该 API 时所处的环境。
  • [in] str:表示 UTF16-LE 编码字符串的字符缓冲区。
  • [in] length:字符串的长度,单位为双字节编码单元;如果是以 null 结尾,则为 NAPI_AUTO_LENGTH
  • [out] result:一个 napi_value,表示一个优化过的 JavaScript string,用作对象的属性键。

如果 API 成功,则返回 napi_ok

【Returns napi_ok if the API succeeded.】

这个 API 会从 UTF16-LE 编码的 C 字符串创建一个优化的 JavaScript string 值,以用作对象的属性键。原生字符串会被复制。

【This API creates an optimized JavaScript string value from a UTF16-LE-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.】