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,表示一个优化过的 JavaScriptstring,用作对象的属性键。
如果 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.】