Struct PreparedStatement 

pub struct PreparedStatement { /* private fields */ }

A prepared statement for efficient repeated query execution.

Prepared statements allow you to define a query once and execute it multiple times with different parameters. This can improve performance by allowing query plan caching on the server.

Example

let stmt = conn.prepare("MATCH (p:Person {id: $id}) RETURN p").await?;

for id in 1..=100 {
    let mut params = HashMap::new();
    params.insert("id".to_string(), Value::int(id));
    let (page, _) = stmt.execute(&mut conn, &params).await?;
    // Process results...
}

Implementations

impl PreparedStatement

pub fn new(query: impl Into<String>) -> Self

Create a new prepared statement.

Extracts parameter names from the query (tokens starting with $).

pub fn query(&self) -> &str

Get the query string.

pub fn param_names(&self) -> &[String]

Get the parameter names expected by this statement.

pub async fn execute( &self, conn: &mut Connection, params: &HashMap<String, Value>, ) -> Result<(Page, Option<String>)>

Execute the prepared statement with the given parameters.

Arguments

• conn - The connection to execute on
• params - Parameter values (must include all parameters in the query)

Returns

A tuple of (Page, Option<String>) with results and optional warnings.

Errors

Returns an error if required parameters are missing or if the query fails.

Trait Implementations

impl Clone for PreparedStatement

fn clone(&self) -> PreparedStatement

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PreparedStatement

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

Formats the value using the given formatter.