Scroll to navigation

MONGOC_CURSOR_SET_HINT(3) Library Functions Manual MONGOC_CURSOR_SET_HINT(3)

NAME

mongoc_cursor_set_hint() - Specifies which server to use for the operation. This function has an effect only if called before the find operation is executed.

SYNOPSIS



bool
mongoc_cursor_set_hint (mongoc_cursor_t *cursor,
                        uint32_t         server_id);

PARAMETERS

cursor
A mongoc_cursor_t
server_id
An opaque id identifying the server to use.

DESCRIPTION

Specifies which server to use for the operation. This function has an effect only if called before the find operation is executed.

(The function name includes the old term "hint" for the sake of backward compatibility, but we now call this number a "server id".)

Use mongoc_cursor_set_hint only for building a language driver that wraps the C Driver. When writing applications in C, leave the server id unset and allow the driver to choose a suitable server from the find operation's read preference.

RETURNS

true if successful, otherwise false and logs an error.

COLOPHON

This page is part of MongoDB C Driver. Please report any bugs at https://jira.mongodb.org/browse/CDRIVER.
2016‐10‐12 MongoDB C Driver