Struct PooledInstance 

pub struct PooledInstance<T, E>
where
    T: Send + 'static,
    E: PoolResourceLimit + Send + Sync + 'static,
{ /* private fields */ }

RAII handle to an instance acquired from an InstancePool.

Holds the fresh instance and frees its concurrency slot on drop (dropping the instance — never recycling it). Adapters use this to make “acquire-call-drop” exception-safe: if the plugin call panics or traps, the slot still frees and the (possibly poisoned) instance is discarded.

Implementations

impl<T, E> PooledInstance<T, E>

where T: Send + 'static, E: PoolResourceLimit + Send + Sync + 'static,

pub fn acquire(pool: Arc<InstancePool<T, E>>) -> Result<Self, E>

Acquire a fresh PooledInstance from the pool.

Errors

Propagates InstancePool::acquire.

pub fn get_mut(&mut self) -> &mut T

Mutable access to the instance.

Panics

If called after Self::take.

pub fn take(self) -> T

Consume the wrapper, returning the inner instance without freeing its concurrency slot via the pool.

Retained for API compatibility. With per-invoke instances there is no “corrupted vs clean” distinction at the pool level (a dropped instance is always discarded), but take still moves the instance out and decrements the live counter so callers that need ownership keep working.

Trait Implementations

impl<T, E> Debug for PooledInstance<T, E>

where T: Send + 'static, E: PoolResourceLimit + Send + Sync + 'static,

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

Formats the value using the given formatter.

impl<T, E> Drop for PooledInstance<T, E>

where T: Send + 'static, E: PoolResourceLimit + Send + Sync + 'static,

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.