table of contents
BSON_READER_READ(3) | Library Functions Manual | BSON_READER_READ(3) |
NAME¶
bson_reader_read() - The bson_reader_read() function shall read the next document from the underlying file-descriptor or buffer.SYNOPSIS¶
const bson_t * bson_reader_read (bson_reader_t *reader, bool *reached_eof);
PARAMETERS¶
- reader
- A bson_reader_t
- reached_eof
- A UNKNOWN.
DESCRIPTION¶
The bson_reader_read(3) function shall read the next document from the underlying file‐descriptor or buffer.If there are no further documents or a failure was detected, then NULL is returned.
If we reached the end of the sequence, reached_eof is set to true.
To detect an error, check for NULL and reached_of is false.
RETURNS¶
A bson_t that should not be modified or freed.EXAMPLE¶
const bson_t *doc; bool reached_eof = false; while ((doc = bson_reader_read (reader, &reached_eof))) { /* do something */ } if (!reached_eof) { fprintf (stderr, "Failed to read all documents.\n"); }
COLOPHON¶
This page is part of libbson. Please report any bugs at https://jira.mongodb.org/browse/CDRIVER.2016‐10‐12 | libbson |