Struct otter_api_tests::imports::failure::_core::lazy::OnceCell [−][src]
pub struct OnceCell<T> { /* fields omitted */ }
once_cell
)Expand description
A cell which can be written to only once.
Unlike RefCell
, a OnceCell
only provides shared &T
references to its value.
Unlike Cell
, a OnceCell
doesn’t require copying or replacing the value to access it.
Examples
#![feature(once_cell)] use std::lazy::OnceCell; let cell = OnceCell::new(); assert!(cell.get().is_none()); let value: &String = cell.get_or_init(|| { "Hello, World!".to_string() }); assert_eq!(value, "Hello, World!"); assert!(cell.get().is_some());
Implementations
🔬 This is a nightly-only experimental API. (once_cell
)
once_cell
)Creates a new empty cell.
🔬 This is a nightly-only experimental API. (once_cell
)
once_cell
)Gets the reference to the underlying value.
Returns None
if the cell is empty.
🔬 This is a nightly-only experimental API. (once_cell
)
once_cell
)Gets the mutable reference to the underlying value.
Returns None
if the cell is empty.
🔬 This is a nightly-only experimental API. (once_cell
)
once_cell
)Sets the contents of the cell to value
.
Errors
This method returns Ok(())
if the cell was empty and Err(value)
if
it was full.
Examples
#![feature(once_cell)] use std::lazy::OnceCell; let cell = OnceCell::new(); assert!(cell.get().is_none()); assert_eq!(cell.set(92), Ok(())); assert_eq!(cell.set(62), Err(62)); assert!(cell.get().is_some());
🔬 This is a nightly-only experimental API. (once_cell
)
once_cell
)Gets the contents of the cell, initializing it with f
if the cell was empty.
Panics
If f
panics, the panic is propagated to the caller, and the cell
remains uninitialized.
It is an error to reentrantly initialize the cell from f
. Doing
so results in a panic.
Examples
#![feature(once_cell)] use std::lazy::OnceCell; let cell = OnceCell::new(); let value = cell.get_or_init(|| 92); assert_eq!(value, &92); let value = cell.get_or_init(|| unreachable!()); assert_eq!(value, &92);
🔬 This is a nightly-only experimental API. (once_cell
)
once_cell
)Gets the contents of the cell, initializing it with f
if
the cell was empty. If the cell was empty and f
failed, an
error is returned.
Panics
If f
panics, the panic is propagated to the caller, and the cell
remains uninitialized.
It is an error to reentrantly initialize the cell from f
. Doing
so results in a panic.
Examples
#![feature(once_cell)] use std::lazy::OnceCell; let cell = OnceCell::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))
🔬 This is a nightly-only experimental API. (once_cell
)
once_cell
)Consumes the cell, returning the wrapped value.
Returns None
if the cell was empty.
Examples
#![feature(once_cell)] use std::lazy::OnceCell; let cell: OnceCell<String> = OnceCell::new(); assert_eq!(cell.into_inner(), None); let cell = OnceCell::new(); cell.set("hello".to_string()).unwrap(); assert_eq!(cell.into_inner(), Some("hello".to_string()));
🔬 This is a nightly-only experimental API. (once_cell
)
once_cell
)Takes the value out of this OnceCell
, moving it back to an uninitialized state.
Has no effect and returns None
if the OnceCell
hasn’t been initialized.
Safety is guaranteed by requiring a mutable reference.
Examples
#![feature(once_cell)] use std::lazy::OnceCell; let mut cell: OnceCell<String> = OnceCell::new(); assert_eq!(cell.take(), None); let mut cell = OnceCell::new(); cell.set("hello".to_string()).unwrap(); assert_eq!(cell.take(), Some("hello".to_string())); assert_eq!(cell.get(), None);
Trait Implementations
Auto Trait Implementations
impl<T> !RefUnwindSafe for OnceCell<T>
impl<T> UnwindSafe for OnceCell<T> where
T: UnwindSafe,
Blanket Implementations
Mutably borrows from an owned value. Read more
pub fn into_any(self: Box<T, Global>) -> Box<dyn Any + 'static, Global>ⓘNotable traits for Box<R, Global>
impl<R> Read for Box<R, Global> where
R: Read + ?Sized, impl<W> Write for Box<W, Global> where
W: Write + ?Sized, impl<I, A> Iterator for Box<I, A> where
A: Allocator,
I: Iterator + ?Sized, type Item = <I as Iterator>::Item;impl<F, A> Future for Box<F, A> where
A: Allocator + 'static,
F: Future + Unpin + ?Sized, type Output = <F as Future>::Output;
pub fn into_any(self: Box<T, Global>) -> Box<dyn Any + 'static, Global>ⓘNotable traits for Box<R, Global>
impl<R> Read for Box<R, Global> where
R: Read + ?Sized, impl<W> Write for Box<W, Global> where
W: Write + ?Sized, impl<I, A> Iterator for Box<I, A> where
A: Allocator,
I: Iterator + ?Sized, type Item = <I as Iterator>::Item;impl<F, A> Future for Box<F, A> where
A: Allocator + 'static,
F: Future + Unpin + ?Sized, type Output = <F as Future>::Output;
Convert Box<dyn Trait>
(where Trait: Downcast
) to Box<dyn Any>
. Box<dyn Any>
can
then be further downcast
into Box<ConcreteType>
where ConcreteType
implements Trait
. Read more
pub fn into_any_rc(self: Rc<T>) -> Rc<dyn Any + 'static>
pub fn into_any_rc(self: Rc<T>) -> Rc<dyn Any + 'static>
Convert Rc<Trait>
(where Trait: Downcast
) to Rc<Any>
. Rc<Any>
can then be
further downcast
into Rc<ConcreteType>
where ConcreteType
implements Trait
. Read more
Convert &Trait
(where Trait: Downcast
) to &Any
. This is needed since Rust cannot
generate &Any
’s vtable from &Trait
’s. Read more
pub fn as_any_mut(&mut self) -> &mut (dyn Any + 'static)
pub fn as_any_mut(&mut self) -> &mut (dyn Any + 'static)
Convert &mut Trait
(where Trait: Downcast
) to &Any
. This is needed since Rust cannot
generate &mut Any
’s vtable from &mut Trait
’s. Read more
impl<A> DynCastExt for A
impl<A> DynCastExt for A
pub fn dyn_cast<T>(
self
) -> Result<<A as DynCastExtHelper<T>>::Target, <A as DynCastExtHelper<T>>::Source> where
T: ?Sized,
A: DynCastExtHelper<T>,
pub fn dyn_cast<T>(
self
) -> Result<<A as DynCastExtHelper<T>>::Target, <A as DynCastExtHelper<T>>::Source> where
T: ?Sized,
A: DynCastExtHelper<T>,
Use this to cast from one trait object type to another. Read more
pub fn dyn_upcast<T>(self) -> <A as DynCastExtAdvHelper<T, T>>::Target where
T: ?Sized,
A: DynCastExtAdvHelper<T, T, Source = <A as DynCastExtAdvHelper<T, T>>::Target>,
pub fn dyn_upcast<T>(self) -> <A as DynCastExtAdvHelper<T, T>>::Target where
T: ?Sized,
A: DynCastExtAdvHelper<T, T, Source = <A as DynCastExtAdvHelper<T, T>>::Target>,
Use this to upcast a trait to one of its supertraits. Read more
pub fn dyn_cast_adv<F, T>(
self
) -> Result<<A as DynCastExtAdvHelper<F, T>>::Target, <A as DynCastExtAdvHelper<F, T>>::Source> where
T: ?Sized,
A: DynCastExtAdvHelper<F, T>,
F: ?Sized,
pub fn dyn_cast_adv<F, T>(
self
) -> Result<<A as DynCastExtAdvHelper<F, T>>::Target, <A as DynCastExtAdvHelper<F, T>>::Source> where
T: ?Sized,
A: DynCastExtAdvHelper<F, T>,
F: ?Sized,
pub fn dyn_cast_with_config<C>(
self
) -> Result<<A as DynCastExtAdvHelper<<C as DynCastConfig>::Source, <C as DynCastConfig>::Target>>::Target, <A as DynCastExtAdvHelper<<C as DynCastConfig>::Source, <C as DynCastConfig>::Target>>::Source> where
C: DynCastConfig,
A: DynCastExtAdvHelper<<C as DynCastConfig>::Source, <C as DynCastConfig>::Target>,
pub fn dyn_cast_with_config<C>(
self
) -> Result<<A as DynCastExtAdvHelper<<C as DynCastConfig>::Source, <C as DynCastConfig>::Target>>::Target, <A as DynCastExtAdvHelper<<C as DynCastConfig>::Source, <C as DynCastConfig>::Target>>::Source> where
C: DynCastConfig,
A: DynCastExtAdvHelper<<C as DynCastConfig>::Source, <C as DynCastConfig>::Target>,
Use this to cast from one trait object type to another. With this method the type parameter is a config type that uniquely specifies which cast should be preformed. Read more
Compare self to key
and return true
if they are equal.
fn instrument(self, span: Span) -> Instrumented<Self>ⓘNotable traits for Instrumented<T>
impl<T> Future for Instrumented<T> where
T: Future, type Output = <T as Future>::Output;
[src]
fn instrument(self, span: Span) -> Instrumented<Self>ⓘNotable traits for Instrumented<T>
impl<T> Future for Instrumented<T> where
T: Future, type Output = <T as Future>::Output;
[src]Instruments this type with the provided Span
, returning an
Instrumented
wrapper. Read more
fn in_current_span(self) -> Instrumented<Self>ⓘNotable traits for Instrumented<T>
impl<T> Future for Instrumented<T> where
T: Future, type Output = <T as Future>::Output;
[src]
fn in_current_span(self) -> Instrumented<Self>ⓘNotable traits for Instrumented<T>
impl<T> Future for Instrumented<T> where
T: Future, type Output = <T as Future>::Output;
[src]pub fn vzip(self) -> V