16 unstable releases (6 breaking)

0.11.0 Feb 22, 2024
0.9.4 Dec 29, 2023
0.9.1 Oct 24, 2023
0.8.2 May 11, 2023
0.5.0 Jun 15, 2021

#828 in Magic Beans

Download history 199/week @ 2024-03-14 96/week @ 2024-03-21 92/week @ 2024-03-28 110/week @ 2024-04-04 56/week @ 2024-04-11 68/week @ 2024-04-18 56/week @ 2024-04-25 66/week @ 2024-05-02 147/week @ 2024-05-09 182/week @ 2024-05-16 204/week @ 2024-05-23 290/week @ 2024-05-30 69/week @ 2024-06-06 33/week @ 2024-06-13 100/week @ 2024-06-20 44/week @ 2024-06-27

314 downloads per month
Used in 2 crates (via fluence-spell-dtos)

Apache-2.0/MIT

81KB
1.5K SLoC

SQLite Package Documentation

The package provides an interface to SQLite.

Example

Open a connection, create a table, and insert some rows:

let connection = sqlite::open(":memory:").unwrap();

connection
    .execute(
        "
        CREATE TABLE users (name TEXT, age INTEGER);
        INSERT INTO users VALUES ('Alice', 42);
        INSERT INTO users VALUES ('Bob', 69);
        ",
    )
    .unwrap();

Select some rows and process them one by one as plain text:

connection
    .iterate("SELECT * FROM users WHERE age > 50", |pairs| {
        for &(column, value) in pairs.iter() {
            println!("{} = {}", column, value.unwrap());
        }
        true
    })
    .unwrap();

The same query using a prepared statement, which is much more efficient than the previous technique:

use sqlite::State;

let mut statement = connection
    .prepare("SELECT * FROM users WHERE age > ?")
    .unwrap();

statement.bind(1, 50).unwrap();

while let State::Row = statement.next().unwrap() {
    println!("name = {}", statement.read::<String>(0).unwrap());
    println!("age = {}", statement.read::<i64>(1).unwrap());
}

The same query using a cursor, which is a wrapper around a prepared statement providing the concept of row and featuring all-at-once binding:

use sqlite::Value;

let mut cursor = connection
    .prepare("SELECT * FROM users WHERE age > ?")
    .unwrap()
    .cursor();

cursor.bind(&[Value::Integer(50)]).unwrap();

while let Some(row) = cursor.next().unwrap() {
    println!("name = {}", row[0].as_string().unwrap());
    println!("age = {}", row[1].as_integer().unwrap());
}

Contribution

Your contribution is highly appreciated. Do not hesitate to open an issue or a pull request. Note that any contribution submitted for inclusion in the project will be licensed according to the terms given in LICENSE.md.

Dependencies

~1.8–2.9MB
~56K SLoC