class SQLite

Provides access to the SQLite database system.

A companion object, SQLResult, is required for most database operations.

SQLite is not yet supported in the v8 engine.

Constructors

new SQLite();

Constructs a new instance of the SQLite class

All future calls to the database will be through this instance of the object.

Methods

begintransaction

Start an SQL transaction on the database

This allows you to batch database updates and to roll back sets of changes if they do not all complete. When you are done with batch updates, a call to SQLite.endtransaction() should be executed.

begintransaction(): void;

close

Close a previously opened SQLite database

close(): void;

endtransaction

Complete a transaction and flush all database writes to the file

endtransaction(): void;

exec

Perform an SQL command on the database

This command must be in standard SQL language syntax, limited to the operations that SQLite supports.

exec(command: string, result: SQLResult): number;
NameTypeDescription
commandstringSQL command
resultSQLResultSQLResult object to populate with transaction results
Return Valuenumberan error code if unsuccessful or zero if the call results in a completed operation

Example

var res = new SQLResult;
var rtn = sqlite.exec(“CREATE TABLE Persons (PersonID INTEGER, LastName TEXT, FirstName TEXT);”, res);

open

Open an SQLite-format file for database operations

open(filename: string, on_disk?: number, must_exist?: number): number;
NameTypeDescription
filenamestringFile to access
optional on_disknumberIf the file should be memory-based (0) or disk-based (1)
optional must_existnumberIf non-zero, requires the file to exist to be opened, otherwise, a file will be created if one does not exist.
Return Valuenumberan error code if unsuccessful or zero if the call results in an opened database