MySQL Connector/C++
MySQL connector library for C and C++ applications
|
Result of an operation that returns documents. More...
Public Member Functions | |
DbDoc | fetchOne () |
Return the current document and move to the next one in the sequence. More... | |
DocList | fetchAll () |
Return all remaining documents. More... | |
uint64_t | count () |
Returns the number of documents contained in the result. More... | |
Result of an operation that returns documents.
A DocResult
object gives sequential access to the documents contained in the result. It is possible to get the documents one-by-one, or fetch and store all of them at once. One can iterate over the documents using range loop: for (DbDoc d : result) ...
.
DocResult
object should be used by at most one thread at a time. It is not safe to call its methods by several threads simultaneously. It is responsibility of the user to ensure this using a synchronization mechanism such as mutexes.
|
inline |
Return the current document and move to the next one in the sequence.
If there are no more documents in this result, returns a null document.
|
inline |
Return all remaining documents.
Result of this method can be stored in a container such as std::list<DbDoc>
. Documents that have already been fetched using fetchOne()
are not included in the result of fetchAll()
.
|
inline |
Returns the number of documents contained in the result.
The method counts only the documents that were not yet fetched and are still available in the result.