MySQL Connector/C++
MySQL connector library for C and C++ applications
Public Member Functions | List of all members

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...
 
unsigned getWarningsCount () const
 Get the number of warnings stored in the result.
 
WarningList getWarnings ()
 Get a list of warnings stored in the result.
 
Warning getWarning (unsigned pos)
 Get the warning at the given, 0-based position.
 
uint64_t getAffectedItemsCount () const
 Get the count of affected items (rows or doucuments) from manipulation statements.
 

Detailed Description

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) ....

Note
A 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.

Member Function Documentation

◆ fetchOne()

DbDoc fetchOne ( )
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.

◆ fetchAll()

DocList fetchAll ( )
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().

◆ count()

uint64_t count ( )
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.


The documentation for this class was generated from the following file: