From 4c89c60867591b50e0b31bf5009fd5ad6a3cebe1 Mon Sep 17 00:00:00 2001 From: Colin McDonnell Date: Wed, 26 Jul 2023 14:59:39 -0700 Subject: Add files (#3826) --- docs/guides/binary/arraybuffer-to-buffer.md | 25 +++++++++++++++++++++++++ 1 file changed, 25 insertions(+) create mode 100644 docs/guides/binary/arraybuffer-to-buffer.md (limited to 'docs/guides/binary/arraybuffer-to-buffer.md') diff --git a/docs/guides/binary/arraybuffer-to-buffer.md b/docs/guides/binary/arraybuffer-to-buffer.md new file mode 100644 index 000000000..2737ebb4e --- /dev/null +++ b/docs/guides/binary/arraybuffer-to-buffer.md @@ -0,0 +1,25 @@ +--- +name: Convert an ArrayBuffer to a Uint8Array +--- + +The Node.js [`Buffer`](https://nodejs.org/api/buffer.html) API predates the introduction of `ArrayBuffer` into the JavaScript language. Bun implements both. + +Use the static `Buffer.from()` method to create a `Buffer` from an `ArrayBuffer`. + +```ts +const arrBuffer = new ArrayBuffer(64); +const nodeBuffer = Buffer.from(arrBuffer); +``` + +--- + +To create a `Buffer` that only views a portion of the underlying buffer, pass the offset and length to the constructor. + +```ts +const arrBuffer = new ArrayBuffer(64); +const nodeBuffer = Buffer.from(arrBuffer, 0, 16); // view first 16 bytes +``` + +--- + +See [Docs > API > Binary Data](/docs/api/binary-data#conversion) for complete documentation on manipulating binary data with Bun. -- cgit v1.2.3