Struct Handler 

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

Heap-allocated, reference-counted holder for a callback the C client keeps and fires later, possibly many times, from the conductor thread.

C is handed a pointer to the value (Handler::as_raw), so the value must outlive C’s use of it. Methods that register a retained callback store a clone in the client’s dependencies: a close is asynchronous, and the conductor may still fire the callback after the resource’s handle has dropped. The clones therefore live until the client drops, one small Arc per registration.

For callbacks C fires only during the call, prefer the *_fn / *_once methods: the closure stays on the stack, may borrow local state, and allocates nothing.

Send when T is; Sync only under the multi-threaded feature, since callbacks fire on the conductor thread.

use rusteron_code_gen::Handler;
let handler = Handler::new(your_value);
// the value is freed when the last clone of `handler` goes out of scope

Implementations

impl<T> Handler<T>

pub fn new(handler: T) -> Self

pub fn as_raw(&self) -> *mut c_void

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

Get a mutable reference to the inner value.

Safety

Caller must ensure that no other references to the inner value are active.

Trait Implementations

impl<T> Clone for Handler<T>

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<T> Deref for Handler<T>

type Target = T

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl<T: Send> Send for Handler<T>