Struct QueryResult 

pub struct QueryResult {
    pub columns: Vec<String>,
    pub rows: Vec<Row>,
    /* private fields */
}

Query result containing column names and rows.

Invariant: rows.len() == row_group_keys.len(). Always. Mutating either field directly will violate this; use the helper methods (add_row, add_aggregate_row, truncate, sort_by, etc.) that keep both vectors in lockstep. The invariant is enforced at runtime with assert_eq! inside sort_by.

Fields

columns: Vec<String>

Column names.

rows: Vec<Row>

Result rows.

Implementations

impl QueryResult

pub const fn new(columns: Vec<String>) -> Self

Create a new empty result.

pub fn add_row(&mut self, row: Row)

Add a row to the result with no GROUP BY context (non-aggregate path). The sidecar (row_group_keys) records None for this row, so the text renderer applies no per-currency quantization (issue #988). Aggregate paths must use Self::add_aggregate_row instead.

pub fn add_aggregate_row(&mut self, row: Row, group_key: Vec<Value>)

Add a row produced by aggregation, recording the GROUP BY key values alongside it. The renderer consults the key to quantize numeric aggregates against the per-currency display precision (issue #988).

Multi-column GROUP BY note: when several columns are grouped (e.g. GROUP BY account, currency), the entire key is preserved here. The renderer’s currency-hint extraction (currency_hint_for_row in rustledger/src/cmd/query/output.rs) takes the first currency-shaped string in iteration order — so put the currency column first if both are currency-shaped, which is rare in practice but possible.

pub fn group_key(&self, row_idx: usize) -> Option<&[Value]>

Get the GROUP BY key for a given row, if it was produced by aggregation. Returns None for non-aggregate rows or when the row index is out of range. This is the public read-side of the row_group_keys sidecar — prefer it over reaching into the field directly.

Returns &[Value] rather than &Vec<Value> so callers aren’t tied to the specific container type.

pub fn has_aggregate_rows(&self) -> bool

Whether any row in the result was produced by aggregation. Lets downstream renderers short-circuit per-row hint lookups when the cache would be all None anyway (issue #988 follow-up).

pub fn truncate(&mut self, len: usize)

Truncate to the first len rows, keeping row_group_keys in lockstep so the parallel-vector invariant survives LIMIT.

pub fn sort_by<F>(&mut self, compare: F)

where F: FnMut(&Row, &Row) -> Ordering,

Sort rows by a comparator, keeping row_group_keys in lockstep. Pair-sort prevents the sidecar from desynchronizing after ORDER BY (otherwise text rendering would apply the wrong currency hint to a row).

pub const fn len(&self) -> usize

Number of rows.

pub const fn is_empty(&self) -> bool

Whether the result is empty.

Trait Implementations

impl Clone for QueryResult

fn clone(&self) -> QueryResult

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for QueryResult

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

Formats the value using the given formatter.