# SOCI - The C++ Database Access Library

SOCI is a database access library written in C++ that makes an illusion of embedding SQL queries in the regular C++ code, staying entirely within the Standard C++.

The idea is to provide C++ programmers a way to access SQL databases in the most natural and intuitive way. If you find existing libraries too difficult for your needs or just distracting, SOCI can be a good alternative.

## Basic Syntax

The simplest motivating code example for the SQL query that is supposed to retrieve a single row is:

    int id = ...;
    string name;
    int salary;

    sql << "select name, salary from persons where id = " << id,
            into(name), into(salary);

## Basic ORM

The following benefits from extensive support for object-relational mapping:

    int id = ...;
    Person p;

    sql << "select first_name, last_name, date_of_birth "
           "from persons where id = " << id, into(p);

## Integrations

Integration with STL is also supported:

    Rowset<string> rs = (sql.prepare << "select name from persons");
    std::copy(rs.begin(), rs.end(), std::ostream_iterator<std::string>(std::cout, "\n"));

SOCI offers also extensive integration with Boost datatypes (optional, tuple and fusion) and flexible support for user-defined datatypes.

## Database Backends

Starting from its 2.0.0 release, SOCI uses the plug-in architecture for backends - this allows to target various database servers.

Currently (SOCI 4.0.3), backends for following database systems are supported:

- DB2
- Firebird
- MySQL
- ODBC (generic backend)
- Oracle
- PostgreSQL
- SQLite3

The intent of the library is to cover as many database technologies as possible. For this, the project has to rely on volunteer contributions from other programmers, who have expertise with the existing database interfaces and would like to help writing dedicated backends.

## Language Bindings

Even though SOCI is mainly a C++ library, it also allows to use it from other programming languages. Currently the package contains the Ada binding, with more bindings likely to come in the future.

#### Search

From here you can search these documents. Enter your search terms below.

#### Keyboard Shortcuts

Keys | Action
--- | ---
`?` | Open this help
`n` | Next page
`p` | Previous page
`s` | Search