4
* Copyright (C) 2009 Tim Marston <tim@ed.am>
4
* Copyright (C) 2009 Tim Marston <edam@waxworlds.org>
6
6
* This file is part of sqlite3cc (hereafter referred to as "this program").
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
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.
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_CONNECTION_H_
24
#define SQLITE3CC_CONNECTION_H_
23
#ifndef SQLITE3CC_DATABASE_H_
24
#define SQLITE3CC_DATABASE_H_
27
27
#include <sqlite3.h>
28
28
#include <boost/utility.hpp>
37
class basic_statement;
38
class basic_transaction;
35
class basic_statement;
44
41
private boost::noncopyable
46
43
//______________________________________________________________________________
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
//______________________________________________________________________________
85
48
* Constructor that specifies the filename of a database to open.
87
49
* @param filename the filename of the database file to open
88
50
* @throws database_error on error
91
53
const std::string &filename );
93
explicit connection();
94
virtual ~connection();
56
virtual ~database() throw( );
96
58
//______________________________________________________________________________
97
59
// public interface
113
74
* Close an open database.
115
75
* @throws database_error on error
116
76
* @see sqlite3_close()
121
* Execute an SQL statement. An exception is thrown on error.
81
* Execute an SQL statement.
123
82
* @param sql an SQL statement in UTF-8
83
* @return an sqlite error code
124
84
* @see sqlite3_exc()
127
87
const std::string &sql );
130
* Sets a default busy handler which will wait for the specified number of
133
* @param duration number of milliseconds to wait
90
* Sets a default busy handler which will
91
* wait for the specified number of milliseconds.
92
* @param milliseconds number of milliseconds to wait
134
93
* @returns an sqlite error code
135
94
* @see sqlite3_busy_timeout()
141
100
// implementation
144
friend class detail::basic_statement;
145
friend class detail::basic_transaction;
103
friend class basic_statement;
146
104
friend class command;
147
friend class sqlite_error;
105
friend class transaction;
149
/** the connection handle */
107
/** the database handle */
150
108
sqlite3 *_handle;