WebAssembly初级——Embind普通函数、C++类（四）

系列文章目录

WebAssebmly初级

---

前言

如果之前看过前几篇文章，在了解了什么是WebAssebmly、WebAssebmly和C++，并且搭建好了WebAssebmly环境，自己也尝试过使用WebAssebmly调用C++方法，那么很容易就发现由于WebAssebmly只识别C风格的接口，并且在调试的时候明显函数名是C风格的（前面要加_），例如：

而本文主要介绍如何使用EMSCRIPTEN_BINDINGS()为函数、类、值类型、指针（包括原始指针和智能指针）、枚举和常量创建绑定，以及如何为可以在 JavaScript 中覆盖的抽象类创建绑定。

|版本声明：山河君，未经博主允许，禁止转载！

一、Embind

1.作用

Embind用于将 C++ 函数和类绑定到 JavaScript，以便编译后的代码可以被“正常”的 JavaScript 以自然的方式使用。Embind还支持从 C++ 调用 JavaScript 类。

Embind 支持绑定大多数 C++ 结构，包括 C++11 和 C++14 中引入的结构。它唯一重要的限制是它目前不支持具有复杂生命周期语义的原始指针。

2.使用介绍

1. 所有通过Embind暴露的symblols都可以在Module对象获取
2. 只绑定那些实际需要的项目，因为每次绑定都会增加代码大小
3. JavaScript，特别是 ECMA-262 版本 5.1，不支持终结器 或带有回调的弱引用。因此，Emscripten 无法自动调用 C++ 对象上的析构函数。
4. JavaScript 代码必须明确删除它收到的任何 C++ 对象句柄，否则 Emscripten 堆将无限增长。

3.使用步骤

1. 添加头文件#include <emscripten/bind.h>
2. 使用EMSCRIPTEN_BINDINGS()进行绑定，将关键方法进行映射，
3. 编译时加入--bind参数

二、绑定普通函数和类

1.不使用EMSCRIPTEN_BINDINGS()

在之前初步的使用WebAssebmly时，通常使用如下：

将方法强制为C接口，并加上宏EMSCRIPTEN_KEEPALIVE表明此方法需一直保留不被优化

#ifdef __cplusplus
extern "C" {
#endif

void EMSCRIPTEN_KEEPALIVE myFunction(void) {
  printf("我的函数已被调用\n");
}

#ifdef __cplusplus
}
#endif

在调用的时候，方法前必须要加上’_’

2.绑定普通函数

接下来看一个简单的例子

#include <emscripten/emscripten.h>
#include <emscripten/bind.h>

using namespace emscripten;

float compareBig(int a, int b) {
        return a > b ? a : b;
    }

EMSCRIPTEN_BINDINGS(my_module) {
    function("compareBig", &compareBig);
}

使用命令

emcc --bind -o quick_example.js quick_example.cpp

此时，就可以用Module进行直接调用

3.绑定类

class MyClass {
public:
  MyClass(int num){ m_num = num; };

  void CompareBig(int x, int y)
  {
	  printf("Big one is %d\n", x > y ? x : y);
  }

  static int getNum(const MyClass& instance) {
    return instance.printfNum;
  }

private:
  int printfNum()
  {
	  return m_num;
  }

private:
	int m_num;
};

// Binding code
EMSCRIPTEN_BINDINGS(my_class_example) {
  class_<MyClass>("MyClass")
    .constructor<int>() //构造函数
    .function("CompareBig", &MyClass::CompareBig) //普通类成员函数
    .class_function("getNum", &MyClass::getNum) //静态类成员函数
    ;
}

使用后记得需要释放：instance.delete()

4.绑定属性

假如上个例子里面打算直接给m_num赋值，而它本身又是一个私有变量，我们可以直接设置属性将其暴露

class MyClass {
public:
  MyClass(int num){ m_num = num; };

  void CompareBig(int x, int y)
  {
	  printf("Big one is %d\n", x > y ? x : y);
  }

  static int getNum(MyClass& instance) {
    return instance.printfNum();
  }

	int getNumValue() const
	{
		printf("getNumvalue:%d\n", m_num);
		return m_num;
	}

	void setNum(int num)
	{
		printf("setNum:%d\n", num);
		m_num = num;
	}

private:
  int printfNum()
  {
	  return m_num;
  }

private:
	int m_num;
};

// Binding code
EMSCRIPTEN_BINDINGS(my_class_example) {
  class_<MyClass>("MyClass")
    .constructor<int>() //构造函数
    .function("CompareBig", &MyClass::CompareBig) //普通类成员函数
	.property("m_num", &MyClass::getNumValue, &MyClass::setNum)
    .class_function("getNum", &MyClass::getNum) //静态类成员函数
    ;
}

三、绑定