NAME

       bson_sized_new()  -  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.

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(3)  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(3) \&.

COLOPHON

       This    page    is    part    of    libbson.     Please     report     any     bugs     at
       https://jira.mongodb.org/browse/CDRIVER.