.\" Man page generated from reStructuredText.
.
.TH "MONGOC_CURSOR_SET_HINT" "3" "Jun 04, 2021" "1.17.6" "libmongoc"
.SH NAME
mongoc_cursor_set_hint \- mongoc_cursor_set_hint()
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.SH SYNOPSIS
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
bool
mongoc_cursor_set_hint (mongoc_cursor_t *cursor, uint32_t server_id);
.ft P
.fi
.UNINDENT
.UNINDENT
.SH PARAMETERS
.INDENT 0.0
.IP \(bu 2
\fBcursor\fP: A \fBmongoc_cursor_t\fP\&.
.IP \(bu 2
\fBserver_id\fP: An opaque id identifying the server to use.
.UNINDENT
.SH DESCRIPTION
.sp
Specifies which server to use for the operation. This function has an effect only if called before the find operation is executed.
.sp
(The function name includes the old term "hint" for the sake of backward compatibility, but we now call this number a "server id".)
.sp
Use \fBmongoc_cursor_set_hint\fP 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\(aqs read preference.
.SH RETURNS
.sp
Returns true on success. If any arguments are invalid, returns false and logs an error.
.SH AUTHOR
MongoDB, Inc
.SH COPYRIGHT
2017-present, MongoDB, Inc
.\" Generated by docutils manpage writer.
.