Struct SyncCompletion 

pub struct SyncCompletion<T: Send + 'static> { /* private fields */ }

A blocking completion handler for asynchronous FFI callbacks.

Implementations

impl<T: Send + 'static> SyncCompletion<T>

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

Create a completion handle and its opaque callback context.

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

Wait until completion or the process-wide default deadline.

Errors

Returns the callback error or a timeout error.

pub fn wait_timeout(self, timeout: Duration) -> Result<T, String>

Wait with an explicit deadline.

Errors

Returns the callback error or a timeout error.

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

Wait without a deadline.

Errors

Returns the callback error.

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

Complete successfully.

Safety

context must be the opaque token returned by Self::new for this concrete T.

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

Complete with an error.

Safety

context must be the opaque token returned by Self::new for this concrete T.

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

Complete with a result.

Duplicate, late, or cancelled callbacks are ignored safely.

Safety

context must be the opaque token returned by Self::new for this concrete T.

impl SyncCompletion<()>

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

C callback for (context, success, error_message) operations.

Trait Implementations

impl<T: Send + 'static> Debug for SyncCompletion<T>

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

Formats the value using the given formatter.

impl<T: Send + 'static> Default for SyncCompletion<T>

fn default() -> Self

Returns the “default value” for a type.

impl<T: Send + 'static> Drop for SyncCompletion<T>

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.