Struct std::sync::OnceLock

1.70.0 · source ·
pub struct OnceLock<T> { /* private fields */ }
Expand description

只能写入一次的同步原语。

此类型是线程安全的 OnceCell,可用于静态。

Examples

use std::sync::OnceLock;

static CELL: OnceLock<String> = OnceLock::new();
assert!(CELL.get().is_none());

std::thread::spawn(|| {
    let value: &String = CELL.get_or_init(|| {
        "Hello, World!".to_string()
    });
    assert_eq!(value, "Hello, World!");
}).join().unwrap();

let value: Option<&String> = CELL.get();
assert!(value.is_some());
assert_eq!(value.unwrap().as_str(), "Hello, World!");
Run

Implementations§

source§

impl<T> OnceLock<T>

const: 1.70.0 · source

pub const fn new() -> OnceLock<T>

创建一个新的空 cell。

source

pub fn get(&self) -> Option<&T>

获取对底层值的引用。

如果 cell 为空或正在初始化,则返回 None。 此方法永远不会阻塞。

source

pub fn get_mut(&mut self) -> Option<&mut T>

获取对底层值的可变引用。

如果 cell 为空,则返回 None。此方法永远不会阻塞。

source

pub fn set(&self, value: T) -> Result<(), T>

将此 cell 的内容设置为 value

如果另一个线程当前正在尝试初始化该 cell,则可能会阻塞。 尽管 set 不一定返回,但保证该 cell 包含一个值。

如果此调用设置了 cell 的值,则返回 Ok(())

Examples
use std::sync::OnceLock;

static CELL: OnceLock<i32> = OnceLock::new();

fn main() {
    assert!(CELL.get().is_none());

    std::thread::spawn(|| {
        assert_eq!(CELL.set(92), Ok(()));
    }).join().unwrap();

    assert_eq!(CELL.set(62), Err(62));
    assert_eq!(CELL.get(), Some(&92));
}
Run
source

pub fn get_or_init<F>(&self, f: F) -> &Twhere F: FnOnce() -> T,

获取 cell 的内容,如果 cell 为空,则使用 f 对其进行初始化。

许多线程可以使用不同的初始化函数并发调用 get_or_init,但是可以保证仅执行一个函数。

Panics

如果 f panics,则 panic 会传播给调用者,并且 cell 仍保持未初始化状态。

重新从 f 初始化 cell 是错误的。确切的结果是不确定的。 当前的实现死锁,但是可以在 future 中将其更改为 panic。

Examples
use std::sync::OnceLock;

let cell = OnceLock::new();
let value = cell.get_or_init(|| 92);
assert_eq!(value, &92);
let value = cell.get_or_init(|| unreachable!());
assert_eq!(value, &92);
Run
source

pub fn get_or_try_init<F, E>(&self, f: F) -> Result<&T, E>where F: FnOnce() -> Result<T, E>,

