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

  
 
  

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 generated
     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 document. 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 in-
     valid 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.8				  Aug 27, 2026	     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+15.1.quarterly>

home | help