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

This is the documentation for a snapshot of the develop branch, built from commit 029fa0d959.
PrevUpHomeNext

Introduction

Boost.MySQL is a C++11 client for the MySQL and MariaDB database servers, based on Boost.Asio.

Motivation

MySQL and MariaDB are widespread SQL database servers. MySQL clients connect to the server in order to issue SQL queries. For this purpose, MySQL employs a dedicated protocol. Boost.MySQL is an implementation of the client side of this protocol.

This library is a full implementation of the MySQL client/server protocol. It aims to expose the protocol primitives in an efficient but easy-to-use way. It is similar in scope to the official libmysqlclient, but interoperable with Asio, safer and more expressive. Note that Boost.MySQL does not use libmysqlclient: it's a full implementation of the MySQL protocol, which makes it natively compatible with Asio.

This library is relatively low level. It gives you access to text SQL queries and prepared statements. Don't expect an ORM. This section presents a quick tour over the main library capabilities.

The design goals of this library are:

Non-goals:

When to use

If any of the following statements is true, you may consider using Boost.MySQL:

Use cases may include web servers, ETL processes and IoT systems.

It may not be a good fit for you if:

Tested compilers and systems

Boost.MySQL is tested under the following compilers:

And with the following RDBMS systems:

Acknowledgements

I would like to specially acknowledge Richard Hodges (hodges.r@gmail.com) for his invaluable technical guidance during development. Thanks also to Christian Mazakas for his ideas in early stages, and to Klemens Morgenstern and and Vinnie Falco for his techincal advice. Without you, this library would not exist.

Finally, thanks to Christopher Kohlhoff for his awesome Boost.Asio library, and to Howard Hinnant for his date algorithms, shamelessly copied in this lib.


PrevUpHomeNext