2.5 EM_ASM系列宏-C/C++面向WebAssembly编程

C/C++面向WebAssembly编程

2.5 EM_ASM系列宏

很多编译器支持在C/C代码直接嵌入汇编代码，Emscripten采用类似的方式，提供了一组以“EM_ASM”为前缀的宏，用于以内联的方式在C/C代码中直接嵌入JavaScript代码。

2.5.1 `EM_ASM`

EM_ASM使用很简单，只需要将欲执行的JavaScript代码置于参数中，例如：

#include <emscripten.h>

int main() {
	EM_ASM(console.log('你好，Emscripten！'));
	return 0;
}

上述代码将调用JavaScript方法console.log()输出“你好，Emscripten！”。

EM_ASM宏可以一次嵌入多条JavaScript语句，语句之间用分号分隔，例如：

    EM_ASM(var k = 42;console.log('The answer is:', k););

将输出：

The answer is:42

嵌入的多条语句分行书写以及行尾注释也是可行的（分行书写时语句之间必须以分号分隔，不能省略），例如：

	EM_ASM(
		var k = 42;  //define k
		console.log('The answer is:', k);
	);

EM_ASM宏只能执行嵌入的JavaScript代码, 无法传入参数或获取返回结果。

2.5.2 `EM_ASM_`/`EM_ASM_DOUBLE`

EM_ASM_支持输入数值类型的可变参数, 同时返回整数类型的结果。EM_ASM_宏嵌入的JavaScript代码必须放到{}包围的代码块中（以区隔代码与参数），且至少必须含有一个输入参数。嵌入的JavaScript代码通过$n访问第n+1个参数。下面的例子调用JavaScript计算了三个数值的和，并将结果返回：

	int sum = EM_ASM_({return $0 + $1 + $2;}, 1, 2, 3);
	printf("sum(1, 2, 3): %d\n", sum);

使用EM_ASM_宏嵌入JavaScript时，参数不仅可以是常数，也可以是变量，例如：

	char buf[32];
	double pi = 3.14159;
	EM_ASM_(
		{
			console.log('addr of buf:', $0);
			console.log('sqrt(pi):', $1);
		},
		buf, sqrt(pi)
	);

上述代码将依次输出buf的地址以及pi的平方根。

EM_ASM_DOUBLE用法与EM_ASM_基本一致，区别是EM_ASM_DOUBLE返回值为double。例如：

	double pi2 = EM_ASM_DOUBLE(
		{
			return $0 * $1;
		},
		pi, 2.0
	);
	printf("pi2: %lf\n", pi2);

EM_ASM_/EM_ASM_DOUBLE宏中嵌入的JavaScript代码会被展开为一个独立的JavaScript方法，因此在嵌入的JavaScript中除了用$n之外，也可以用内置的arguments对象来访问参数，例如：

	EM_ASM_(
		{
			console.log('arguments count:', arguments.length);
			for(var i = 0; i < arguments.length; i++) {
				console.log('$', i, ':', arguments[i]);
			}
		},
		42, 13
	);

上述代码将输出：

arguments count: 2
$ 0 : 42
$ 1 : 13

2.5.3 `EM_ASM_INT_V`/`EM_ASM_DOUBLE_V`

如果嵌入的JavaScript代码不需要参数，可以使用EM_ASM_INT_V/EM_ASM_DOUBLE_V宏。由于没有参数，嵌入的代码无需用{}包围，例如：

	int answer = EM_ASM_INT_V(return 42);
	printf("The answer is:%d\n", answer);
	double pi_js = EM_ASM_DOUBLE_V(return 3.14159);
	printf("PI:%lf\n", pi_js);

本节例子的输出如下：

C/C++面向WebAssembly编程