Struct QueryResult 

pub struct QueryResult {
    pub columns: Vec<String>,
    pub column_types: Vec<LogicalType>,
    pub rows: Vec<Vec<Value>>,
    pub execution_time_ms: Option<f64>,
    pub rows_scanned: Option<u64>,
    pub status_message: Option<String>,
    pub gql_status: GqlStatus,
}

The result of running a query.

Contains rows and columns, like a table. Use iter() to loop through rows, or scalar() if you expect a single value.

Examples

use grafeo_engine::GrafeoDB;

let db = GrafeoDB::new_in_memory();
db.create_node(&["Person"]);

let result = db.execute("MATCH (p:Person) RETURN count(p) AS total")?;

// Check what we got
println!("Columns: {:?}", result.columns);
println!("Rows: {}", result.row_count());

// Iterate through results
for row in result.iter() {
    println!("{:?}", row);
}

Fields

columns: Vec<String>

Column names from the RETURN clause.

column_types: Vec<LogicalType>

Column types - useful for distinguishing NodeId/EdgeId from plain integers.

rows: Vec<Vec<Value>>

The actual result rows.

execution_time_ms: Option<f64>

Query execution time in milliseconds (if timing was enabled).

rows_scanned: Option<u64>

Number of rows scanned during query execution (estimate).

status_message: Option<String>

Status message for DDL and session commands (e.g., “Created node type ‘Person’”).

gql_status: GqlStatus

GQLSTATUS code per ISO/IEC 39075:2024, sec 23.

Implementations

impl QueryResult

pub fn empty() -> Self

Creates a fully empty query result (no columns, no rows).

pub fn status(msg: impl Into<String>) -> Self

Creates a query result with only a status message (for DDL commands).

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

Creates a new empty query result.

pub fn with_types(columns: Vec<String>, column_types: Vec<LogicalType>) -> Self

Creates a new empty query result with column types.

pub fn with_metrics(self, execution_time_ms: f64, rows_scanned: u64) -> Self

Sets the execution metrics on this result.

pub fn execution_time_ms(&self) -> Option<f64>

Returns the execution time in milliseconds, if available.

pub fn rows_scanned(&self) -> Option<u64>

Returns the number of rows scanned, if available.

pub fn row_count(&self) -> usize

Returns the number of rows.

pub fn column_count(&self) -> usize

Returns the number of columns.

pub fn is_empty(&self) -> bool

Returns true if the result is empty.

pub fn scalar<T: FromValue>(&self) -> Result<T>

Extracts a single value from the result.

Use this when your query returns exactly one row with one column, like RETURN count(n) or RETURN sum(p.amount).

Errors

Returns an error if the result has multiple rows or columns.

pub fn iter(&self) -> impl Iterator<Item = &Vec<Value>>

Returns an iterator over the rows.

Trait Implementations

impl Debug for QueryResult

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

Formats the value using the given formatter.