Struct Answer 

pub struct Answer { /* private fields */ }

A complete set of matching situations.

Complete, not ranked: every situation satisfying the query is here, so counting is meaningful. Iterate it directly, or read Answer::ids.

Implementations

impl Answer

pub fn len(&self) -> usize

How many situations matched.

Examples found in repository

examples/quickstart.rs (line 30)

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let docs = [
        "Morty Shade defeated Wallace Gale at Ecruteak City during the Indigo Invitational in 2025.",
        "Bea Strike defeated Iris Draco at Ecruteak City during the Indigo Invitational in 2025.",
        "Juan Tide defeated Cynthia Ward at Ecruteak City during the Indigo Invitational in 2026.",
        "A habitat survey recorded Aggron near Sootopolis City at an elevation of 1082 m.",
        "A habitat survey recorded Salamence near Sootopolis City at an elevation of 2369 m.",
        "A habitat survey recorded Milotic near Sootopolis City at an elevation of 340 m.",
        "Milotic is not permitted in Series 1 play for the 2025 season.",
        "Metagross is permitted in Series 4 play for the 2026 season.",
    ];

    let db = SteelDb::ingest(docs)?;
    println!("indexed {} situations", db.len());

    println!("\nyou can ask about:");
    for c in db.categories() {
        println!("  {:<14} {}", c.wildcard(), c.words.iter().take(4).cloned().collect::<Vec<_>>().join(", "));
    }

    // use a category the corpus actually produced — see the list printed above
    let q = "(and elevation/* (not state/negated))";
    match db.query(q) {
        Ok(a) => {
            println!("\n{q}  ->  {} situations", a.len());
            for (id, text) in db.resolve(&a).take(2) {
                // chars(), not a byte slice: `&text[..n]` panics mid-character
                println!("  [{id}] {}", text.chars().take(56).collect::<String>());
            }
        }
        Err(r) => println!("\n{r}"),
    }

    // a category this corpus does not have — refused, not answered with an empty list
    match db.query("survey/*") {
        Ok(_) => println!("\nunexpected: survey is not a category here"),
        Err(r) => println!("\n{r}"),
    }

    match db.query("gene/brca1") {
        Ok(_) => println!("\nunexpected: that should not exist"),
        Err(r) => println!("\n{r}"),
    }

    println!("\nbelief in a denied claim: {}", db.belief("state/negated"));
    Ok(())
}

pub fn is_empty(&self) -> bool

pub fn ids(&self) -> &[u32]

The matching situation ids, ascending.

pub fn micros(&self) -> f64

Wall-clock microseconds for the bitmap program. Zero on targets without a monotonic clock (wasm).

Trait Implementations

impl Clone for Answer

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Answer

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Answer

fn default() -> Self

Returns the “default value” for a type.

impl IntoIterator for Answer

type Item = u32

The type of the elements being iterated over.

type IntoIter = IntoIter<u32>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl<'a> IntoIterator for &'a Answer

type Item = &'a u32

The type of the elements being iterated over.

type IntoIter = Iter<'a, u32>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.