Struct objc2_foundation::MainThreadBound

pub struct MainThreadBound<T>(/* private fields */);

Available on crate features NSThread and dispatch only.

Make a type that can only be used on the main thread be Send + Sync.

On Drop, the inner type is sent to the main thread’s runloop and dropped there. This may lead to deadlocks if the main runloop is not running, or if it is waiting on a lock that the dropping thread is holding. See run_on_main for some of the caveats around that.

Related

This type takes inspiration from threadbound::ThreadBound.

The functionality also somewhat resembles Swift’s @MainActor, which ensures that a type is only usable from the main thread.

Implementations

impl<T> MainThreadBound<T>

Main functionality.

pub fn new(inner: T, _mtm: MainThreadMarker) -> Self

Create a new MainThreadBound value of type T.

Example

use objc2_foundation::{MainThreadMarker, MainThreadBound};

let foo;
let mtm = MainThreadMarker::new().expect("must be on the main thread");
let foo = MainThreadBound::new(foo, mtm);

// `foo` is now `Send + Sync`.

pub fn get(&self, _mtm: MainThreadMarker) -> &T

Returns a reference to the value.

pub fn get_mut(&mut self, _mtm: MainThreadMarker) -> &mut T

Returns a mutable reference to the value.

pub fn into_inner(self, _mtm: MainThreadMarker) -> T

Extracts the value from the MainThreadBound container.

impl<T> MainThreadBound<T>

Helper functions for running run_on_main.

pub fn get_on_main<F, R>(&self, f: F) -> R

where F: Send + FnOnce(&T) -> R, R: Send,

Access the item on the main thread.

See run_on_main for caveats.

pub fn get_on_main_mut<F, R>(&mut self, f: F) -> R

where F: Send + FnOnce(&mut T) -> R, R: Send,

Access the item mutably on the main thread.

See run_on_main for caveats.

Trait Implementations

impl<T> Debug for MainThreadBound<T>

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

Formats the value using the given formatter.

impl<T> Drop for MainThreadBound<T>

fn drop(&mut self)

Executes the destructor for this type.

impl<T> Send for MainThreadBound<T>

impl<T> Sync for MainThreadBound<T>