Struct BindingMailbox 

pub struct BindingMailbox<T>
where
    T: 'static,
{ /* private fields */ }

A handle for interacting with a background mailbox tied to a Binding.

Implementations

impl<T> BindingMailbox<T>

where T: 'static,

pub fn handle(&self, job: impl FnOnce(&mut Binding<T>) + Send + 'static)

Sends a job to be executed with the binding on the background task.

The job will be executed asynchronously and will have access to the binding for reading or modifying its value.

pub async fn get(&self) -> T

where T: Clone + Send,

Gets the current value of the binding asynchronously via the mailbox.

pub async fn get_as<T2>(&self) -> T2

where T2: Send + 'static + From<T>,

Gets the current value of the binding asynchronously and converts it to type T2.

This method retrieves the binding’s value via the mailbox and automatically converts it to the target type using the From trait. This is particularly useful for bindings with non-Send types (like waterui_str::Str) that need to be converted to Send types (like String) for use across async boundaries.

Type Parameters

• T2 - The target type to convert to. Must implement From<T> where T is the binding’s value type.

Examples

// Convert Str binding to String for cross-thread usage  
use nami::{binding, Binding};
use waterui_str::Str;
let text_binding:Binding<Str> = nami::binding("hello world");
let mailbox = text_binding.mailbox();
let owned_string: String = mailbox.get_as().await;
assert_eq!(owned_string, "hello world");

pub async fn set(&self, value: impl Into<T> + Send + 'static)

Sets a new value on the binding asynchronously via the mailbox.

Trait Implementations

impl<T> Debug for BindingMailbox<T>

where T: Debug + 'static,

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

Formats the value using the given formatter.