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

FreeBSD Manual Pages

  
 
  

home | help
MONGOC_COLLECT...COMMAND_SIMPLE(3) libmongocMONGOC_COLLECT...COMMAND_SIMPLE(3)

SYNOPSIS
	  bool
	  mongoc_collection_command_simple (mongoc_collection_t	*collection,
					    const bson_t *command,
					    const mongoc_read_prefs_t *read_prefs,
					    bson_t *reply,
					    bson_error_t *error);

PARAMETERS
        collection: A mongoc_collection_t.

        command: A bson_t containing the command to execute.

        read_prefs:  An  optional mongoc_read_prefs_t.	Otherwise, the command
	 uses mode MONGOC_READ_PRIMARY.

        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.

DESCRIPTION
       This  is	 a  simplified version of mongoc_collection_command() that re-
       turns the first result document in reply. The collection's read prefer-
       ence, read concern, and write concern are not applied to	 the  command.
       The parameter reply is initialized even upon failure to simplify	memory
       management.

       This  function  tries  to  unwrap an embedded error in the command when
       possible. The unwrapped error will be propagated	via the	error  parame-
       ter. Additionally, the result document is set in	reply.

       This function is	not considered a retryable read	operation.

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.

       This function does not check the	server response	for  a	write  concern
       error or	write concern timeout.

EXAMPLE
       The following is	an example of executing	the ping command.

	  #include <bson/bson.h>
	  #include <mongoc/mongoc.h>
	  #include <stdio.h>

	  static void
	  do_ping (mongoc_collection_t *collection)
	  {
	     bson_error_t error;
	     bson_t *cmd;
	     bson_t reply;
	     char *str;

	     cmd = BCON_NEW ("ping", BCON_INT32	(1));

	     if	(mongoc_collection_command_simple (collection, cmd, NULL, &reply, &error)) {
		str = bson_as_canonical_extended_json (&reply, NULL);
		printf ("Got reply: %s\n", str);
		bson_free (str);
	     } else {
		fprintf	(stderr, "Got error: %s\n", error.message);
	     }

	     bson_destroy (&reply);
	     bson_destroy (cmd);
	  }

AUTHOR
       MongoDB,	Inc

COPYRIGHT
       2009-present, MongoDB, Inc.

1.30.2				 Apr 12, 202MONGOC_COLLECT...COMMAND_SIMPLE(3)

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

home | help