Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
BSON_APPEND_DOCUMENT_BEGIN(3)	    libbson	 BSON_APPEND_DOCUMENT_BEGIN(3)

SYNOPSIS
	  #define BSON_APPEND_DOCUMENT_BEGIN(b,	key, child) \
	     bson_append_document_begin	(b, key, (int) strlen (key), child)

	  bool
	  bson_append_document_begin (bson_t *bson,
				      const char *key,
				      int key_length,
				      bson_t *child);

PARAMETERS
        bson: A bson_t.

        key: An ASCII C string	containing the name of the field.

        key_length: The length	of key in bytes, or -1 to determine the	length
	 with strlen().

        child:	An uninitialized bson_t	to be initialized as the sub-document.

DESCRIPTION
       The  bson_append_document_begin()  function  shall  begin  appending  a
       sub-document to bson. Use child to add fields to	the sub-document. When
       completed, call bson_append_document_end() to complete the element.

       child MUST be an	uninitialized bson_t to	avoid leaking memory.

RETURNS
       Returns true if the operation was applied  successfully.	 The  function
       will fail if bson must grow larger than INT32_MAX.

AUTHOR
       MongoDB,	Inc

COPYRIGHT
       2009-present, MongoDB, Inc.

1.30.2				 Apr 12, 2025	 BSON_APPEND_DOCUMENT_BEGIN(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=bson_append_document_begin&sektion=3&manpath=FreeBSD+Ports+14.3.quarterly>

home | help