Struct QueryRun 

pub struct QueryRun<'a> {
    pub start: usize,
    pub end: Option<usize>,
    /* private fields */
}

A query run is a slice of query tokens identified by a start and end positions.

Query runs break a query into manageable chunks for efficient matching. They track matchable token positions and support subtraction of matched spans.

Based on Python QueryRun class at: reference/scancode-toolkit/src/licensedcode/query.py (lines 720-914)

Fields

start: usize

end: Option<usize>

Implementations

impl<'a> QueryRun<'a>

pub fn new(query: &'a Query<'a>, start: usize, end: Option<usize>) -> Self

Create a new query run from a query with start and end positions.

Arguments

• query - The parent query
• start - The start position (inclusive)
• end - The end position (inclusive), or None for an empty run

Corresponds to Python: QueryRun.__init__() (lines 735-749)

pub fn get_index(&self) -> &LicenseIndex

Get the license index used by this query run.

pub fn line_for_pos(&self, pos: usize) -> Option<usize>

Get the line number for a specific token position.

Arguments

• pos - Absolute token position in the query

Returns

The line number (1-based), or None if position is out of range

pub fn tokens(&self) -> &[TokenId]

Get the sequence of token IDs for this run.

Returns empty slice if end is None.

Corresponds to Python: tokens property (lines 779-786)

pub fn tokens_with_pos(&self) -> impl Iterator<Item = (usize, TokenId)> + '_

Iterate over token IDs with their absolute positions.

Corresponds to Python: tokens_with_pos() method (lines 788-789)

pub fn is_digits_only(&self) -> bool

Check if this query run contains only digit tokens.

Corresponds to Python: is_digits_only() method (lines 791-796)

pub fn is_matchable( &self, include_low: bool, exclude_positions: &[PositionSpan], ) -> bool

Check if this query run has matchable tokens.

Arguments

• include_low - If true, include low-value tokens in the check
• exclude_positions - Optional set of spans containing positions to exclude

Returns true if there are matchable tokens remaining

Corresponds to Python: is_matchable() method (lines 798-818)

pub fn matchables(&self, include_low: bool) -> BitSet

pub fn matchable_tokens(&self) -> Vec<i32>

pub fn high_matchables(&self) -> BitSet

pub fn low_matchables(&self) -> BitSet

Trait Implementations

impl<'a> Clone for QueryRun<'a>

fn clone(&self) -> QueryRun<'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for QueryRun<'a>

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

Formats the value using the given formatter.