.\" Man page generated from reStructuredText.
.
.TH "MONGOC_CURSOR_NEXT" "3" "Jun 04, 2021" "1.17.6" "libmongoc"
.SH NAME
mongoc_cursor_next \- mongoc_cursor_next()
.
.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_next (mongoc_cursor_t *cursor, const bson_t **bson);
.ft P
.fi
.UNINDENT
.UNINDENT
.SH PARAMETERS
.INDENT 0.0
.IP \(bu 2
\fBcursor\fP: A \fBmongoc_cursor_t\fP\&.
.IP \(bu 2
\fBbson\fP: A location for a \fI\%bson_t\fP\&.
.UNINDENT
.SH DESCRIPTION
.sp
This function shall iterate the underlying cursor, setting \fBbson\fP to the next document.
.sp
This function is a blocking function.
.SH RETURNS
.sp
This function returns true if a valid bson document was read from the cursor. Otherwise, false if there was an error or the cursor was exhausted.
.sp
Errors can be determined with the \fBmongoc_cursor_error()\fP function.
.SH LIFECYCLE
.sp
The bson objects set in this function are ephemeral and good until the next call. This means that you must copy the returned bson if you wish to retain it beyond the lifetime of a single call to \fBmongoc_cursor_next()\fP\&.
.SH AUTHOR
MongoDB, Inc
.SH COPYRIGHT
2017-present, MongoDB, Inc
.\" Generated by docutils manpage writer.
.