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

FreeBSD Manual Pages

  
 
  

home | help
MONGOC_COLLECTION_DELETE_MANY(3)   libmongoc  MONGOC_COLLECTION_DELETE_MANY(3)

SYNOPSIS
	  bool
	  mongoc_collection_delete_many	(mongoc_collection_t *collection,
					 const bson_t *selector,
					 const bson_t *opts,
					 bson_t	*reply,
					 bson_error_t *error);

PARAMETERS
        collection: A mongoc_collection_t.

        selector: A bson_t containing the query to match documents.

        reply:	 A  maybe-NULL pointer to overwritable storage for a bson_t to
	 contain the results.

        error:	An optional location for a bson_error_t	or NULL.

       opts may	be NULL	or a BSON document with	additional command options:

        writeConcern:	 Construct   a	  mongoc_write_concern_t    and	   use
	 mongoc_write_concern_append()	to  add	the write concern to opts. See
	 the example code for mongoc_client_write_command_with_opts().

        sessionId:   First,   construct   a   mongoc_client_session_t	  with
	 mongoc_client_start_session().	 You  can  begin  a  transaction  with
	 mongoc_client_session_start_transaction(),    optionally    with    a
	 mongoc_transaction_opt_t  that	 overrides  the	options	inherited from
	 collection, and use mongoc_client_session_append() to add the session
	 to opts. See the example code for mongoc_client_session_t.

        validate:    Construct	   a	 bitwise-or	of     all     desired
	 bson_validate_flags_t.	Set to false to	skip client-side validation of
	 the provided BSON documents.

        comment: A bson_value_t specifying the	comment	to attach to this com-
	 mand.	The  comment will appear in log	messages, profiler output, and
	 currentOp output. Requires MongoDB 4.4	or later.

        collation: Configure textual comparisons. See Setting	Collation  Or-
	 der,  and  the	 MongoDB Manual	entry on Collation. Collation requires
	 MongoDB 3.2 or	later, otherwise an error is returned.

        hint: A document or string that specifies the index to	use to support
	 the query predicate.

        let: A	BSON document consisting of any	 number	 of  parameter	names,
	 each  followed	 by  definitions of constants in the MQL Aggregate Ex-
	 pression language.

DESCRIPTION
       This function removes all documents in the given	collection that	 match
       selector.

       To     delete	 at	most	 one	 matching     document,	   use
       mongoc_collection_delete_one().

       If you pass a non-NULL reply, it	is filled out with the field "deleted-
       Count". If there	is  a  server  error  then  reply  contains  either  a
       "writeErrors"  array with one subdocument or a "writeConcernErrors" ar-
       ray. The	reply must be freed with bson_destroy().

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.

AUTHOR
       MongoDB,	Inc

COPYRIGHT
       2009-present, MongoDB, Inc.

1.30.2				 Apr 12, 2025 MONGOC_COLLECTION_DELETE_MANY(3)

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

home | help