array-buffers

0.0.12 • Public • Published

array-buffers

Treat a collection of ArrayBuffers as a single contiguous ArrayBuffer.

browser support

build status

This module is a clone of buffers. It uses the same API but works with ArrayBuffers, only. It is supposed to be used in browsers and bundled using browserify.

There's nothing wrong with using it for ArrayBuffers in node as well...

examples

slice

function createBuffer(elems) {
  var array = new Uint8Array(new ArrayBuffer(elems.length));
  elems.forEach(function (elem, i) { array[i] = elem });
  return array.buffer;
}

var ArrayBuffers = require("array-buffers");
var bufs = ArrayBuffers();
bufs.push(createBuffer([1,2,3]));
bufs.push(createBuffer([4,5,6,7]));
bufs.push(createBuffer([8,9,10]));

console.dir(bufs.slice(2,8));

output:

$ node examples/slice.js
<ArrayBuffer 03 04 05 06 07 08>

splice

function createBuffer(elems) {
  var array = new Uint8Array(new ArrayBuffer(elems.length));
  elems.forEach(function (elem, i) { array[i] = elem });
  return array.buffer;
}

var ArrayBuffers = require("array-buffers");
var bufs = ArrayBuffers();
bufs.push(createBuffer([1,2,3]));
bufs.push(createBuffer([4,5,6,7]));
bufs.push(createBuffer([8,9,10]));

var removed = bufs.splice(2, 4);
console.log(removed.slice());
console.log(bufs.slice());

output:

$ node examples/splice.js
<ArrayBuffer 03 04 05 06>
<ArrayBuffer 01 02 07 08 09 0a>

methods

ArrayBuffers(buffers)

Create an ArrayBuffers with an array of ArrayBuffers if specified, else [].

.push(buf1, buf2...)

Push buffers onto the end. Just like Array.prototype.push.

.unshift(buf1, buf2...)

Unshift buffers onto the head. Just like Array.prototype.unshift.

.slice(i, j)

Slice a range out of the buffer collection as if it were contiguous. Works just like the Array.prototype.slice version.

.splice(i, howMany, replacements)

Splice the buffer collection as if it were contiguous. Works just like Array.prototype.splice, even the replacement part!

.copy(dst, dstStart, start, end)

Copy the buffer collection as if it were contiguous to the dst ArrayBuffer with the specified bounds.

.get(i)

Get a single element at index i.

.set(i, x)

Set a single element's value at index i.

.indexOf(needle, offset)

Find a string or buffer needle inside the buffer collection. Returns the position of the search string or -1 if the search string was not found.

Provide an offset to skip that number of characters at the beginning of the search. This can be used to find additional matches.

This function will return the correct result even if the search string is spread out over multiple internal buffers.

.toBuffer()

Convert the buffer collection to a single buffer, equivalent with .slice(0, buffers.length)

.toString(encoding, start, end)

Decodes and returns a string from the buffer collection. Works just like Buffer.prototype.toString

install

With npm do:

npm install array-buffers

license

MIT

Readme

Keywords

none

Package Sidebar

Install

npm i array-buffers

Weekly Downloads

1

Version

0.0.12

License

MIT

Last publish

Collaborators

  • ttaubert