Boost C++ Libraries

...one of the most highly regarded and expertly designed C++ library projects in the world. — Herb Sutter and Andrei Alexandrescu, C++ Coding Standards

execution_state

Holds state for multi-function SQL execution operations (dynamic interface).

Synopsis

Defined in header <boost/mysql/execution_state.hpp>

class execution_state

Member Functions

Name	Description
affected_rows	Returns the number of rows affected by the SQL statement associated to this resultset.
complete	Returns whether all the messages generated by this operation have been read.
execution_state [constructor]	Default constructor. — Copy constructor. — Move constructor.
info	Returns additional text information about this resultset.
is_out_params	Returns whether the current resultset represents a procedure OUT params.
last_insert_id	Returns the last insert ID produced by the SQL statement associated to this resultset.
meta	Returns metadata about the columns in the query.
operator=	Copy assignment. — Move assignment.
should_read_head	Returns whether the next operation should be read resultset head.
should_read_rows	Returns whether the next operation should be read some rows.
should_start_op	Returns whether `*this` is in the initial state.
warning_count	Returns the number of warnings produced by the SQL statement associated to this resultset.

Description

This class behaves like a state machine. The current state can be accessed using should_start_op, should_read_rows, should_read_head and complete. They are mutually exclusive. More states may be added in the future as more protocol features are implemented.

Thread safety

Distinct objects: safe.

Shared objects: unsafe.