4
* Copyright (C) 2009 Tim Marston <edam@waxworlds.org>
4
* Copyright (C) 2009 Tim Marston <tim@ed.am>
6
6
* This file is part of sqlite3cc (hereafter referred to as "this program").
7
* See http://www.waxworlds.org/edam/software/sqlite3cc for more information.
9
* This program is free software: you can redistribute it and/or modify
10
* it under the terms of the GNU Lesser General Public License as published
11
* by the Free Software Foundation, either version 3 of the License, or
12
* (at your option) any later version.
14
* This program is distributed in the hope that it will be useful,
15
* but WITHOUT ANY WARRANTY; without even the implied warranty of
16
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17
* GNU Lesser General Public License for more details.
7
* See http://ed.am/dev/sqlite3cc for more information.
9
* This program is free software: you can redistribute it and/or modify it under
10
* the terms of the GNU Lesser General Public License as published by the Free
11
* Software Foundation, either version 3 of the License, or (at your option) any
14
* This program is distributed in the hope that it will be useful, but WITHOUT
15
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
16
* FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more
19
19
* You should have received a copy of the GNU Lesser General Public License
20
20
* along with this program. If not, see <http://www.gnu.org/licenses/>.
23
#ifndef SQLITE3CC_DATABASE_H_
24
#define SQLITE3CC_DATABASE_H_
23
#ifndef SQLITE3CC_CONNECTION_H_
24
#define SQLITE3CC_CONNECTION_H_
27
27
#include <sqlite3.h>
28
28
#include <boost/utility.hpp>
35
class basic_statement;
37
class basic_statement;
38
class basic_transaction;
41
44
private boost::noncopyable
43
46
//______________________________________________________________________________
51
* Class to provide a scope lock for the connection mutex
58
* Constructor that provides a connection upon which to act.
60
* @param connection reference to a connection
61
* @see sqlite3_db_mutex()
62
* @see sqlite3_mutex_enter()
65
connection &connection );
70
* Release the mutex early.
72
* @see sqlite3_mutex_leave()
77
sqlite3_mutex *_mutex;
80
//______________________________________________________________________________
48
85
* Constructor that specifies the filename of a database to open.
49
87
* @param filename the filename of the database file to open
50
88
* @throws database_error on error
53
91
const std::string &filename );
56
virtual ~database() throw( );
93
explicit connection();
94
virtual ~connection();
58
96
//______________________________________________________________________________
59
97
// public interface
74
113
* Close an open database.
75
115
* @throws database_error on error
76
116
* @see sqlite3_close()
81
* Execute an SQL statement.
121
* Execute an SQL statement. An exception is thrown on error.
82
123
* @param sql an SQL statement in UTF-8
83
* @return an sqlite error code
84
124
* @see sqlite3_exc()
87
127
const std::string &sql );
90
* Sets a default busy handler which will
91
* wait for the specified number of milliseconds.
92
* @param milliseconds number of milliseconds to wait
130
* Sets a default busy handler which will wait for the specified number of
133
* @param duration number of milliseconds to wait
93
134
* @returns an sqlite error code
94
135
* @see sqlite3_busy_timeout()