Struct AnalyticsContext 

pub struct AnalyticsContext { /* private fields */ }

Context for analytics operations with grouped buffer lifecycle.

All buffers allocated through this context are released together when the context is dropped. This is useful for analytics operations that need multiple temporary buffers.

Thread Safety

AnalyticsContext is Send but not Sync. Each context should be used from a single thread. For parallel analytics, create a separate context per thread.

Implementations

impl AnalyticsContext

pub fn new(name: impl Into<String>) -> AnalyticsContext

Create a new analytics context.

Arguments

• name - Descriptive name for debugging and profiling

pub fn with_capacity( name: impl Into<String>, expected_allocations: usize, ) -> AnalyticsContext

Create a context with pre-allocated capacity.

Reserves space for the expected number of allocations to avoid reallocations of the internal vectors.

pub fn name(&self) -> &str

Get the context name.

pub fn allocate(&mut self, size: usize) -> AllocationHandle

Allocate a buffer of the specified size.

Returns a handle that can be used with get() and get_mut().

Arguments

• size - Size in bytes

Returns

Handle to the allocated buffer

pub fn allocate_typed<T>(&mut self, count: usize) -> AllocationHandle

where T: Copy + Default + 'static,

Allocate a typed buffer.

Allocates space for count elements of type T, zero-initialized.

Arguments

• count - Number of elements

Returns

Handle to the allocated buffer

Type Parameters

• T - Element type (must be Copy and have a meaningful zero value)

pub fn get(&self, handle: AllocationHandle) -> &[u8]

Get a reference to an allocated buffer.

Arguments

• handle - Handle returned from allocate() or allocate_typed()

Panics

Panics if the handle is invalid.

pub fn get_mut(&mut self, handle: AllocationHandle) -> &mut [u8]

Get a mutable reference to an allocated buffer.

Arguments

• handle - Handle returned from allocate() or allocate_typed()

Panics

Panics if the handle is invalid.

pub fn get_typed<T>(&self, handle: AllocationHandle) -> &[T]

where T: Copy,

Get a typed reference to an allocated buffer.

Safety

The caller must ensure the buffer was allocated with the correct type and size using allocate_typed::<T>().

Panics

Panics if the handle is invalid.

pub fn get_typed_mut<T>(&mut self, handle: AllocationHandle) -> &mut [T]

where T: Copy,

Get a mutable typed reference to an allocated buffer.

Safety

The caller must ensure the buffer was allocated with the correct type and size using allocate_typed::<T>().

Panics

Panics if the handle is invalid.

pub fn try_get(&self, handle: AllocationHandle) -> Option<&[u8]>

Try to get a reference to an allocated buffer.

Returns None if the handle is invalid.

pub fn try_get_mut(&mut self, handle: AllocationHandle) -> Option<&mut [u8]>

Try to get a mutable reference to an allocated buffer.

Returns None if the handle is invalid.

pub fn allocation_size(&self, handle: AllocationHandle) -> usize

Get the size of an allocation.

Panics

Panics if the handle is invalid.

pub fn allocation_count(&self) -> usize

Get the number of allocations in this context.

pub fn stats(&self) -> &ContextStats

Get statistics for this context.

pub fn release_all(&mut self)

Release all allocations and reset the context.

After calling this, all handles become invalid.

pub fn sub_context(&self, name: impl Into<String>) -> AnalyticsContext

Create a sub-context for a nested operation.

The sub-context shares no allocations with the parent.

Trait Implementations

impl Drop for AnalyticsContext

fn drop(&mut self)

Executes the destructor for this type.