Struct LkQuery

pub struct LkQuery(/* private fields */);

A set of predicates and options used to select a range of packets

The supported predicate fields are PredicateType. The known options are KnownOptions.

// Add multiple predicates and options at once.
let query_str = r#"
  group = [#:pub]
  domain = [a:hello]
  prefix = /some/path
"#;
let mut query = lkq_new(&query_str,&())?;

// the domain:group:prefix is so common it has an allias [lkq_space]

// As these are AB-Expressions they are evaluated in the [UserScope] context
lkq_add_mut(&mut query,"prefix = /some/[0]",&[b"path" as &[u8]])?;

{
   // add the predicate that the stamp should hold a value less 100
   let mut query_with_stamp = lkq_add(&query, &"stamp < [u64:100]",&())?;
   // conflicting predicates are not allowed
   let result = lkq_add_mut(&mut query_with_stamp, &"stamp > [u64:100]",&());
   assert!( result.is_err());
}

// When adding only a single predicate you might be able to avoid an encoding step
lkq_insert_mut(&mut query,"stamp","<", &*now())?;
// Predicates get merged if they overlap
lkq_insert_mut(&mut query,"stamp","<",&lka_eval("[now:-1D]",&())?)?;

println!("{}",&lkq_stringify(&query,false));

Unlike predicates, the order in which options are can matter.

Trait Implementations

impl Clone for LkQuery

fn clone(&self) -> LkQuery

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for LkQuery

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

Formats the value using the given formatter.

impl Default for LkQuery

fn default() -> LkQuery

Returns the “default value” for a type.

impl Display for LkQuery

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

Formats the value using the given formatter.

impl PartialEq for LkQuery

fn eq(&self, other: &LkQuery) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Stmnts for LkQuery

fn per_line( &self, per_line: &mut dyn FnMut(&[u8]) -> LkResult<()>, ) -> LkResult<()>

impl StructuralPartialEq for LkQuery