简单的加法
前面的 Hello World 的例子很简单,接下来看看如何处理参数传递。我们来写个 sum
函数,也就是简单的加法。这里核心的关键就是 args
参数就是入参数组,就类似 JavaScript 里函数的 arguments
对象,我们需要做的就是把参数做一下类型转换,转成数值型求和就好了:
// sum.cc
#include <node.h>
namespace demo {
using v8::Number;
using v8::Local;
void Sum(const v8::FunctionCallbackInfo<v8::Value> &args) {
v8::Isolate *isolate = args.GetIsolate();
Local<v8::Context> context = isolate->GetCurrentContext();
Local<Number> a = (args[0]->ToNumber(context)).ToLocalChecked();
Local<Number> b = (args[1]->ToNumber(context)).ToLocalChecked();
args.GetReturnValue().Set(a->Value() + b->Value());
}
void Init(v8::Local<v8::Object> exports) {
NODE_SET_METHOD(exports, "sum", Sum);
}
// 这里的 NODE_GYP_MODULE_NAME 宏就是 前面 binding.gyp 的指定的 target_name
NODE_MODULE(NODE_GYP_MODULE_NAME, Init)
} // namespace demo
这里为了方便,使用了 C++ 的 using
语法引入 v8 里的命名空间,省得重复写 v8::Local
等。
核心就是 12-16 行了,简单看一下:
- 12 行,从
isolate
的 API 获取当前实例的上下文,后面获取数值的本地句柄方法需要用到; - 14 & 15 行,从
args[0]
、args[1]
调用toNumber
方法将 JS 传入的参数转为v8::Number
的数据类型。这里不熟悉 C++ 的同学可能会问,->
和.
是什么关系?什么时候用->
什么时候用.
?->
是 C++ 提供的一种简化语法,方便对指针所指向对象的成员的快捷访问,p->hello()
就等价于(*p).hello()
,其实相当于是解引用与获取对象成员的合并操作。具体来说这个 case 里,args[0]
本身是一个v8::Value
类型的本地句柄,也就是v8::Local<v8::Value>
类型,调用.
操作符时只能调用句柄本身的 API,就包括前文提到的New
、Clear
等 API,用于句柄本身比如类型转换、检查是否句柄为空、清理句柄等。- 那调用
args[0]->
时是访问什么对象的 API 呢?其实就是这个本地句柄指向的实际的对象,也就是v8::Value
对象的成员方法了。前文我们看过,v8::Value
是v8
里针对 JS 数据类型封装的绝大多数类型的超类,基于它可以进一步对参数做类型转换获得我们的场景下需要的数据类型; - 注意这里的
ToNumber
返回的也是一个待实本地句柄,所以也需要调用ToLocalChecked()
方法转为本地句柄。除了ToNumber
之外,还有很多各种转换为其他 V8 数据类型的 API,如ToString
、ToBoolean
、ToObject
等等; - 这样通过转换,我们就拿到了两个入参对应的数值类型的本地句柄了。
- 那调用
- 最后是 16 行,将 a、b 这两个本地句柄调用
toValue()
方法(注意这里已经是v8::Number
类的toValue
方法了)拿到实际的 C++ double 类型的数值,求和之后设置返回值即可。
OK,我们编译一下,还是像前文所述,配置一下 binding.gyp
,执行一下 build:
> node-gyp rebuild
CXX(target) Release/obj.target/sum/sum.o
SOLINK_MODULE(target) Release/sum.node
写个简单的 JS 代码跑一下:
const { sum } = require('./build/Release/sum.node');
console.log(sum(1, 2));
运行一下:
» node ./sum.js [14:30:39]
3
OK,这个简单的例子就写好了。
不定参数求和
接下来的一个问题是,这个函数是固定了 2 个参数,如果传过来是多个不固定的数量的数据怎么改写呢?思路也简单,必然需要用到循环遍历了:
// sum.cc
#include <node.h>
namespace demo {
using v8::Number;
using v8::Local;
using v8::FunctionCallbackInfo;
using v8::Value;
void Add(const FunctionCallbackInfo<Value> &args) {
v8::Isolate *isolate = args.GetIsolate();
Local<v8::Context> context = isolate->GetCurrentContext();
Local<Number> a = (args[0]->ToNumber(context)).ToLocalChecked();
Local<Number> b = (args[1]->ToNumber(context)).ToLocalChecked();
args.GetReturnValue().Set(a->Value() + b->Value());
}
void Sum(const FunctionCallbackInfo<Value> &args) {
v8::Isolate *isolate = args.GetIsolate();
Local<v8::Context> context = isolate->GetCurrentContext();
double sum = 0;
for (int i = 0;i < args.Length();i++) {
sum += (args[i]->ToNumber(context)).ToLocalChecked()->Value();
}
args.GetReturnValue().Set(sum);
}
void Init(v8::Local<v8::Object> exports) {
NODE_SET_METHOD(exports, "add", Add);
NODE_SET_METHOD(exports, "sum", Sum);
}
// 这里的 NODE_GYP_MODULE_NAME 宏就是 前面 binding.gyp 的指定的 target_name
NODE_MODULE(NODE_GYP_MODULE_NAME, Init)
} // namespace demo
我们把之前的 Sum
函数重命名为 Add
,新加一个 Sum
函数,这里唯一的知识点就是 args.Length()
可以获得入参的数量,所以写个 for 循环累加起来就好了。然后 33-34 行我们为两个函数分别定义两个导出,在 JS 侧:
const { add, sum } = require('./build/Release/sum.node');
console.log(add(1, 2));
console.log(sum(1, 2, 3, 4));
编译后执行一下:
dickeylth➜github/node-addon-playground/1-sum(main✗)» tnpm run build [14:30:41]
> 0-hello-world@1.0.0 build /Users/dickeylth/dev/github/node-addon-playground/1-sum
> node-gyp rebuild
CXX(target) Release/obj.target/sum/sum.o
SOLINK_MODULE(target) Release/sum.node
dickeylth➜github/node-addon-playground/1-sum(main✗)» node ./sum.js [15:25:49]
3
10
是不是非常简单?