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/>.
24
24
#define SQLITE3CC_MANIPULATOR_H_
36
// types to represent special manipulators for use with stream operators
39
struct set_index_t { unsigned int _index; };
40
struct blob_t { const char *value; unsigned int value_length; };
33
struct _set_index_t { unsigned int _index; };
45
* Stream manipulator. When used with a statment's stream operator, this
46
* specifies a NULL value to bind to a parameter. When used with a row's stream
37
* Stream manipulator. When used with a statment's stream operator, this
38
* specifies a NULL value to bind to a parameter. When used with a row's stream
47
39
* operator, no value is fetched for a column.
49
extern detail::null_t null;
52
* Stream manipulator. When used with a statment's stream operator, this
53
* indicates that the statement should be executed immediately. Unlike a
54
* statment's exec() method, this will throw on error. Also, it will throw if
55
* the execution returns any result rows. When used with a query's stream
44
* Stream manipulator. When used with a statment's stream operator, this
45
* indicates that the statement should be executed immediately. Unlike a
46
* statment's exec() method, this will throw on error. Also, it will throw if
47
* the execution returns any result rows. When used with a query's stream
56
48
* operator, behaviour is the same except that it will not throw when the
57
49
* execution returns results.
59
extern detail::exec_t exec;
62
* Stream manipulator. When used with a statment's or a row's stream operator,
54
* Stream manipulator. When used with a statment's or a row's stream operator,
63
55
* this manipulator sets the index used to automatically bind values or get
66
57
* @param index the new index
68
detail::set_index_t set_index(
59
_set_index_t set_index(
69
60
unsigned int index );
72
* Stream manipulator. When used with a statement's or a row's stream operator,
73
* this indicates that the data contained within is to be bound as a blob,
76
* @param value the blob data value
77
* @param value_length the length of the blob data
81
unsigned int value_length );
84
* Stream manipulator. When used with a statement's or a row's stream operator,
85
* this indicates that the data contained within is to be bound as a blob,
88
* @param value the blob data value
91
const std::string &value );
94
63
} // namespace sqlite
added
removed
include/sqlite3cc/manipulator.h
