Struct ExprArena 

pub struct ExprArena { /* private fields */ }

An arena-based allocator for EventQL expressions.

The ExprArena provides a memory-efficient way to store and manage AST nodes by using a flat vector and returning lightweight ExprRef handles.

Implementations

impl ExprArena

pub fn alloc(&mut self, attrs: Attrs, value: Value) -> ExprRef

Allocates a new expression in the arena.

This method takes an expression’s attributes and value, hashes the value to create a stable ExprKey, and stores it in the arena. It returns an ExprRef which can be used to retrieve the expression later.

pub fn get(&self, node_ref: ExprRef) -> Expr

Retrieves a node from the arena using an ExprRef.

Panics

Panics if the ExprRef contains an invalid pointer that is out of bounds of the arena’s internal storage.

pub fn alloc_vec(&mut self, values: Vec<ExprRef>) -> VecRef

Allocates a vector of expression references and returns a VecRef handle.

pub fn alloc_rec(&mut self, values: Vec<Field>) -> RecRef

Allocates a vector of record fields and returns a RecRef handle.

pub fn vec(&self, ptr: VecRef) -> &[ExprRef]

Returns the slice of expression references for the given VecRef.

pub fn vec_get(&self, ptr: VecRef, idx: usize) -> ExprRef

Returns the expression reference at index idx within the given VecRef.

pub fn vec_idxes(&self, ptr: VecRef) -> impl Iterator<Item = usize> + use<>

Returns an iterator over valid indices for the given VecRef.

pub fn rec(&self, ptr: RecRef) -> &Vec<Field>

Returns the vector of fields for the given RecRef.

pub fn rec_get(&self, ptr: RecRef, idx: usize) -> Field

Returns the field at index idx within the given RecRef.

pub fn rec_idxes(&self, ptr: RecRef) -> impl Iterator<Item = usize> + use<>

Returns an iterator over valid indices for the given RecRef.

Trait Implementations

impl Default for ExprArena

fn default() -> ExprArena

Returns the “default value” for a type.

impl Serialize for ExprArena

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.