napi_get_value_string_utf8


napi_status napi_get_value_string_utf8(napi_env env,
                                       napi_value value,
                                       char* buf,
                                       size_t bufsize,
                                       size_t* result) 
  • [in] env:API 被调用时所处的环境。
  • [in] valuenapi_value 表示 JavaScript 字符串。
  • [in] buf:用于写入 UTF8 编码字符串的缓冲区。如果传入 NULL,字符串的字节长度(不包括空终止符)将返回到 result 中。
  • [in] bufsize:目标缓冲区的大小。当该值不足时,返回的字符串将被截断并以空字符结尾。
  • [out] result:复制到缓冲区的字节数,不包括空字符终止符。

如果 API 成功,则返回 napi_ok。如果传入了非 string 类型的 napi_value,则返回 napi_string_expected

🌐 Returns napi_ok if the API succeeded. If a non-string napi_value is passed in it returns napi_string_expected.

此 API 返回对应于传入值的 UTF8 编码字符串。

🌐 This API returns the UTF8-encoded string corresponding the value passed in.