Scroll to navigation

MONGOC_CLIENT_SET_READ_PREFS(3) libmongoc MONGOC_CLIENT_SET_READ_PREFS(3)

SYNOPSIS

void
mongoc_client_set_read_prefs (mongoc_client_t *client,

const mongoc_read_prefs_t *read_prefs);


Sets the default read preferences to use with future operations upon client.

The global default is to read from the replica set primary.

It is a programming error to call this function on a client from a mongoc_client_pool_t <>. For pooled clients, set the read preferences with the MongoDB URI <#mongoc-uri-t-read-prefs-options> instead.

Please see the MongoDB website for a description of Read Preferences <https://www.mongodb.com/docs/manual/core/read-preference/>.

PARAMETERS

  • client: A mongoc_client_t <>.
  • read_prefs: A mongoc_read_prefs_t <>.

Author

MongoDB, Inc

Copyright

2009-present, MongoDB, Inc.

November 26, 2025 2.2.0