summaryrefslogtreecommitdiff
path: root/sqlite3/README
blob: d1094dddf224770d81911b513f6f9242ee4153fb (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
Full sqlite3 Extension for Jim Tcl
==================================

Author: Steve Bennett <steveb@workware.net.au>
Date: Thu 24 Nov 2011

This directory builds a Jim Tcl extension containing a complete sqlite3 implementation and binding.

Building
--------

Ensure that you have configured and built jim in the source directory, then:

$ make

./build-ext -o sqlite3.so -I.. -L.. -DSQLITE_OMIT_LOAD_EXTENSION=1 ... jim-sqlite3.c sqlite3.c
Building sqlite3.so from jim-sqlite3.c sqlite3.c

Warning: libjim is static. Dynamic module may not work on some platforms.

Compile: jim-sqlite3.o
Compile: sqlite3.o
Link:    sqlite3.so

Success!

Testing
-------

$ make test

Installing
----------

Copy sqlite3.so to your jim library directory, typically /usr/local/lib/jim or
where $JIMLIB points to.

Using
-----
In your Jim Tcl code, ensure that sqlite3.so is in a directory on $auto_path.
Then:

  package require sqlite3

  sqlite3 db test.db
  ...etc..

Documentation
-------------

The Jim Tcl binding is almost exactly identical to the Tcl binding.
See http://www.sqlite.org/tclsqlite.html for documentation.

Differences:
- INCRBLOB is not supported as Jim Tcl does not support channels
- No attempt is made to change encoding between Jim Tcl and sqlite
- Jim Tcl doesn't differentiate between binary data (bytearray) and
  string, so only the @field syntax causes a fieldsto be bound
  as a blob rather than text.
- Jim Tcl doesn't have a boolean type