# bson_sized_new()

## Synopsis

    bson_t *
    bson_sized_new (size_t size);

## Parameters

size | The size to pre-allocate for the underlying buffer.

## Description

The bson_sized_new() function shall create a new bson_t on the heap with a preallocated buffer. This is useful if you have a good idea of the size of the resulting document.

## Returns

A newly allocated bson_t that should be freed with bson_destroy().