MONGOC_COLLECTION_COMMAND_SIMPLE - Online Linux Manual PageSection : 3
Updated : Feb 04, 2021
Source : 1.17.4
Note : libmongoc
NAMEmongoc_collection_command_simple − mongoc_collection_command_simple()
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 location to initialize a bson_t. This should be on the stack. • error: An optional location for a bson_error_t or NULL.
DESCRIPTIONThis is a simplified version of mongoc_collection_command() that returns the first result document in reply. The collection's read preference, 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 parameter. Additionally, the result document is set in reply. This function is not considered a retryable read operation.
ERRORSErrors are propagated via the error parameter.
RETURNSReturns 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.
EXAMPLEThe following is an example of executing the collection stats command. #include <bson/bson.h>
#include <mongoc/mongoc.h>
#include <stdio.h>
static void
print_collection_stats (mongoc_collection_t *collection)
{
bson_error_t error;
const char *name;
bson_t *cmd;
bson_t reply;
name = mongoc_collection_get_name (collection);
cmd = BCON_NEW ("collStats", BCON_UTF8 (name));
if (mongoc_collection_command_simple (
collection, cmd, NULL, &reply, &error)) {
str = bson_as_canonical_extended_json (&reply, NULL);
printf ("%s\n", str);
bson_free (str);
} else {
fprintf (stderr, "%s\n", error.message);
}
bson_destroy (&reply);
bson_destroy (cmd);
}
AUTHORMongoDB, Inc
COPYRIGHT2017-present, MongoDB, Inc 0
Johanes Gumabo
Data Size : 11,061 byte
man-mongoc_collection_command_simple.3Build : 2024-12-05, 20:55 :
Visitor Screen : x
Visitor Counter ( page / site ) : 2 / 189,122
Visitor ID : :
Visitor IP : 3.15.225.188 :
Visitor Provider : AMAZON-02 :
Provider Position ( lat x lon ) : 39.962500 x -83.006100 : x
Provider Accuracy Radius ( km ) : 1000 :
Provider City : Columbus :
Provider Province : Ohio , : ,
Provider Country : United States :
Provider Continent : North America :
Visitor Recorder : Version :
Visitor Recorder : Library :
Online Linux Manual Page : Version : Online Linux Manual Page - Fedora.40 - march=x86-64 - mtune=generic - 24.12.05
Online Linux Manual Page : Library : lib_c - 24.10.03 - march=x86-64 - mtune=generic - Fedora.40
Online Linux Manual Page : Library : lib_m - 24.10.03 - march=x86-64 - mtune=generic - Fedora.40
Data Base : Version : Online Linux Manual Page Database - 24.04.13 - march=x86-64 - mtune=generic - fedora-38
Data Base : Library : lib_c - 23.02.07 - march=x86-64 - mtune=generic - fedora.36
Very long time ago, I have the best tutor, Wenzel Svojanovsky . If someone knows the email address of Wenzel Svojanovsky , please send an email to johanes_gumabo@yahoo.co.id .
If error, please print screen and send to johanes_gumabo@yahoo.co.id
Under development. Support me via PayPal.