🔬This is a nightly-only experimental API. (once_cell_try #109737)

获取 cell 的内容,如果 cell 为空,则使用 f 对其进行初始化。 如果 cell 为空并且 f 失败,则返回错误。

Panics

如果 f panics,则 panic 会传播给调用者,并且 cell 仍保持未初始化状态。

重新从 f 初始化 cell 是错误的。 确切的结果是不确定的。 当前的实现死锁,但是可以在 future 中将其更改为 panic。

Examples
#![feature(once_cell_try)]

use std::sync::OnceLock;

let cell = OnceLock::new();
assert_eq!(cell.get_or_try_init(|| Err(())), Err(()));
assert!(cell.get().is_none());
let value = cell.get_or_try_init(|| -> Result<i32, ()> {
    Ok(92)
});
assert_eq!(value, Ok(&92));
assert_eq!(cell.get(), Some(&92))
Run
source

pub fn into_inner(self) -> Option<T>

使用 OnceLock,返回包装后的值。 如果 cell 为空,则返回 None

Examples
use std::sync::OnceLock;

let cell: OnceLock<String> = OnceLock::new();
assert_eq!(cell.into_inner(), None);

let cell = OnceLock::new();
cell.set("hello".to_string()).unwrap();
assert_eq!(cell.into_inner(), Some("hello".to_string()));
Run
source

pub fn take(&mut self) -> Option<T>

从此 OnceLock 中取出值,将其移回未初始化状态。

如果 OnceLock 尚未初始化,则无效并返回 None

通过要求可变引用来保证安全。

Examples
use std::sync::OnceLock;

let mut cell: OnceLock<String> = OnceLock::new();
assert_eq!(cell.take(), None);

let mut cell = OnceLock::new();
cell.set("hello".to_string()).unwrap();
assert_eq!(cell.take(), Some("hello".to_string()));
assert_eq!(cell.get(), None);
Run

Trait Implementations§

source§

impl<T: Clone> Clone for OnceLock<T>

source§

fn clone(&self) -> OnceLock<T>

返回值的副本。 Read more
1.0.0 · source§

fn clone_from(&mut self, source: &Self)

source 执行复制分配。 Read more
source§

impl<T: Debug> Debug for OnceLock<T>

source§

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

使用给定的格式化程序格式化该值。 Read more
source§

impl<T> Default for OnceLock<T>

source§

fn default() -> OnceLock<T>

创建一个新的空 cell。

Example
use std::sync::OnceLock;

fn main() {
    assert_eq!(OnceLock::<()>::new(), OnceLock::default());
}
Run
source§

impl<T> Drop for OnceLock<T>

source§

fn drop(&mut self)

执行此类型的析构函数。 Read more
source§

impl<T> From<T> for OnceLock<T>

source§

fn from(value: T) -> Self

创建一个新的 cell,其内容设置为 value

Example
use std::sync::OnceLock;

let a = OnceLock::from(3);
let b = OnceLock::new();
b.set(3)?;
assert_eq!(a, b);
Ok(())
Run
source§

impl<T: PartialEq> PartialEq<OnceLock<T>> for OnceLock<T>

source§

fn eq(&self, other: &OnceLock<T>) -> bool

此方法测试 selfother 值是否相等,并由 == 使用。
1.0.0 · source§

fn ne(&self, other: &Rhs) -> bool

此方法测试 !=。 默认实现几乎总是足够的,并且不应在没有充分理由的情况下被覆盖。
source§

impl<T: Eq> Eq for OnceLock<T>

source§

impl<T: RefUnwindSafe + UnwindSafe> RefUnwindSafe for OnceLock<T>

source§

impl<T: Send> Send for OnceLock<T>

source§

impl<T: Sync + Send> Sync for OnceLock<T>

source§

impl<T: UnwindSafe> UnwindSafe for OnceLock<T>

Auto Trait Implementations§

§

impl<T> Unpin for OnceLock<T>where T: Unpin,

Blanket Implementations§

source§

impl<T> Any for Twhere T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

获取 selfTypeIdRead more
source§

impl<T> Borrow<T> for Twhere T: ?Sized,

source§

fn borrow(&self) -> &T

从拥有的值中一成不变地借用。 Read more
source§

impl<T> BorrowMut<T> for Twhere T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

从拥有的值中借用。 Read more
source§

impl<T> From<!> for T

source§

fn from(t: !) -> T

从输入类型转换为此类型。
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

返回未更改的参数。

source§

impl<T, U> Into<U> for Twhere U: From<T>,

source§

fn into(self) -> U

调用 U::from(self)

也就是说,这种转换是 From<T> for U 实现选择执行的任何操作。

source§

impl<T> ToOwned for Twhere T: Clone,

§

type Owned = T

获得所有权后的结果类型。
source§

fn to_owned(&self) -> T

从借用的数据创建拥有的数据,通常是通过克隆。 Read more
source§

fn clone_into(&self, target: &mut T)

使用借来的数据来替换拥有的数据,通常是通过克隆。 Read more
source§

impl<T, U> TryFrom<U> for Twhere U: Into<T>,

§

type Error = Infallible

发生转换错误时返回的类型。
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

执行转换。
source§

impl<T, U> TryInto<U> for Twhere U: TryFrom<T>,

§

type Error = <U as TryFrom<T>>::Error

发生转换错误时返回的类型。
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

执行转换。