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] str:表示 UTF8 编码字符串的字符缓冲区。
  • [in] length:字符串的字节长度,如果是以空字符结尾,则使用 NAPI_AUTO_LENGTH
  • [out] result:一个表示 JavaScript stringnapi_value

如果 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 语言规范的 段字符串类型 中有描述。

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