2015-06-03 22:14:48 -04:00
|
|
|
# SQLite [![Version][version-img]][version-url] [![Status][status-img]][status-url]
|
2015-05-28 17:21:43 -04:00
|
|
|
|
|
|
|
The package provides an interface to [SQLite][1].
|
|
|
|
|
2015-05-28 17:24:45 -04:00
|
|
|
## [Documentation][doc]
|
|
|
|
|
2015-05-29 09:25:39 -04:00
|
|
|
## Example
|
|
|
|
|
|
|
|
```rust
|
2015-07-04 08:53:26 -04:00
|
|
|
let connection = sqlite::open(":memory:").unwrap();
|
2015-06-14 11:37:56 -04:00
|
|
|
|
2015-07-04 09:29:46 -04:00
|
|
|
connection.execute("
|
2015-08-01 16:23:05 -04:00
|
|
|
CREATE TABLE users (id INTEGER, name VARCHAR(255));
|
|
|
|
INSERT INTO users (id, name) VALUES (42, 'Alice');
|
2015-07-04 09:29:46 -04:00
|
|
|
").unwrap();
|
2015-06-14 11:37:56 -04:00
|
|
|
|
2015-08-01 16:23:05 -04:00
|
|
|
connection.process("SELECT * FROM users", |pairs| {
|
2015-06-14 11:37:56 -04:00
|
|
|
for &(column, value) in pairs.iter() {
|
|
|
|
println!("{} = {}", column, value.unwrap());
|
|
|
|
}
|
|
|
|
true
|
|
|
|
}).unwrap();
|
2015-07-30 08:12:43 -04:00
|
|
|
```
|
|
|
|
|
|
|
|
The same example using prepared statements:
|
|
|
|
|
|
|
|
```rust
|
|
|
|
use sqlite::State;
|
|
|
|
|
|
|
|
let connection = sqlite::open(":memory:").unwrap();
|
|
|
|
|
|
|
|
connection.execute("
|
2015-08-01 16:23:05 -04:00
|
|
|
CREATE TABLE users (id INTEGER, name VARCHAR(255))
|
2015-07-30 08:12:43 -04:00
|
|
|
");
|
|
|
|
|
|
|
|
let mut statement = connection.prepare("
|
2015-08-01 16:23:05 -04:00
|
|
|
INSERT INTO users (id, name) VALUES (?, ?)
|
2015-07-30 08:12:43 -04:00
|
|
|
").unwrap();
|
|
|
|
statement.bind(1, 42).unwrap();
|
|
|
|
statement.bind(2, "Alice").unwrap();
|
|
|
|
assert_eq!(statement.step().unwrap(), State::Done);
|
2015-07-04 09:27:13 -04:00
|
|
|
|
2015-08-01 16:23:05 -04:00
|
|
|
let mut statement = connection.prepare("SELECT * FROM users").unwrap();
|
2015-07-30 08:12:43 -04:00
|
|
|
while let State::Row = statement.step().unwrap() {
|
2015-07-04 09:27:13 -04:00
|
|
|
println!("id = {}", statement.read::<i64>(0).unwrap());
|
|
|
|
println!("name = {}", statement.read::<String>(1).unwrap());
|
|
|
|
}
|
2015-05-29 09:25:39 -04:00
|
|
|
```
|
|
|
|
|
2015-05-28 17:21:43 -04:00
|
|
|
## Contributing
|
|
|
|
|
|
|
|
1. Fork the project.
|
|
|
|
2. Implement your idea.
|
|
|
|
3. Open a pull request.
|
|
|
|
|
|
|
|
[1]: https://www.sqlite.org
|
2015-05-28 17:24:45 -04:00
|
|
|
|
2015-07-30 08:15:08 -04:00
|
|
|
[version-img]: http://stainless-steel.github.io/images/crates.svg
|
2015-06-03 22:14:48 -04:00
|
|
|
[version-url]: https://crates.io/crates/sqlite
|
2015-05-28 17:24:45 -04:00
|
|
|
[status-img]: https://travis-ci.org/stainless-steel/sqlite.svg?branch=master
|
|
|
|
[status-url]: https://travis-ci.org/stainless-steel/sqlite
|
|
|
|
[doc]: https://stainless-steel.github.io/sqlite
|