pub fn spawn_local<F>(future: F) -> JoinHandle<<F as Future>::Output> ⓘ
Expand description
Spawns a !Send
future on the current LocalSet
.
The spawned future will run on the same thread that called spawn_local
.
The provided future will start running in the background immediately
when spawn_local
is called, even if you don’t await the returned
JoinHandle
.
§Panics
This function panics if called outside of a LocalSet
.
Note that if tokio::spawn
is used from within a LocalSet
, the
resulting new task will not be inside the LocalSet
, so you must use
spawn_local
if you want to stay within the LocalSet
.
§Examples
use std::rc::Rc;
use tokio::task;
#[tokio::main]
async fn main() {
let nonsend_data = Rc::new("my nonsend data...");
let local = task::LocalSet::new();
// Run the local task set.
local.run_until(async move {
let nonsend_data = nonsend_data.clone();
task::spawn_local(async move {
println!("{}", nonsend_data);
// ...
}).await.unwrap();
}).await;
}