sqlite3 2.0.0-arm-linux-gnu
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +7 -0
- data/.gemtest +0 -0
- data/CHANGELOG.md +800 -0
- data/CONTRIBUTING.md +56 -0
- data/FAQ.md +388 -0
- data/INSTALLATION.md +267 -0
- data/LICENSE +23 -0
- data/README.md +181 -0
- data/dependencies.yml +13 -0
- data/ext/sqlite3/aggregator.c +270 -0
- data/ext/sqlite3/aggregator.h +10 -0
- data/ext/sqlite3/backup.c +190 -0
- data/ext/sqlite3/backup.h +15 -0
- data/ext/sqlite3/database.c +931 -0
- data/ext/sqlite3/database.h +22 -0
- data/ext/sqlite3/exception.c +117 -0
- data/ext/sqlite3/exception.h +10 -0
- data/ext/sqlite3/extconf.rb +284 -0
- data/ext/sqlite3/sqlite3.c +208 -0
- data/ext/sqlite3/sqlite3_ruby.h +48 -0
- data/ext/sqlite3/statement.c +667 -0
- data/ext/sqlite3/statement.h +16 -0
- data/ext/sqlite3/timespec.h +20 -0
- data/lib/sqlite3/3.0/sqlite3_native.so +0 -0
- data/lib/sqlite3/3.1/sqlite3_native.so +0 -0
- data/lib/sqlite3/3.2/sqlite3_native.so +0 -0
- data/lib/sqlite3/3.3/sqlite3_native.so +0 -0
- data/lib/sqlite3/constants.rb +174 -0
- data/lib/sqlite3/database.rb +701 -0
- data/lib/sqlite3/errors.rb +60 -0
- data/lib/sqlite3/pragmas.rb +585 -0
- data/lib/sqlite3/resultset.rb +96 -0
- data/lib/sqlite3/statement.rb +190 -0
- data/lib/sqlite3/value.rb +54 -0
- data/lib/sqlite3/version.rb +3 -0
- data/lib/sqlite3.rb +17 -0
- metadata +101 -0
@@ -0,0 +1,931 @@
|
|
1
|
+
#include <sqlite3_ruby.h>
|
2
|
+
#include <aggregator.h>
|
3
|
+
|
4
|
+
#ifdef _MSC_VER
|
5
|
+
#pragma warning( push )
|
6
|
+
#pragma warning( disable : 4028 )
|
7
|
+
#endif
|
8
|
+
|
9
|
+
#define REQUIRE_OPEN_DB(_ctxt) \
|
10
|
+
if(!_ctxt->db) \
|
11
|
+
rb_raise(rb_path2class("SQLite3::Exception"), "cannot use a closed database");
|
12
|
+
|
13
|
+
VALUE cSqlite3Database;
|
14
|
+
|
15
|
+
static void
|
16
|
+
database_mark(void *ctx)
|
17
|
+
{
|
18
|
+
sqlite3RubyPtr c = (sqlite3RubyPtr)ctx;
|
19
|
+
rb_gc_mark(c->busy_handler);
|
20
|
+
}
|
21
|
+
|
22
|
+
static void
|
23
|
+
deallocate(void *ctx)
|
24
|
+
{
|
25
|
+
sqlite3RubyPtr c = (sqlite3RubyPtr)ctx;
|
26
|
+
sqlite3 *db = c->db;
|
27
|
+
|
28
|
+
if (db) { sqlite3_close(db); }
|
29
|
+
xfree(c);
|
30
|
+
}
|
31
|
+
|
32
|
+
static size_t
|
33
|
+
database_memsize(const void *ctx)
|
34
|
+
{
|
35
|
+
const sqlite3RubyPtr c = (const sqlite3RubyPtr)ctx;
|
36
|
+
// NB: can't account for ctx->db because the type is incomplete.
|
37
|
+
return sizeof(*c);
|
38
|
+
}
|
39
|
+
|
40
|
+
static const rb_data_type_t database_type = {
|
41
|
+
.wrap_struct_name = "SQLite3::Backup",
|
42
|
+
.function = {
|
43
|
+
.dmark = database_mark,
|
44
|
+
.dfree = deallocate,
|
45
|
+
.dsize = database_memsize,
|
46
|
+
},
|
47
|
+
.flags = RUBY_TYPED_WB_PROTECTED, // Not freed immediately because the dfree function do IOs.
|
48
|
+
};
|
49
|
+
|
50
|
+
static VALUE
|
51
|
+
allocate(VALUE klass)
|
52
|
+
{
|
53
|
+
sqlite3RubyPtr ctx;
|
54
|
+
return TypedData_Make_Struct(klass, sqlite3Ruby, &database_type, ctx);
|
55
|
+
}
|
56
|
+
|
57
|
+
static char *
|
58
|
+
utf16_string_value_ptr(VALUE str)
|
59
|
+
{
|
60
|
+
StringValue(str);
|
61
|
+
rb_str_buf_cat(str, "\x00\x00", 2L);
|
62
|
+
return RSTRING_PTR(str);
|
63
|
+
}
|
64
|
+
|
65
|
+
static VALUE sqlite3_rb_close(VALUE self);
|
66
|
+
|
67
|
+
sqlite3RubyPtr
|
68
|
+
sqlite3_database_unwrap(VALUE database)
|
69
|
+
{
|
70
|
+
sqlite3RubyPtr ctx;
|
71
|
+
TypedData_Get_Struct(database, sqlite3Ruby, &database_type, ctx);
|
72
|
+
return ctx;
|
73
|
+
}
|
74
|
+
|
75
|
+
static VALUE
|
76
|
+
rb_sqlite3_open_v2(VALUE self, VALUE file, VALUE mode, VALUE zvfs)
|
77
|
+
{
|
78
|
+
sqlite3RubyPtr ctx;
|
79
|
+
int status;
|
80
|
+
|
81
|
+
TypedData_Get_Struct(self, sqlite3Ruby, &database_type, ctx);
|
82
|
+
|
83
|
+
#if defined TAINTING_SUPPORT
|
84
|
+
# if defined StringValueCStr
|
85
|
+
StringValuePtr(file);
|
86
|
+
rb_check_safe_obj(file);
|
87
|
+
# else
|
88
|
+
Check_SafeStr(file);
|
89
|
+
# endif
|
90
|
+
#endif
|
91
|
+
|
92
|
+
status = sqlite3_open_v2(
|
93
|
+
StringValuePtr(file),
|
94
|
+
&ctx->db,
|
95
|
+
NUM2INT(mode),
|
96
|
+
NIL_P(zvfs) ? NULL : StringValuePtr(zvfs)
|
97
|
+
);
|
98
|
+
|
99
|
+
CHECK(ctx->db, status)
|
100
|
+
|
101
|
+
return self;
|
102
|
+
}
|
103
|
+
|
104
|
+
static VALUE
|
105
|
+
rb_sqlite3_disable_quirk_mode(VALUE self)
|
106
|
+
{
|
107
|
+
#if defined SQLITE_DBCONFIG_DQS_DDL
|
108
|
+
sqlite3RubyPtr ctx;
|
109
|
+
TypedData_Get_Struct(self, sqlite3Ruby, &database_type, ctx);
|
110
|
+
|
111
|
+
if (!ctx->db) { return Qfalse; }
|
112
|
+
|
113
|
+
sqlite3_db_config(ctx->db, SQLITE_DBCONFIG_DQS_DDL, 0, (void *)0);
|
114
|
+
sqlite3_db_config(ctx->db, SQLITE_DBCONFIG_DQS_DML, 0, (void *)0);
|
115
|
+
|
116
|
+
return Qtrue;
|
117
|
+
#else
|
118
|
+
return Qfalse;
|
119
|
+
#endif
|
120
|
+
}
|
121
|
+
|
122
|
+
/* call-seq: db.close
|
123
|
+
*
|
124
|
+
* Closes this database.
|
125
|
+
*/
|
126
|
+
static VALUE
|
127
|
+
sqlite3_rb_close(VALUE self)
|
128
|
+
{
|
129
|
+
sqlite3RubyPtr ctx;
|
130
|
+
sqlite3 *db;
|
131
|
+
TypedData_Get_Struct(self, sqlite3Ruby, &database_type, ctx);
|
132
|
+
|
133
|
+
db = ctx->db;
|
134
|
+
CHECK(db, sqlite3_close(ctx->db));
|
135
|
+
|
136
|
+
ctx->db = NULL;
|
137
|
+
|
138
|
+
rb_iv_set(self, "-aggregators", Qnil);
|
139
|
+
|
140
|
+
return self;
|
141
|
+
}
|
142
|
+
|
143
|
+
/* call-seq: db.closed?
|
144
|
+
*
|
145
|
+
* Returns +true+ if this database instance has been closed (see #close).
|
146
|
+
*/
|
147
|
+
static VALUE
|
148
|
+
closed_p(VALUE self)
|
149
|
+
{
|
150
|
+
sqlite3RubyPtr ctx;
|
151
|
+
TypedData_Get_Struct(self, sqlite3Ruby, &database_type, ctx);
|
152
|
+
|
153
|
+
if (!ctx->db) { return Qtrue; }
|
154
|
+
|
155
|
+
return Qfalse;
|
156
|
+
}
|
157
|
+
|
158
|
+
/* call-seq: total_changes
|
159
|
+
*
|
160
|
+
* Returns the total number of changes made to this database instance
|
161
|
+
* since it was opened.
|
162
|
+
*/
|
163
|
+
static VALUE
|
164
|
+
total_changes(VALUE self)
|
165
|
+
{
|
166
|
+
sqlite3RubyPtr ctx;
|
167
|
+
TypedData_Get_Struct(self, sqlite3Ruby, &database_type, ctx);
|
168
|
+
REQUIRE_OPEN_DB(ctx);
|
169
|
+
|
170
|
+
return INT2NUM(sqlite3_total_changes(ctx->db));
|
171
|
+
}
|
172
|
+
|
173
|
+
static void
|
174
|
+
tracefunc(void *data, const char *sql)
|
175
|
+
{
|
176
|
+
VALUE self = (VALUE)data;
|
177
|
+
VALUE thing = rb_iv_get(self, "@tracefunc");
|
178
|
+
rb_funcall(thing, rb_intern("call"), 1, rb_str_new2(sql));
|
179
|
+
}
|
180
|
+
|
181
|
+
/* call-seq:
|
182
|
+
* trace { |sql| ... }
|
183
|
+
* trace(Class.new { def call sql; end }.new)
|
184
|
+
*
|
185
|
+
* Installs (or removes) a block that will be invoked for every SQL
|
186
|
+
* statement executed. The block receives one parameter: the SQL statement
|
187
|
+
* executed. If the block is +nil+, any existing tracer will be uninstalled.
|
188
|
+
*/
|
189
|
+
static VALUE
|
190
|
+
trace(int argc, VALUE *argv, VALUE self)
|
191
|
+
{
|
192
|
+
sqlite3RubyPtr ctx;
|
193
|
+
VALUE block;
|
194
|
+
|
195
|
+
TypedData_Get_Struct(self, sqlite3Ruby, &database_type, ctx);
|
196
|
+
REQUIRE_OPEN_DB(ctx);
|
197
|
+
|
198
|
+
rb_scan_args(argc, argv, "01", &block);
|
199
|
+
|
200
|
+
if (NIL_P(block) && rb_block_given_p()) { block = rb_block_proc(); }
|
201
|
+
|
202
|
+
rb_iv_set(self, "@tracefunc", block);
|
203
|
+
|
204
|
+
sqlite3_trace(ctx->db, NIL_P(block) ? NULL : tracefunc, (void *)self);
|
205
|
+
|
206
|
+
return self;
|
207
|
+
}
|
208
|
+
|
209
|
+
static int
|
210
|
+
rb_sqlite3_busy_handler(void *context, int count)
|
211
|
+
{
|
212
|
+
sqlite3RubyPtr ctx = (sqlite3RubyPtr)context;
|
213
|
+
|
214
|
+
VALUE handle = ctx->busy_handler;
|
215
|
+
VALUE result = rb_funcall(handle, rb_intern("call"), 1, INT2NUM(count));
|
216
|
+
|
217
|
+
if (Qfalse == result) { return 0; }
|
218
|
+
|
219
|
+
return 1;
|
220
|
+
}
|
221
|
+
|
222
|
+
/* call-seq:
|
223
|
+
* busy_handler { |count| ... }
|
224
|
+
* busy_handler(Class.new { def call count; end }.new)
|
225
|
+
*
|
226
|
+
* Register a busy handler with this database instance. When a requested
|
227
|
+
* resource is busy, this handler will be invoked. If the handler returns
|
228
|
+
* +false+, the operation will be aborted; otherwise, the resource will
|
229
|
+
* be requested again.
|
230
|
+
*
|
231
|
+
* The handler will be invoked with the name of the resource that was
|
232
|
+
* busy, and the number of times it has been retried.
|
233
|
+
*
|
234
|
+
* See also the mutually exclusive #busy_timeout.
|
235
|
+
*/
|
236
|
+
static VALUE
|
237
|
+
busy_handler(int argc, VALUE *argv, VALUE self)
|
238
|
+
{
|
239
|
+
sqlite3RubyPtr ctx;
|
240
|
+
VALUE block;
|
241
|
+
int status;
|
242
|
+
|
243
|
+
TypedData_Get_Struct(self, sqlite3Ruby, &database_type, ctx);
|
244
|
+
REQUIRE_OPEN_DB(ctx);
|
245
|
+
|
246
|
+
rb_scan_args(argc, argv, "01", &block);
|
247
|
+
|
248
|
+
if (NIL_P(block) && rb_block_given_p()) { block = rb_block_proc(); }
|
249
|
+
ctx->busy_handler = block;
|
250
|
+
|
251
|
+
status = sqlite3_busy_handler(
|
252
|
+
ctx->db,
|
253
|
+
NIL_P(block) ? NULL : rb_sqlite3_busy_handler,
|
254
|
+
(void *)ctx
|
255
|
+
);
|
256
|
+
|
257
|
+
CHECK(ctx->db, status);
|
258
|
+
|
259
|
+
return self;
|
260
|
+
}
|
261
|
+
|
262
|
+
static int
|
263
|
+
rb_sqlite3_statement_timeout(void *context)
|
264
|
+
{
|
265
|
+
sqlite3RubyPtr ctx = (sqlite3RubyPtr)context;
|
266
|
+
struct timespec currentTime;
|
267
|
+
clock_gettime(CLOCK_MONOTONIC, ¤tTime);
|
268
|
+
|
269
|
+
if (!timespecisset(&ctx->stmt_deadline)) {
|
270
|
+
// Set stmt_deadline if not already set
|
271
|
+
ctx->stmt_deadline = currentTime;
|
272
|
+
} else if (timespecafter(¤tTime, &ctx->stmt_deadline)) {
|
273
|
+
return 1;
|
274
|
+
}
|
275
|
+
|
276
|
+
return 0;
|
277
|
+
}
|
278
|
+
|
279
|
+
/* call-seq: db.statement_timeout = ms
|
280
|
+
*
|
281
|
+
* Indicates that if a query lasts longer than the indicated number of
|
282
|
+
* milliseconds, SQLite should interrupt that query and return an error.
|
283
|
+
* By default, SQLite does not interrupt queries. To restore the default
|
284
|
+
* behavior, send 0 as the +ms+ parameter.
|
285
|
+
*/
|
286
|
+
static VALUE
|
287
|
+
set_statement_timeout(VALUE self, VALUE milliseconds)
|
288
|
+
{
|
289
|
+
sqlite3RubyPtr ctx;
|
290
|
+
TypedData_Get_Struct(self, sqlite3Ruby, &database_type, ctx);
|
291
|
+
|
292
|
+
ctx->stmt_timeout = NUM2INT(milliseconds);
|
293
|
+
int n = NUM2INT(milliseconds) == 0 ? -1 : 1000;
|
294
|
+
|
295
|
+
sqlite3_progress_handler(ctx->db, n, rb_sqlite3_statement_timeout, (void *)ctx);
|
296
|
+
|
297
|
+
return self;
|
298
|
+
}
|
299
|
+
|
300
|
+
/* call-seq: last_insert_row_id
|
301
|
+
*
|
302
|
+
* Obtains the unique row ID of the last row to be inserted by this Database
|
303
|
+
* instance.
|
304
|
+
*/
|
305
|
+
static VALUE
|
306
|
+
last_insert_row_id(VALUE self)
|
307
|
+
{
|
308
|
+
sqlite3RubyPtr ctx;
|
309
|
+
TypedData_Get_Struct(self, sqlite3Ruby, &database_type, ctx);
|
310
|
+
REQUIRE_OPEN_DB(ctx);
|
311
|
+
|
312
|
+
return LL2NUM(sqlite3_last_insert_rowid(ctx->db));
|
313
|
+
}
|
314
|
+
|
315
|
+
VALUE
|
316
|
+
sqlite3val2rb(sqlite3_value *val)
|
317
|
+
{
|
318
|
+
VALUE rb_val;
|
319
|
+
|
320
|
+
switch (sqlite3_value_type(val)) {
|
321
|
+
case SQLITE_INTEGER:
|
322
|
+
rb_val = LL2NUM(sqlite3_value_int64(val));
|
323
|
+
break;
|
324
|
+
case SQLITE_FLOAT:
|
325
|
+
rb_val = rb_float_new(sqlite3_value_double(val));
|
326
|
+
break;
|
327
|
+
case SQLITE_TEXT: {
|
328
|
+
rb_val = rb_utf8_str_new_cstr((const char *)sqlite3_value_text(val));
|
329
|
+
rb_obj_freeze(rb_val);
|
330
|
+
break;
|
331
|
+
}
|
332
|
+
case SQLITE_BLOB: {
|
333
|
+
int len = sqlite3_value_bytes(val);
|
334
|
+
rb_val = rb_str_new((const char *)sqlite3_value_blob(val), len);
|
335
|
+
rb_obj_freeze(rb_val);
|
336
|
+
break;
|
337
|
+
}
|
338
|
+
case SQLITE_NULL:
|
339
|
+
rb_val = Qnil;
|
340
|
+
break;
|
341
|
+
default:
|
342
|
+
rb_raise(rb_eRuntimeError, "bad type");
|
343
|
+
}
|
344
|
+
|
345
|
+
return rb_val;
|
346
|
+
}
|
347
|
+
|
348
|
+
void
|
349
|
+
set_sqlite3_func_result(sqlite3_context *ctx, VALUE result)
|
350
|
+
{
|
351
|
+
switch (TYPE(result)) {
|
352
|
+
case T_NIL:
|
353
|
+
sqlite3_result_null(ctx);
|
354
|
+
break;
|
355
|
+
case T_FIXNUM:
|
356
|
+
sqlite3_result_int64(ctx, (sqlite3_int64)FIX2LONG(result));
|
357
|
+
break;
|
358
|
+
case T_BIGNUM: {
|
359
|
+
#if SIZEOF_LONG < 8
|
360
|
+
sqlite3_int64 num64;
|
361
|
+
|
362
|
+
if (bignum_to_int64(result, &num64)) {
|
363
|
+
sqlite3_result_int64(ctx, num64);
|
364
|
+
break;
|
365
|
+
}
|
366
|
+
#endif
|
367
|
+
}
|
368
|
+
case T_FLOAT:
|
369
|
+
sqlite3_result_double(ctx, NUM2DBL(result));
|
370
|
+
break;
|
371
|
+
case T_STRING:
|
372
|
+
if (CLASS_OF(result) == cSqlite3Blob
|
373
|
+
|| rb_enc_get_index(result) == rb_ascii8bit_encindex()
|
374
|
+
) {
|
375
|
+
sqlite3_result_blob(
|
376
|
+
ctx,
|
377
|
+
(const void *)StringValuePtr(result),
|
378
|
+
(int)RSTRING_LEN(result),
|
379
|
+
SQLITE_TRANSIENT
|
380
|
+
);
|
381
|
+
} else {
|
382
|
+
sqlite3_result_text(
|
383
|
+
ctx,
|
384
|
+
(const char *)StringValuePtr(result),
|
385
|
+
(int)RSTRING_LEN(result),
|
386
|
+
SQLITE_TRANSIENT
|
387
|
+
);
|
388
|
+
}
|
389
|
+
break;
|
390
|
+
default:
|
391
|
+
rb_raise(rb_eRuntimeError, "can't return %s",
|
392
|
+
rb_class2name(CLASS_OF(result)));
|
393
|
+
}
|
394
|
+
}
|
395
|
+
|
396
|
+
static void
|
397
|
+
rb_sqlite3_func(sqlite3_context *ctx, int argc, sqlite3_value **argv)
|
398
|
+
{
|
399
|
+
VALUE callable = (VALUE)sqlite3_user_data(ctx);
|
400
|
+
VALUE params = rb_ary_new2(argc);
|
401
|
+
VALUE result;
|
402
|
+
int i;
|
403
|
+
|
404
|
+
if (argc > 0) {
|
405
|
+
for (i = 0; i < argc; i++) {
|
406
|
+
VALUE param = sqlite3val2rb(argv[i]);
|
407
|
+
rb_ary_push(params, param);
|
408
|
+
}
|
409
|
+
}
|
410
|
+
|
411
|
+
result = rb_apply(callable, rb_intern("call"), params);
|
412
|
+
|
413
|
+
set_sqlite3_func_result(ctx, result);
|
414
|
+
}
|
415
|
+
|
416
|
+
#ifndef HAVE_RB_PROC_ARITY
|
417
|
+
int
|
418
|
+
rb_proc_arity(VALUE self)
|
419
|
+
{
|
420
|
+
return (int)NUM2INT(rb_funcall(self, rb_intern("arity"), 0));
|
421
|
+
}
|
422
|
+
#endif
|
423
|
+
|
424
|
+
/* call-seq: define_function_with_flags(name, flags) { |args,...| }
|
425
|
+
*
|
426
|
+
* Define a function named +name+ with +args+ using TextRep bitflags +flags+. The arity of the block
|
427
|
+
* will be used as the arity for the function defined.
|
428
|
+
*/
|
429
|
+
static VALUE
|
430
|
+
define_function_with_flags(VALUE self, VALUE name, VALUE flags)
|
431
|
+
{
|
432
|
+
sqlite3RubyPtr ctx;
|
433
|
+
VALUE block;
|
434
|
+
int status;
|
435
|
+
|
436
|
+
TypedData_Get_Struct(self, sqlite3Ruby, &database_type, ctx);
|
437
|
+
REQUIRE_OPEN_DB(ctx);
|
438
|
+
|
439
|
+
block = rb_block_proc();
|
440
|
+
|
441
|
+
status = sqlite3_create_function(
|
442
|
+
ctx->db,
|
443
|
+
StringValuePtr(name),
|
444
|
+
rb_proc_arity(block),
|
445
|
+
NUM2INT(flags),
|
446
|
+
(void *)block,
|
447
|
+
rb_sqlite3_func,
|
448
|
+
NULL,
|
449
|
+
NULL
|
450
|
+
);
|
451
|
+
|
452
|
+
CHECK(ctx->db, status);
|
453
|
+
|
454
|
+
rb_hash_aset(rb_iv_get(self, "@functions"), name, block);
|
455
|
+
|
456
|
+
return self;
|
457
|
+
}
|
458
|
+
|
459
|
+
/* call-seq: define_function(name) { |args,...| }
|
460
|
+
*
|
461
|
+
* Define a function named +name+ with +args+. The arity of the block
|
462
|
+
* will be used as the arity for the function defined.
|
463
|
+
*/
|
464
|
+
static VALUE
|
465
|
+
define_function(VALUE self, VALUE name)
|
466
|
+
{
|
467
|
+
return define_function_with_flags(self, name, INT2FIX(SQLITE_UTF8));
|
468
|
+
}
|
469
|
+
|
470
|
+
/* call-seq: interrupt
|
471
|
+
*
|
472
|
+
* Interrupts the currently executing operation, causing it to abort.
|
473
|
+
*/
|
474
|
+
static VALUE
|
475
|
+
interrupt(VALUE self)
|
476
|
+
{
|
477
|
+
sqlite3RubyPtr ctx;
|
478
|
+
TypedData_Get_Struct(self, sqlite3Ruby, &database_type, ctx);
|
479
|
+
REQUIRE_OPEN_DB(ctx);
|
480
|
+
|
481
|
+
sqlite3_interrupt(ctx->db);
|
482
|
+
|
483
|
+
return self;
|
484
|
+
}
|
485
|
+
|
486
|
+
/* call-seq: errmsg
|
487
|
+
*
|
488
|
+
* Return a string describing the last error to have occurred with this
|
489
|
+
* database.
|
490
|
+
*/
|
491
|
+
static VALUE
|
492
|
+
errmsg(VALUE self)
|
493
|
+
{
|
494
|
+
sqlite3RubyPtr ctx;
|
495
|
+
TypedData_Get_Struct(self, sqlite3Ruby, &database_type, ctx);
|
496
|
+
REQUIRE_OPEN_DB(ctx);
|
497
|
+
|
498
|
+
return rb_str_new2(sqlite3_errmsg(ctx->db));
|
499
|
+
}
|
500
|
+
|
501
|
+
/* call-seq: errcode
|
502
|
+
*
|
503
|
+
* Return an integer representing the last error to have occurred with this
|
504
|
+
* database.
|
505
|
+
*/
|
506
|
+
static VALUE
|
507
|
+
errcode_(VALUE self)
|
508
|
+
{
|
509
|
+
sqlite3RubyPtr ctx;
|
510
|
+
TypedData_Get_Struct(self, sqlite3Ruby, &database_type, ctx);
|
511
|
+
REQUIRE_OPEN_DB(ctx);
|
512
|
+
|
513
|
+
return INT2NUM(sqlite3_errcode(ctx->db));
|
514
|
+
}
|
515
|
+
|
516
|
+
/* call-seq: complete?(sql)
|
517
|
+
*
|
518
|
+
* Return +true+ if the string is a valid (ie, parsable) SQL statement, and
|
519
|
+
* +false+ otherwise.
|
520
|
+
*/
|
521
|
+
static VALUE
|
522
|
+
complete_p(VALUE UNUSED(self), VALUE sql)
|
523
|
+
{
|
524
|
+
if (sqlite3_complete(StringValuePtr(sql))) {
|
525
|
+
return Qtrue;
|
526
|
+
}
|
527
|
+
|
528
|
+
return Qfalse;
|
529
|
+
}
|
530
|
+
|
531
|
+
/* call-seq: changes
|
532
|
+
*
|
533
|
+
* Returns the number of changes made to this database instance by the last
|
534
|
+
* operation performed. Note that a "delete from table" without a where
|
535
|
+
* clause will not affect this value.
|
536
|
+
*/
|
537
|
+
static VALUE
|
538
|
+
changes(VALUE self)
|
539
|
+
{
|
540
|
+
sqlite3RubyPtr ctx;
|
541
|
+
TypedData_Get_Struct(self, sqlite3Ruby, &database_type, ctx);
|
542
|
+
REQUIRE_OPEN_DB(ctx);
|
543
|
+
|
544
|
+
return INT2NUM(sqlite3_changes(ctx->db));
|
545
|
+
}
|
546
|
+
|
547
|
+
static int
|
548
|
+
rb_sqlite3_auth(
|
549
|
+
void *ctx,
|
550
|
+
int _action,
|
551
|
+
const char *_a,
|
552
|
+
const char *_b,
|
553
|
+
const char *_c,
|
554
|
+
const char *_d)
|
555
|
+
{
|
556
|
+
VALUE self = (VALUE)ctx;
|
557
|
+
VALUE action = INT2NUM(_action);
|
558
|
+
VALUE a = _a ? rb_str_new2(_a) : Qnil;
|
559
|
+
VALUE b = _b ? rb_str_new2(_b) : Qnil;
|
560
|
+
VALUE c = _c ? rb_str_new2(_c) : Qnil;
|
561
|
+
VALUE d = _d ? rb_str_new2(_d) : Qnil;
|
562
|
+
VALUE callback = rb_iv_get(self, "@authorizer");
|
563
|
+
VALUE result = rb_funcall(callback, rb_intern("call"), 5, action, a, b, c, d);
|
564
|
+
|
565
|
+
if (T_FIXNUM == TYPE(result)) { return (int)NUM2INT(result); }
|
566
|
+
if (Qtrue == result) { return SQLITE_OK; }
|
567
|
+
if (Qfalse == result) { return SQLITE_DENY; }
|
568
|
+
|
569
|
+
return SQLITE_IGNORE;
|
570
|
+
}
|
571
|
+
|
572
|
+
/* call-seq: set_authorizer = auth
|
573
|
+
*
|
574
|
+
* Set the authorizer for this database. +auth+ must respond to +call+, and
|
575
|
+
* +call+ must take 5 arguments.
|
576
|
+
*
|
577
|
+
* Installs (or removes) a block that will be invoked for every access
|
578
|
+
* to the database. If the block returns 0 (or +true+), the statement
|
579
|
+
* is allowed to proceed. Returning 1 or false causes an authorization error to
|
580
|
+
* occur, and returning 2 or nil causes the access to be silently denied.
|
581
|
+
*/
|
582
|
+
static VALUE
|
583
|
+
set_authorizer(VALUE self, VALUE authorizer)
|
584
|
+
{
|
585
|
+
sqlite3RubyPtr ctx;
|
586
|
+
int status;
|
587
|
+
|
588
|
+
TypedData_Get_Struct(self, sqlite3Ruby, &database_type, ctx);
|
589
|
+
REQUIRE_OPEN_DB(ctx);
|
590
|
+
|
591
|
+
status = sqlite3_set_authorizer(
|
592
|
+
ctx->db, NIL_P(authorizer) ? NULL : rb_sqlite3_auth, (void *)self
|
593
|
+
);
|
594
|
+
|
595
|
+
CHECK(ctx->db, status);
|
596
|
+
|
597
|
+
rb_iv_set(self, "@authorizer", authorizer);
|
598
|
+
|
599
|
+
return self;
|
600
|
+
}
|
601
|
+
|
602
|
+
/* call-seq: db.busy_timeout = ms
|
603
|
+
*
|
604
|
+
* Indicates that if a request for a resource terminates because that
|
605
|
+
* resource is busy, SQLite should sleep and retry for up to the indicated
|
606
|
+
* number of milliseconds. By default, SQLite does not retry
|
607
|
+
* busy resources. To restore the default behavior, send 0 as the
|
608
|
+
* +ms+ parameter.
|
609
|
+
*
|
610
|
+
* See also the mutually exclusive #busy_handler.
|
611
|
+
*/
|
612
|
+
static VALUE
|
613
|
+
set_busy_timeout(VALUE self, VALUE timeout)
|
614
|
+
{
|
615
|
+
sqlite3RubyPtr ctx;
|
616
|
+
TypedData_Get_Struct(self, sqlite3Ruby, &database_type, ctx);
|
617
|
+
REQUIRE_OPEN_DB(ctx);
|
618
|
+
|
619
|
+
CHECK(ctx->db, sqlite3_busy_timeout(ctx->db, (int)NUM2INT(timeout)));
|
620
|
+
|
621
|
+
return self;
|
622
|
+
}
|
623
|
+
|
624
|
+
/* call-seq: db.extended_result_codes = true
|
625
|
+
*
|
626
|
+
* Enable extended result codes in SQLite. These result codes allow for more
|
627
|
+
* detailed exception reporting, such a which type of constraint is violated.
|
628
|
+
*/
|
629
|
+
static VALUE
|
630
|
+
set_extended_result_codes(VALUE self, VALUE enable)
|
631
|
+
{
|
632
|
+
sqlite3RubyPtr ctx;
|
633
|
+
TypedData_Get_Struct(self, sqlite3Ruby, &database_type, ctx);
|
634
|
+
REQUIRE_OPEN_DB(ctx);
|
635
|
+
|
636
|
+
CHECK(ctx->db, sqlite3_extended_result_codes(ctx->db, RTEST(enable) ? 1 : 0));
|
637
|
+
|
638
|
+
return self;
|
639
|
+
}
|
640
|
+
|
641
|
+
int
|
642
|
+
rb_comparator_func(void *ctx, int a_len, const void *a, int b_len, const void *b)
|
643
|
+
{
|
644
|
+
VALUE comparator;
|
645
|
+
VALUE a_str;
|
646
|
+
VALUE b_str;
|
647
|
+
VALUE comparison;
|
648
|
+
rb_encoding *internal_encoding;
|
649
|
+
|
650
|
+
internal_encoding = rb_default_internal_encoding();
|
651
|
+
|
652
|
+
comparator = (VALUE)ctx;
|
653
|
+
a_str = rb_str_new((const char *)a, a_len);
|
654
|
+
b_str = rb_str_new((const char *)b, b_len);
|
655
|
+
|
656
|
+
rb_enc_associate_index(a_str, rb_utf8_encindex());
|
657
|
+
rb_enc_associate_index(b_str, rb_utf8_encindex());
|
658
|
+
|
659
|
+
if (internal_encoding) {
|
660
|
+
a_str = rb_str_export_to_enc(a_str, internal_encoding);
|
661
|
+
b_str = rb_str_export_to_enc(b_str, internal_encoding);
|
662
|
+
}
|
663
|
+
|
664
|
+
comparison = rb_funcall(comparator, rb_intern("compare"), 2, a_str, b_str);
|
665
|
+
|
666
|
+
return NUM2INT(comparison);
|
667
|
+
}
|
668
|
+
|
669
|
+
/* call-seq: db.collation(name, comparator)
|
670
|
+
*
|
671
|
+
* Add a collation with name +name+, and a +comparator+ object. The
|
672
|
+
* +comparator+ object should implement a method called "compare" that takes
|
673
|
+
* two parameters and returns an integer less than, equal to, or greater than
|
674
|
+
* 0.
|
675
|
+
*/
|
676
|
+
static VALUE
|
677
|
+
collation(VALUE self, VALUE name, VALUE comparator)
|
678
|
+
{
|
679
|
+
sqlite3RubyPtr ctx;
|
680
|
+
TypedData_Get_Struct(self, sqlite3Ruby, &database_type, ctx);
|
681
|
+
REQUIRE_OPEN_DB(ctx);
|
682
|
+
|
683
|
+
CHECK(ctx->db, sqlite3_create_collation(
|
684
|
+
ctx->db,
|
685
|
+
StringValuePtr(name),
|
686
|
+
SQLITE_UTF8,
|
687
|
+
(void *)comparator,
|
688
|
+
NIL_P(comparator) ? NULL : rb_comparator_func));
|
689
|
+
|
690
|
+
/* Make sure our comparator doesn't get garbage collected. */
|
691
|
+
rb_hash_aset(rb_iv_get(self, "@collations"), name, comparator);
|
692
|
+
|
693
|
+
return self;
|
694
|
+
}
|
695
|
+
|
696
|
+
#ifdef HAVE_SQLITE3_LOAD_EXTENSION
|
697
|
+
/* call-seq: db.load_extension(file)
|
698
|
+
*
|
699
|
+
* Loads an SQLite extension library from the named file. Extension
|
700
|
+
* loading must be enabled using db.enable_load_extension(true) prior
|
701
|
+
* to calling this API.
|
702
|
+
*/
|
703
|
+
static VALUE
|
704
|
+
load_extension(VALUE self, VALUE file)
|
705
|
+
{
|
706
|
+
sqlite3RubyPtr ctx;
|
707
|
+
int status;
|
708
|
+
char *errMsg;
|
709
|
+
|
710
|
+
TypedData_Get_Struct(self, sqlite3Ruby, &database_type, ctx);
|
711
|
+
REQUIRE_OPEN_DB(ctx);
|
712
|
+
|
713
|
+
status = sqlite3_load_extension(ctx->db, StringValuePtr(file), 0, &errMsg);
|
714
|
+
|
715
|
+
CHECK_MSG(ctx->db, status, errMsg);
|
716
|
+
|
717
|
+
return self;
|
718
|
+
}
|
719
|
+
#endif
|
720
|
+
|
721
|
+
#ifdef HAVE_SQLITE3_ENABLE_LOAD_EXTENSION
|
722
|
+
/* call-seq: db.enable_load_extension(onoff)
|
723
|
+
*
|
724
|
+
* Enable or disable extension loading.
|
725
|
+
*/
|
726
|
+
static VALUE
|
727
|
+
enable_load_extension(VALUE self, VALUE onoff)
|
728
|
+
{
|
729
|
+
sqlite3RubyPtr ctx;
|
730
|
+
int onoffparam;
|
731
|
+
TypedData_Get_Struct(self, sqlite3Ruby, &database_type, ctx);
|
732
|
+
REQUIRE_OPEN_DB(ctx);
|
733
|
+
|
734
|
+
if (Qtrue == onoff) {
|
735
|
+
onoffparam = 1;
|
736
|
+
} else if (Qfalse == onoff) {
|
737
|
+
onoffparam = 0;
|
738
|
+
} else {
|
739
|
+
onoffparam = (int)NUM2INT(onoff);
|
740
|
+
}
|
741
|
+
|
742
|
+
CHECK(ctx->db, sqlite3_enable_load_extension(ctx->db, onoffparam));
|
743
|
+
|
744
|
+
return self;
|
745
|
+
}
|
746
|
+
#endif
|
747
|
+
|
748
|
+
/* call-seq: db.transaction_active?
|
749
|
+
*
|
750
|
+
* Returns +true+ if there is a transaction active, and +false+ otherwise.
|
751
|
+
*
|
752
|
+
*/
|
753
|
+
static VALUE
|
754
|
+
transaction_active_p(VALUE self)
|
755
|
+
{
|
756
|
+
sqlite3RubyPtr ctx;
|
757
|
+
TypedData_Get_Struct(self, sqlite3Ruby, &database_type, ctx);
|
758
|
+
REQUIRE_OPEN_DB(ctx);
|
759
|
+
|
760
|
+
return sqlite3_get_autocommit(ctx->db) ? Qfalse : Qtrue;
|
761
|
+
}
|
762
|
+
|
763
|
+
static int
|
764
|
+
hash_callback_function(VALUE callback_ary, int count, char **data, char **columns)
|
765
|
+
{
|
766
|
+
VALUE new_hash = rb_hash_new();
|
767
|
+
int i;
|
768
|
+
|
769
|
+
for (i = 0; i < count; i++) {
|
770
|
+
if (data[i] == NULL) {
|
771
|
+
rb_hash_aset(new_hash, rb_str_new_cstr(columns[i]), Qnil);
|
772
|
+
} else {
|
773
|
+
rb_hash_aset(new_hash, rb_str_new_cstr(columns[i]), rb_str_new_cstr(data[i]));
|
774
|
+
}
|
775
|
+
}
|
776
|
+
|
777
|
+
rb_ary_push(callback_ary, new_hash);
|
778
|
+
|
779
|
+
return 0;
|
780
|
+
}
|
781
|
+
|
782
|
+
static int
|
783
|
+
regular_callback_function(VALUE callback_ary, int count, char **data, char **columns)
|
784
|
+
{
|
785
|
+
VALUE new_ary = rb_ary_new();
|
786
|
+
int i;
|
787
|
+
|
788
|
+
for (i = 0; i < count; i++) {
|
789
|
+
if (data[i] == NULL) {
|
790
|
+
rb_ary_push(new_ary, Qnil);
|
791
|
+
} else {
|
792
|
+
rb_ary_push(new_ary, rb_str_new_cstr(data[i]));
|
793
|
+
}
|
794
|
+
}
|
795
|
+
|
796
|
+
rb_ary_push(callback_ary, new_ary);
|
797
|
+
|
798
|
+
return 0;
|
799
|
+
}
|
800
|
+
|
801
|
+
|
802
|
+
/* Is invoked by calling db.execute_batch2(sql, &block)
|
803
|
+
*
|
804
|
+
* Executes all statements in a given string separated by semicolons.
|
805
|
+
* If a query is made, all values returned are strings
|
806
|
+
* (except for 'NULL' values which return nil),
|
807
|
+
* so the user may parse values with a block.
|
808
|
+
* If no query is made, an empty array will be returned.
|
809
|
+
*/
|
810
|
+
static VALUE
|
811
|
+
exec_batch(VALUE self, VALUE sql, VALUE results_as_hash)
|
812
|
+
{
|
813
|
+
sqlite3RubyPtr ctx;
|
814
|
+
int status;
|
815
|
+
VALUE callback_ary = rb_ary_new();
|
816
|
+
char *errMsg;
|
817
|
+
|
818
|
+
TypedData_Get_Struct(self, sqlite3Ruby, &database_type, ctx);
|
819
|
+
REQUIRE_OPEN_DB(ctx);
|
820
|
+
|
821
|
+
if (results_as_hash == Qtrue) {
|
822
|
+
status = sqlite3_exec(ctx->db, StringValuePtr(sql), (sqlite3_callback)hash_callback_function,
|
823
|
+
(void *)callback_ary,
|
824
|
+
&errMsg);
|
825
|
+
} else {
|
826
|
+
status = sqlite3_exec(ctx->db, StringValuePtr(sql), (sqlite3_callback)regular_callback_function,
|
827
|
+
(void *)callback_ary,
|
828
|
+
&errMsg);
|
829
|
+
}
|
830
|
+
|
831
|
+
CHECK_MSG(ctx->db, status, errMsg);
|
832
|
+
|
833
|
+
return callback_ary;
|
834
|
+
}
|
835
|
+
|
836
|
+
/* call-seq: db.db_filename(database_name)
|
837
|
+
*
|
838
|
+
* Returns the file associated with +database_name+. Can return nil or an
|
839
|
+
* empty string if the database is temporary, or in-memory.
|
840
|
+
*/
|
841
|
+
static VALUE
|
842
|
+
db_filename(VALUE self, VALUE db_name)
|
843
|
+
{
|
844
|
+
sqlite3RubyPtr ctx;
|
845
|
+
const char *fname;
|
846
|
+
TypedData_Get_Struct(self, sqlite3Ruby, &database_type, ctx);
|
847
|
+
REQUIRE_OPEN_DB(ctx);
|
848
|
+
|
849
|
+
fname = sqlite3_db_filename(ctx->db, StringValueCStr(db_name));
|
850
|
+
|
851
|
+
if (fname) { return SQLITE3_UTF8_STR_NEW2(fname); }
|
852
|
+
return Qnil;
|
853
|
+
}
|
854
|
+
|
855
|
+
static VALUE
|
856
|
+
rb_sqlite3_open16(VALUE self, VALUE file)
|
857
|
+
{
|
858
|
+
int status;
|
859
|
+
sqlite3RubyPtr ctx;
|
860
|
+
|
861
|
+
TypedData_Get_Struct(self, sqlite3Ruby, &database_type, ctx);
|
862
|
+
|
863
|
+
#if defined TAINTING_SUPPORT
|
864
|
+
#if defined StringValueCStr
|
865
|
+
StringValuePtr(file);
|
866
|
+
rb_check_safe_obj(file);
|
867
|
+
#else
|
868
|
+
Check_SafeStr(file);
|
869
|
+
#endif
|
870
|
+
#endif
|
871
|
+
|
872
|
+
status = sqlite3_open16(utf16_string_value_ptr(file), &ctx->db);
|
873
|
+
|
874
|
+
CHECK(ctx->db, status)
|
875
|
+
|
876
|
+
return INT2NUM(status);
|
877
|
+
}
|
878
|
+
|
879
|
+
void
|
880
|
+
init_sqlite3_database(void)
|
881
|
+
{
|
882
|
+
#if 0
|
883
|
+
VALUE mSqlite3 = rb_define_module("SQLite3");
|
884
|
+
#endif
|
885
|
+
cSqlite3Database = rb_define_class_under(mSqlite3, "Database", rb_cObject);
|
886
|
+
|
887
|
+
rb_define_alloc_func(cSqlite3Database, allocate);
|
888
|
+
rb_define_private_method(cSqlite3Database, "open_v2", rb_sqlite3_open_v2, 3);
|
889
|
+
rb_define_private_method(cSqlite3Database, "open16", rb_sqlite3_open16, 1);
|
890
|
+
rb_define_method(cSqlite3Database, "collation", collation, 2);
|
891
|
+
rb_define_method(cSqlite3Database, "close", sqlite3_rb_close, 0);
|
892
|
+
rb_define_method(cSqlite3Database, "closed?", closed_p, 0);
|
893
|
+
rb_define_method(cSqlite3Database, "total_changes", total_changes, 0);
|
894
|
+
rb_define_method(cSqlite3Database, "trace", trace, -1);
|
895
|
+
rb_define_method(cSqlite3Database, "last_insert_row_id", last_insert_row_id, 0);
|
896
|
+
rb_define_method(cSqlite3Database, "define_function", define_function, 1);
|
897
|
+
rb_define_method(cSqlite3Database, "define_function_with_flags", define_function_with_flags, 2);
|
898
|
+
/* public "define_aggregator" is now a shim around define_aggregator2
|
899
|
+
* implemented in Ruby */
|
900
|
+
rb_define_private_method(cSqlite3Database, "define_aggregator2", rb_sqlite3_define_aggregator2, 2);
|
901
|
+
rb_define_private_method(cSqlite3Database, "disable_quirk_mode", rb_sqlite3_disable_quirk_mode, 0);
|
902
|
+
rb_define_method(cSqlite3Database, "interrupt", interrupt, 0);
|
903
|
+
rb_define_method(cSqlite3Database, "errmsg", errmsg, 0);
|
904
|
+
rb_define_method(cSqlite3Database, "errcode", errcode_, 0);
|
905
|
+
rb_define_method(cSqlite3Database, "complete?", complete_p, 1);
|
906
|
+
rb_define_method(cSqlite3Database, "changes", changes, 0);
|
907
|
+
rb_define_method(cSqlite3Database, "authorizer=", set_authorizer, 1);
|
908
|
+
rb_define_method(cSqlite3Database, "busy_handler", busy_handler, -1);
|
909
|
+
rb_define_method(cSqlite3Database, "busy_timeout=", set_busy_timeout, 1);
|
910
|
+
#ifndef SQLITE_OMIT_PROGRESS_CALLBACK
|
911
|
+
rb_define_method(cSqlite3Database, "statement_timeout=", set_statement_timeout, 1);
|
912
|
+
#endif
|
913
|
+
rb_define_method(cSqlite3Database, "extended_result_codes=", set_extended_result_codes, 1);
|
914
|
+
rb_define_method(cSqlite3Database, "transaction_active?", transaction_active_p, 0);
|
915
|
+
rb_define_private_method(cSqlite3Database, "exec_batch", exec_batch, 2);
|
916
|
+
rb_define_private_method(cSqlite3Database, "db_filename", db_filename, 1);
|
917
|
+
|
918
|
+
#ifdef HAVE_SQLITE3_LOAD_EXTENSION
|
919
|
+
rb_define_method(cSqlite3Database, "load_extension", load_extension, 1);
|
920
|
+
#endif
|
921
|
+
|
922
|
+
#ifdef HAVE_SQLITE3_ENABLE_LOAD_EXTENSION
|
923
|
+
rb_define_method(cSqlite3Database, "enable_load_extension", enable_load_extension, 1);
|
924
|
+
#endif
|
925
|
+
|
926
|
+
rb_sqlite3_aggregator_init();
|
927
|
+
}
|
928
|
+
|
929
|
+
#ifdef _MSC_VER
|
930
|
+
#pragma warning( pop )
|
931
|
+
#endif
|