.\" Man page generated from reStructuredText. . .TH "BSON_STRING_NEW" "3" "Jun 04, 2021" "1.17.6" "libbson" .SH NAME bson_string_new \- bson_string_new() . .nr rst2man-indent-level 0 . .de1 rstReportMargin \\$1 \\n[an-margin] level \\n[rst2man-indent-level] level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] - \\n[rst2man-indent0] \\n[rst2man-indent1] \\n[rst2man-indent2] .. .de1 INDENT .\" .rstReportMargin pre: . RS \\$1 . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin] . nr rst2man-indent-level +1 .\" .rstReportMargin post: .. .de UNINDENT . RE .\" indent \\n[an-margin] .\" old: \\n[rst2man-indent\\n[rst2man-indent-level]] .nr rst2man-indent-level -1 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. .SH SYNOPSIS .INDENT 0.0 .INDENT 3.5 .sp .nf .ft C bson_string_t * bson_string_new (const char *str); .ft P .fi .UNINDENT .UNINDENT .SH PARAMETERS .INDENT 0.0 .IP \(bu 2 \fBstr\fP: A string to be copied or NULL. .UNINDENT .SH DESCRIPTION .sp Creates a new string builder, which uses power\-of\-two growth of buffers. Use the various bson_string_append*() functions to append to the string. .SH RETURNS .sp A newly allocated bson_string_t that should be freed with bson_string_free() when no longer in use. .SH AUTHOR MongoDB, Inc .SH COPYRIGHT 2017-present, MongoDB, Inc .\" Generated by docutils manpage writer. .