鸿蒙开发 napi系列学习基础篇——NAPI数据类型转换与同步调用

napi的数据类型

在通过IDE创建工程的示例代码中，我们使用napi_create_string_utf8函数将C/C++ string转换成NAPI类型——napi_value 。OpenHarmony NAPI将ECMAScript标准中定义的Boolean、Null、Undefined、Number、BigInt、String、Symbol和Object八种数据类型，以及函数对应的Function类型，统一封装成napi_value类型 (也称为JS类型)。该类型用于接收应用传递过来的数据以及返回数据给应用。 本文将讲述JS类型和C/C++数据类型之间的转换 。

napi的数据类型转换接口

OpenHarmony NAPI提供了很多接口用来napi的数据类型与C/C++数据类型之间的转换。以下列出常用的几种接口

C/C++数据类型转napi类型

• napi_create_double(napi_env env, double value, napi_value* result);
• napi_create_int32(napi_env env, int32_t value, napi_value* result);
• napi_create_uint32(napi_env env, uint32_t value, napi_value* result);
• napi_create_int64(napi_env env, int64_t value, napi_value* result);
• napi_create_string_utf8(napi_env env, const char* str, size_t length, napi_value* result);

napi类型转C/C++数据类型

• napi_get_value_double(napi_env env, napi_value value, double* result);
• napi_get_value_int32(napi_env env, napi_value value, int32_t* result);
• napi_get_value_uint32(napi_env env, napi_value value, uint32_t* result);
• napi_get_value_int64(napi_env env, napi_value value, int64_t* result);
• napi_get_value_string_utf8(napi_env env, napi_value value, char* buf, size_t bufsize, size_t* result);
• napi_get_value_bool(napi_env env, napi_value value, bool* res