Smalloc#

稳定度: 1 - 实验性

smalloc.alloc(length[, receiver][, type])#

• length {Number} <= smalloc.kMaxLength
• receiver {Object} 可选，缺省为 new Object
• type {Enum} 可选，缺省为 Uint8

返回 receiver 及所分配的外部数组数据。如果未传入 receiver 则会创建并返回一个新的 Object。

Buffer 后端为一个只处理外部原始内存的分配的简易分配器所支撑。Smalloc 暴露了该功能。

这可用于创建你自己的类似 Buffer 的类。由于不会设置其它属性，因此使用者需要自行跟踪其它所需信息（比如所分配的长度 length）。

SimpleData.prototype = { /* ... */ };

它只检查 receiver 是否为一个非 Array 的 Object。因此，可以分配外部数组数据的不止纯 Object。

// { [Function allocMe] '0': 0, '1': 0, '2': 0 }

V8 不支持向一个 Array 分配外部数组数据，如果这么做将会抛出异常。

您可以指定您想要的外部数组数据的类型。所有可取的值都已在 smalloc.Types 中列出。使用示例：

// { '0': 0, '1': 0.1, '2': 0.2 }

smalloc.copyOnto(source, sourceStart, dest, destStart, copyLength);#

• source 分配了外部数组的来源对象
• sourceStart 从这个位置开始拷贝
• dest 分配了外部数组的目标对象
• destStart 拷贝到这个位置
• copyLength 拷贝的长度

从一个外部数组向另一个拷贝内存。所有参数都是必填，否则将会抛出异常。

// { '0': 4, '1': 6, '2': 2, '3': 3 }

copyOnto 会在内部自动检测分配的长度，因此无需对此给出额外的参数。

smalloc.dispose(obj)#

• obj 对象

释放已使用 smalloc.alloc 分配到一个对象的内存。

// {}

这对于减轻垃圾回收器的负担有所帮助，但开发者务必小心。难以跟踪的应用程序可能会发生奇怪的错误。

// 将导致：
// Error: source has no external array data

dispose() 不支持 Buffer，传入将会抛出异常。

smalloc.kMaxLength#

最大的分配大小。该值同时也适用于 Buffer 的创建。

smalloc.Types#

外部数组类型的可取值，包含：

• Int8
• Uint8
• Int16
• Uint16
• Int32
• Uint32
• Float
• Double
• Uint8Clamped