.\" This manpage is Copyright (C) 2016 MongoDB, Inc.
.\" 
.\" Permission is granted to copy, distribute and/or modify this document
.\" under the terms of the GNU Free Documentation License, Version 1.3
.\" or any later version published by the Free Software Foundation;
.\" with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
.\" A copy of the license is included in the section entitled "GNU
.\" Free Documentation License".
.\" 
.TH "BSON_NEW_FROM_DATA" "3" "2016\(hy10\(hy12" "libbson"
.SH NAME
bson_new_from_data() \- The bson_new_from_data() function shall create a new bson_t on the heap and copy the contents of data. This may be helpful when working with language bindings but is generally expected to be slower.
.SH "SYNOPSIS"

.nf
.nf
bson_t *
bson_new_from_data (const uint8_t *data,
                    size_t         length);
.fi
.fi

.SH "PARAMETERS"

.TP
.B
data
A BSON encoded document buffer.
.LP
.TP
.B
length
The length of
.B data
in bytes.
.LP

.SH "DESCRIPTION"

The
.B bson_new_from_data(3)
function shall create a new
.B bson_t
on the heap and copy the contents of
.B data
. This may be helpful when working with language bindings but is generally expected to be slower.

.SH "RETURNS"

A newly allocated
.B bson_t
if successful, otherwise NULL.


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