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

FreeBSD Manual Pages

  
 
  

home | help
MONGOC_COLLECTION_INSERT(3)	   libmongoc	   MONGOC_COLLECTION_INSERT(3)

SYNOPSIS
	  bool
	  mongoc_collection_insert (mongoc_collection_t	*collection,
				    mongoc_insert_flags_t flags,
				    const bson_t *document,
				    const mongoc_write_concern_t *write_concern,
				    bson_error_t *error);

PARAMETERS
        collection: A mongoc_collection_t.

        flags:	A mongoc_insert_flags_t.

        document: A bson_t.

        write_concern:	A mongoc_write_concern_t.

        error:	An optional location for a bson_error_t	or NULL.

DESCRIPTION
       NOTE:
	  To  pass  additional	options, use mongoc_collection_insert_one() or
	  mongoc_collection_insert_many().

       This function shall insert document into	collection.

       If no _id element is found in document, then a bson_oid_t will be  gen-
       erated locally and added	to the document. If you	must know the inserted
       document's  _id,	 generate  it in your code and include it in the docu-
       ment. The _id you generate can be a bson_oid_t or any  other  non-array
       BSON type.

ERRORS
       Errors are propagated via the error parameter.

RETURNS
       Returns	true  if successful. Returns false and sets error if there are
       invalid arguments or a server or	network	error.

       A write concern timeout or write	concern	error is considered a failure.

AUTHOR
       MongoDB,	Inc

COPYRIGHT
       2009-present, MongoDB, Inc.

1.30.2				 Apr 12, 2025	   MONGOC_COLLECTION_INSERT(3)

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

home | help