Struct tokio_current_thread::Handle
source · pub struct Handle { /* private fields */ }
Expand description
Handle to spawn a future on the corresponding CurrentThread
instance
Implementations§
source§impl Handle
impl Handle
sourcepub fn spawn<F>(&self, future: F) -> Result<(), SpawnError>where
F: Future<Item = (), Error = ()> + Send + 'static,
pub fn spawn<F>(&self, future: F) -> Result<(), SpawnError>where
F: Future<Item = (), Error = ()> + Send + 'static,
Spawn a future onto the CurrentThread
instance corresponding to this handle
Panics
This function panics if the spawn fails. Failure occurs if the CurrentThread
instance of the Handle
does not exist anymore.
sourcepub fn status(&self) -> Result<(), SpawnError>
pub fn status(&self) -> Result<(), SpawnError>
Provides a best effort hint to whether or not spawn
will succeed.
This function may return both false positives and false negatives.
If status
returns Ok
, then a call to spawn
will probably
succeed, but may fail. If status
returns Err
, a call to spawn
will
probably fail, but may succeed.
This allows a caller to avoid creating the task if the call to spawn
has a high likelihood of failing.