Enum FindMatchesResult 

pub enum FindMatchesResult {
    Ready(ReadyResult),
    AsyncSession(AsyncSessionResult),
}

Result of a find_matches operation.

This enum has two variants:

• Ready: Immediate result when no async work is needed (local search with Hold mode)
• AsyncSession: When staging or remote search is required

Variants

Ready(ReadyResult)

Immediate result - blocks are held in place without staging.

Returned when search_remote == false AND staging_mode == Hold. Blocks remain in their original tiers (G2 or G3) on the local instance.

AsyncSession(AsyncSessionResult)

Async session for staging and/or remote search.

Returned when:

• search_remote == true (remote searching enabled)
• OR staging_mode is Prepare or Full (local/remote staging)

Implementations

impl FindMatchesResult

pub fn is_ready(&self) -> bool

Check if this is a ready (immediate) result.

pub fn is_async(&self) -> bool

Check if this is an async session result.

pub fn as_ready(&self) -> Option<&ReadyResult>

Get the ready result, if this is a Ready variant.

pub fn as_ready_mut(&mut self) -> Option<&mut ReadyResult>

Get the ready result mutably, if this is a Ready variant.

pub fn as_async(&self) -> Option<&AsyncSessionResult>

Get the async session result, if this is an AsyncSession variant.

pub fn as_async_mut(&mut self) -> Option<&mut AsyncSessionResult>

Get the async session result mutably, if this is an AsyncSession variant.

pub fn g2_count(&self) -> usize

Get the number of G2 blocks available or matched.

For Ready: returns the count of blocks held. For AsyncSession: returns the count if blocks are available, 0 otherwise.

pub fn take_g2_blocks(&mut self) -> Option<Vec<ImmutableBlock<G2>>>

Take ownership of G2 blocks if available.

For Ready: always succeeds, returns the blocks. For AsyncSession: returns Some if blocks are available and lock succeeds.

pub fn session_id(&self) -> Option<SessionId>

pub fn wait_for_completion( &self, ) -> Either<Ready<Result<()>>, BoxFuture<'static, Result<()>>>

Wait for the operation to complete.

For Ready variant: returns immediately with Ok(()). For AsyncSession variant: waits for terminal status (Complete/Holding/Prepared).

Returns an Either future that can be used with tokio::select!.

Trait Implementations

impl Debug for FindMatchesResult

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

Formats the value using the given formatter.