WebAssembly入门笔记[2]:如何通过Memory传递字节数据?
摘要:利用灵活的“导入”和“导出”机制,WebAssembly与承载的JavaScript应用之间可以很便利地“互通有无”。《与JavaScript的交互》着重演示了如何利用函数的导入和导出实现功能的共享,接下来我们主要关注数据的传递或者共享。宗
利用灵活的“导入”和“导出”机制,WebAssembly与承载的JavaScript应用之间可以很便利地“互通有无”。《与JavaScript的交互》着重演示了如何利用函数的导入和导出实现功能的共享,接下来我们主要关注数据的传递或者共享。宗地来说,WebAssembly与宿主程序之间的数据传递主要有如下三种手段,本篇文章主要关注Memory。源代码下载:app3app4
Memory:以二进制(字节)的形式传递数据;Table:传递类型化数据(目前只支持函数);Global:共享全局变量;一、导入Memory顾名思义,一个Memory映射一块连续的内存,应用以二进制(字节)的形式对它进行读写。Memory可以利用导入功能从宿主程序传递给WebAssembly,下面的实例演示了这样的场景:作为宿主的JavaScript应用创建一个Memory对象并写入相应的内容,然后将其导入到加载的WebAssembly模块,后者将其中的内容读出来。
如下所示的代码片段是承载WebAssembly程序的app.wat文件的内容,我们利用(memory)定义了一个导入的memory,导入路径为“imports.memory”,后面指定的参数1代表初始大小,单位为Page(64K)。接下来我们定义了四个导出函数,它们会从指定的位置(参数$index表示偏移量)读取相应长度的字节内容,并将其转换成对应的类型。具体来说,这四个函数的返回类型分别为i32、i64、f32和f64,也就是WebAssembly支持的四种数据类型。具体的读取通过执行{i32|i64|f32|f64}.load指令完成,该指令将读取位置作为唯一参数,所以我们在执行该指令之前需要执行local.get 指令将代表读取位置的$index参数压入栈中。
(module
(memory (import "imports" "memory") 1)
(func (export "readAsInt32") (param $index i32) (result i32)
local.get $index
i32.load
)
(func (export "readAsInt64") (param $index i32) (result i64)
local.get $index
i64.load
)
(func (export "readAsSingle") (param $index i32) (result f32)
local.get $index
f32.load
)
(func (export "readAsDouble") (param $index i32) (result f64)
local.get $index
f64.load
)
)有人可能有这样的疑问,我们在执行load指令的时候为什么没有指定具体读取的Memory对象呢?这是因为目前一个WebAssembly模块只能拥有一个Memory对象,这一限制可能会在后续版本中解除,针对多Memory的提案在两年前已经提出。
接下来我们依然需要执行“wat2wasm app.wat –o app.wasm”命令对app.wat文件进行编译,最终生成二进制的模块文件app.wasm。该文件在index.html页面的JavaScript脚本中被加载,index.html页面的内容如下所示。如下面的代码片段所示,我们调用构造函数WebAssembly.Memory创建了一个Memory对象,并将初始大小设置为1(Page)。我们将这个Memory对象的缓冲区(对应buffer属性)映射为一个Uint32Array数组。通过设置这个数组的前两个元素的值(123),我们相应的字节写入前8个字节。
