#include <connection.h>
Inheritance diagram for mysqlpp::Connection:
Public Member Functions | |
| Connection (bool te=true) | |
| Create object without connecting to the database server. | |
| Connection (const char *db, const char *server=0, const char *user=0, const char *password=0, unsigned int port=0) | |
| Create object and connect to database server in one step. | |
| Connection (const Connection &other) | |
| Establish a new connection using the same parameters as an existing connection. | |
| virtual | ~Connection () |
| Destroy object. | |
| std::string | client_version () const |
| Get version of library underpinning the current database driver. | |
| virtual bool | connect (const char *db=0, const char *server=0, const char *user=0, const char *password=0, unsigned int port=0) |
| Connect to database after object is created. | |
| bool | connected () const |
| Returns true if connection was established successfully. | |
| ulonglong | count_rows (const std::string &table) |
| Returns the number of rows in a table. | |
| bool | create_db (const std::string &db) |
| Ask the database server to create a database. | |
| void | disconnect () |
| Drop the connection to the database server. | |
| DBDriver * | driver () |
| Returns a reference to the current database driver. | |
| bool | drop_db (const std::string &db) |
| Asks the database server to drop (destroy) a database. | |
| int | errnum () |
| Return last error number associated with this connection. | |
| const char * | error () const |
| Return error message for last error associated with this connection. | |
| std::string | ipc_info () const |
| Get information about the IPC connection to the database server. | |
| bool | kill (unsigned long tid) const |
| Kill a database server thread. | |
| operator private_bool_type () const | |
| Test whether any error has occurred within the object. | |
| Connection & | operator= (const Connection &rhs) |
| Copy an existing Connection object's state into this object. | |
| bool | ping () |
| "Pings" the database server | |
| int | protocol_version () const |
| Returns version number of the protocol the database driver uses to communicate with the server. | |
| Query | query (const char *qstr=0) |
| Return a new query object. | |
| Query | query (const std::string &qstr) |
| Return a new query object. | |
| bool | select_db (const std::string &db) |
| Change to a different database managed by the database server we are connected to. | |
| std::string | server_version () const |
| Get the database server's version string. | |
| bool | set_option (Option *o) |
| Sets a connection option. | |
| bool | shutdown () |
| Ask database server to shut down. | |
| std::string | server_status () const |
| Returns information about database server's status. | |
| unsigned long | thread_id () |
| Returns the database server's thread ID for this connection. | |
Static Public Member Functions | |
| static bool | thread_aware () |
| Returns true if both MySQL++ and database driver we're using were compiled with thread awareness. | |
| static void | thread_end () |
| Tells the underlying database driver that this thread is done using the library. | |
| static bool | thread_start () |
| Tells the underlying database driver that the current thread is now using its services. | |
Protected Member Functions | |
| void | build_error_message (const char *core) |
| Build an error message in the standard form used whenever one of the methods can't succeed because we're not connected to the database server. | |
| void | copy (const Connection &other) |
| Establish a new connection as a copy of an existing one. | |
| bool | parse_ipc_method (const char *server, std::string &host, unsigned int &port, std::string &socket_name) |
| Extract elements from the server parameter in formats suitable for passing to DBDriver::connect(). | |
Protected Attributes | |
| std::string | error_message_ |
| MySQL++ specific error, if any. | |
This class is a thick wrapper around DBDriver, adding high-level error handling, utility functions, and abstraction away from underlying C API details.
| mysqlpp::Connection::Connection | ( | bool | te = true |
) |
Create object without connecting to the database server.
| te | if true, exceptions are thrown on errors |
| mysqlpp::Connection::Connection | ( | const char * | db, | |
| const char * | server = 0, |
|||
| const char * | user = 0, |
|||
| const char * | password = 0, |
|||
| unsigned int | port = 0 | |||
| ) |
Create object and connect to database server in one step.
This constructor allows you to most fully specify the options used when connecting to the database server.
| db | name of database to select upon connection | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for contacting the server; see below> | |
| server | specifies the IPC method and parameters for conta |