Struct SyncCompletion 

pub struct SyncCompletion<T> { /* private fields */ }

A synchronous completion handler for async FFI callbacks

This type provides a way to block until an async callback completes and retrieve the result. It uses Arc<(Mutex, Condvar)> internally for thread-safe signaling between the callback and the waiting thread.

Implementations

impl<T> SyncCompletion<T>

pub fn new() -> (Self, SyncCompletionPtr)

Create a new completion handler and return the context pointer for FFI

Returns a tuple of (completion, context_ptr) where:

• completion is used to wait for and retrieve the result
• context_ptr should be passed to the FFI callback

pub fn wait(self) -> Result<T, String>

Wait for the completion callback and return the result

This method blocks until the callback signals completion.

Errors

Returns an error string if the callback signaled an error.

Panics

Panics if the internal mutex is poisoned.

pub unsafe fn complete_ok(context: SyncCompletionPtr, value: T)

Signal successful completion with a value

Safety

The context pointer must be a valid pointer obtained from SyncCompletion::new(). This function consumes the Arc reference, so it must only be called once per context.

pub unsafe fn complete_err(context: SyncCompletionPtr, error: String)

Signal completion with an error

Safety

The context pointer must be a valid pointer obtained from SyncCompletion::new(). This function consumes the Arc reference, so it must only be called once per context.

pub unsafe fn complete_with_result( context: SyncCompletionPtr, result: Result<T, String>, )

Signal completion with a result

Safety

The context pointer must be a valid pointer obtained from SyncCompletion::new(). This function consumes the Arc reference, so it must only be called once per context.

Panics

Panics if the internal mutex is poisoned.

impl SyncCompletion<()>

pub extern "C" fn callback( context: *mut c_void, success: bool, msg: *const i8, )

C callback for operations that return (context, success, error_msg)

This can be used directly as an FFI callback function.

Trait Implementations

impl<T> Default for SyncCompletion<T>

fn default() -> Self

Returns the “default value” for a type.