blob: 6ee76cb1ce691f4c9905776e905701f2913e522c (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
|
// file : odb/sqlite/stream.hxx
// license : GNU GPL v2; see accompanying LICENSE file
#ifndef ODB_SQLITE_STREAM_HXX
#define ODB_SQLITE_STREAM_HXX
#include <odb/pre.hxx>
#include <sqlite3.h>
#include <cstddef> // std::size_t
#include <odb/sqlite/connection.hxx>
#include <odb/sqlite/details/export.hxx>
namespace odb
{
namespace sqlite
{
// SQLite incremental BLOB/TEXT I/O stream. Available since
// SQLite 3.4.0.
//
class LIBODB_SQLITE_EXPORT stream: public active_object
{
public:
// @@ TODO: db is actually what we now (and SQLite in other places)
// call schema (see database::schema(), ATTACH DATABASE). So we
// should probably rename this at some point for consistency.
//
stream (const char* db,
const char* table,
const char* column,
long long rowid,
bool rw);
std::size_t
size () const;
// The following two functions throw std::invalid_argument if
// offset + n is past size().
//
void
read (void* buf, std::size_t n, std::size_t offset = 0);
void
write (const void* buf, std::size_t n, std::size_t offset = 0);
sqlite3_blob*
handle () const {return h_;}
// Close without reporting errors, if any.
//
virtual
~stream () {close (false);}
// Close, by default with reporting errors, if any.
//
void
close (bool check = true);
// Open the same BLOB but in a different row. Can be faster
// than creating a new stream instance. Note that the stream
// must be in the open state prior to calling this function.
// Only available since SQLite 3.7.4.
//
#if SQLITE_VERSION_NUMBER >= 3007004
void
reopen (long long rowid);
#endif
protected:
// The active_object interface.
//
virtual void
clear ();
private:
sqlite3_blob* h_;
};
}
}
#include <odb/post.hxx>
#endif // ODB_SQLITE_STREAM_HXX
|