结构体 LocalKey 

pub struct LocalKey<T: 'static> { /* 私有字段 */ }

用于任务本地数据的键。

此类型由 task_local! 宏生成。

与 std::thread::LocalKey, tokio::task::LocalKey 不会在首次访问时惰性初始化该值。而是在包含任务本地的 future 首次由 futures 执行器（如 Tokio）poll 时才初始化该值。

示例

tokio::task_local! {
    static NUMBER: u32;
}

NUMBER.scope(1, async move {
    assert_eq!(NUMBER.get(), 1);
}).await;

NUMBER.scope(2, async move {
    assert_eq!(NUMBER.get(), 2);

    NUMBER.scope(3, async move {
        assert_eq!(NUMBER.get(), 3);
    }).await;
}).await;

实现

impl<T: 'static> LocalKey<T>

pub fn scope<F>(&'static self, value: T, f: F) -> TaskLocalFuture<T, F>

where F: Future,

将值 T 设置为 future F 的任务本地值。

在 scope 完成时，任务本地将被 drop。

恐慌

如果在同一个 LocalKey 上调用 with 或 try_with 时 poll 返回的 future，则对 poll 的调用将发生 panic。

示例

tokio::task_local! {
    static NUMBER: u32;
}

NUMBER.scope(1, async move {
    println!("task local value: {}", NUMBER.get());
}).await;

pub fn sync_scope<F, R>(&'static self, value: T, f: F) -> R

where F: FnOnce() -> R,

将值 T 设置为闭包 F 的任务本地值。

在 sync_scope 完成时，任务本地将被 drop。

恐慌

如果在同一个 LocalKey 上调用 with 或 try_with 时调用此方法，则会发生 panic。

示例

tokio::task_local! {
    static NUMBER: u32;
}

NUMBER.sync_scope(1, || {
    println!("task local value: {}", NUMBER.get());
});

pub fn with<F, R>(&'static self, f: F) -> R

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

访问当前 task-local 并运行所提供的闭包。

恐慌

如果 task local 没有设置值，此函数会发生 panic。

pub fn try_with<F, R>(&'static self, f: F) -> Result<R, AccessError>

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

访问当前 task-local 并运行所提供的闭包。

如果具有关联键的任务本地不存在，则此方法将返回 AccessError。有关 panicking 变体，请参见 with。

impl<T: Clone + 'static> LocalKey<T>

pub fn get(&'static self) -> T

如果 task-local 值实现了 Clone，则返回该值的一份副本。

恐慌

如果 task local 没有设置值，此函数会发生 panic。

pub fn try_get(&'static self) -> Result<T, AccessError>

如果 task-local 值实现了 Clone，则返回该值的一份副本。

如果具有关联键的任务本地不存在，则此方法将返回 AccessError。有关 panicking 变体，请参见 get。

trait 实现

impl<T: 'static> Debug for LocalKey<T>

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

使用给定的格式化器格式化此值。 更多信息