# 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`
