What It Is

    MySQL++ is a C++ wrapper for MySQL's C API.  It is built around STL
    principles, to make dealing with the database as easy as dealing
    with an STL container.  MySQL++ relieves the programmer of dealing
    with cumbersome C data structures, generation of repetitive SQL
    statements, and manual creation of C++ data structures to mirror
    the database schema.

    Its home page is http://tangentsoft.net/mysql++/

Prerequisites

To build MySQL++, you must have the MySQL C API development
files installed.

On Unixy systems (Linux, Mac OS X, Cygwin, *BSD, Solaris...),
the MySQL development files are installed if you build MySQL
from source.  If you installed MySQL as a binary package, then
the development files are often packaged separately from the
MySQL server itself.  It's common for the package containing the
development files to be called something like "MySQL-devel".

If you're building on Windows with Visual C++ or MinGW, you
need to install the native Win32 port of MySQL from mysql.com.
The development files are only included with the "complete"
version of the MySQL installer, and some versions of this
installer won't actually install them unless you do a custom
install.  Another pitfall is that MySQL++'s project files assume
that you've installed the current General Availability release of
MySQL (v5.0 right now) and it's installed in the default location.
If you've installed a different version, or if MySQL Inc. changes
the default location (which they seem to do regularly!) you'll have
to adjust the link and include file paths in the project settings.

Additional Things to Read

    Each major platform we support has a dedicated README-*.txt
    file for it containing information specific to that platform.
    Please read it.

    For authorship information, see the CREDITS.txt file.

    For license information, see the COPYING.txt file.

    If you want to change MySQL++, see the HACKERS.txt file.

    You should have received a user manual and a reference manual
    with MySQL++.  If not, you can read a recent version online:

        http://tangentsoft.net/mysql++/doc/

    Search the MySQL++ mailing list archives if you have more
    questions:

        http://lists.mysql.com/plusplus/

Building the Library

MySQL++ uses Bakefile (http://bakefile.org/) to generate
platform-specific project files and makefiles from a single set
of input files.  We currently support these build systems:

autoconf:
    For Unixy platforms, including Linux, Mac OS X, and Cygwin, in
    addition to the "real" Unices.  See README-Unix.txt for general
    instructions.  Supplementary platform-specific details are
    in README-Cygwin.txt, README-Linux.txt, README-Mac-OS-X.txt,
    and README-Solaris.txt.

MinGW:
    We ship Makefile.mingw for MinGW.  It currently only builds the
    static version of the library for technical reasons.  This has
    licensing ramifications.  See README-MinGW.txt for details.

Visual C++:
    We ship Visual Studio 2003, 2005, and 2008 project files.
    No older version of Visual C++ will build MySQL++, due to
    compiler limitations.  See README-Visual-C++.txt for more
    details.

Xcode:
    We ship an Xcode v2 project file.  It hasn't been tested
    much yet, since the autoconf method works just fine on OS X.
    As a result, we need both success and failure reports on the
    mailing list.  See README-Mac-OS-X.txt for more information.

Example Programs

    You may want to try out the programs in the examples subdirectory
    to ensure that the MySQL++ API and your MySQL database are both
    working properly.  Also, these examples give many examples of
    the proper use of MySQL++.  See README-examples.txt for further
    details.

Unsupported Compliers

If you're on Windows but want to use some other compiler besides
Visual C++ or GCC, you are currently on your own.  There have
been past efforts to port MySQL++ to other Windows compilers,
but for one reason or another, all of these ports have died.

On Unixy systems, GCC still works best.  "Native" compilers and
third-party compilers may work, but you're on your own to get
it working.

We have nothing in particular against these unsupported systems.
We just lack the time and resources to support everything
ourselves.  If you are sufficiently motivated to get MySQL++
working on one of these alternate systems, see the HACKERS.txt
file first for guidance.  If you follow the advice in that file,
your patch will be more likely to be accepted.

If You Want to Hack on MySQL++...

    If you intend to change the library or example code, please read
    the HACKERS.txt file.

    If you want to change the user manual, read doc/userman/README.txt

    If you want to change the reference manual, see the Doxygen manual:
    http://www.stack.nl/~dimitri/doxygen/manual.html