Struct OnceInit 

pub struct OnceInit<T: ?Sized + 'static>
where
    &'static T: Sized,
{ /* private fields */ }

OnceInit

仅可设置一次数据的类型。

当 T 实现了 Sync 时，该类型也会实现 Sync. Sync 是由内部原子类型的 state 和外部 api 共同保证的。 外部 api 保证，当 state 指示数据正在或已经初始化时，该类型不可变。

Implementations

impl<T: ?Sized> OnceInit<T>

pub const fn uninit() -> Self

返回未初始化的 OnceInit 类型。

pub const fn new(data: &'static T) -> Self

where &'static T: Sized, Self: Sized,

返回初始化过的 OnceInit 类型。

pub fn get(&self) -> Result<&'static T, OnceInitError>

返回内部数据，若未初始化，则返回 OnceInitError.

若需要可变数据，请在内部使用具有内部可见性的数据结构，如 Mutex 等。

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

where T: StaticDefault,

返回内部数据，若未初始化，则返回 <T as StaticDefault>::static_default().

需要 T 实现 StaticDefault.

pub unsafe fn get_unchecked(&self) -> &'static T

不检查是否初始化，直接返回内部数据。

若需要可变数据，请在内部使用具有内部可见性的数据结构，如 Mutex 等。

Safety

未初始化时，调用此函数会在内部的 None 值上调用 Option::unwrap_unchecked, 造成未定义行为。

pub fn state(&self) -> OnceInitState

返回数据状态，见 OnceInitState.

pub fn init(&self, data: &'static T) -> Result<(), OnceInitError>

初始化内部数据，只可调用一次，成功则初始化完成，之后调用均会返回错误。

如果 data 不是 'static 的，请使用 init_boxed.

pub fn init_boxed(&self, data: Box<T>) -> Result<(), OnceInitError>

初始化内部数据，只可调用一次，成功则初始化完成，之后调用均会返回错误。

Trait Implementations

impl<T: ?Sized + Debug> Debug for OnceInit<T>

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

Formats the value using the given formatter.

impl<T> Default for OnceInit<T>

where T: ?Sized + StaticDefault, Self: Sized,

fn default() -> Self

Returns the “default value” for a type.

impl<T: ?Sized + StaticDefault> Deref for OnceInit<T>

type Target = T

The resulting type after dereferencing.

fn deref(&self) -> &'static Self::Target

Dereferences the value.

impl<T: ?Sized> UninitGlobalHolder<T> for OnceInit<T>

fn init(&self, data: &'static T) -> Result<(), OnceInitError>

初始化内部数据，只可调用一次，成功则初始化完成，之后调用均会返回错误。

如果 data 不是 'static 的，请使用 init_boxed.

fn init_boxed(&self, data: Box<T>) -> Result<(), OnceInitError>

初始化内部数据，只可调用一次，成功则初始化完成，之后调用均会返回错误。

impl<T> Sync for OnceInit<T>

where T: ?Sized + Sync,