buffers.md 2.07 KB

Buffers

NAN's node::Buffer helpers exist as the API has changed across supported Node versions. Use these methods to ensure compatibility.

Nan::NewBuffer()

Allocate a new node::Buffer object with the specified size and optional data. Calls node::Buffer::New().

Note that when creating a Buffer using Nan::NewBuffer() and an existing char*, it is assumed that the ownership of the pointer is being transferred to the new Buffer for management. When a node::Buffer instance is garbage collected and a FreeCallback has not been specified, data will be disposed of via a call to free(). You must not free the memory space manually once you have created a Buffer in this way.

Signature:

Nan::MaybeLocal<v8::Object> Nan::NewBuffer(uint32_t size)
Nan::MaybeLocal<v8::Object> Nan::NewBuffer(char* data, uint32_t size)
Nan::MaybeLocal<v8::Object> Nan::NewBuffer(char *data,
                                           size_t length,
                                           Nan::FreeCallback callback,
                                           void *hint)

Nan::CopyBuffer()

Similar to Nan::NewBuffer() except that an implicit memcpy will occur within Node. Calls node::Buffer::Copy().

Management of the char* is left to the user, you should manually free the memory space if necessary as the new Buffer will have its own copy.

Signature:

Nan::MaybeLocal<v8::Object> Nan::CopyBuffer(const char *data, uint32_t size)

Nan::FreeCallback()

A free callback that can be provided to Nan::NewBuffer(). The supplied callback will be invoked when the Buffer undergoes garbage collection.

Signature:

typedef void (*FreeCallback)(char *data, void *hint);