mirror of
https://github.com/rust-lang/rust.git
synced 2024-10-30 22:12:15 +00:00
Auto merge of #105587 - tgross35:once-cell-min, r=m-ou-se
Partial stabilization of `once_cell` This PR aims to stabilize a portion of the `once_cell` feature: - `core::cell::OnceCell` - `std::cell::OnceCell` (re-export of the above) - `std::sync::OnceLock` This will leave `LazyCell` and `LazyLock` unstabilized, which have been moved to the `lazy_cell` feature flag. Tracking issue: https://github.com/rust-lang/rust/issues/74465 (does not fully close, but it may make sense to move to a new issue) Future steps for separate PRs: - ~~Add `#[inline]` to many methods~~ #105651 - Update cranelift usage of the `once_cell` crate - Update rust-analyzer usage of the `once_cell` crate - Update error messages discussing once_cell ## To be stabilized API summary ```rust // core::cell (in core/cell/once.rs) pub struct OnceCell<T> { .. } impl<T> OnceCell<T> { pub const fn new() -> OnceCell<T>; pub fn get(&self) -> Option<&T>; pub fn get_mut(&mut self) -> Option<&mut T>; pub fn set(&self, value: T) -> Result<(), T>; pub fn get_or_init<F>(&self, f: F) -> &T where F: FnOnce() -> T; pub fn into_inner(self) -> Option<T>; pub fn take(&mut self) -> Option<T>; } impl<T: Clone> Clone for OnceCell<T>; impl<T: Debug> Debug for OnceCell<T> impl<T> Default for OnceCell<T>; impl<T> From<T> for OnceCell<T>; impl<T: PartialEq> PartialEq for OnceCell<T>; impl<T: Eq> Eq for OnceCell<T>; ``` ```rust // std::sync (in std/sync/once_lock.rs) impl<T> OnceLock<T> { pub const fn new() -> OnceLock<T>; pub fn get(&self) -> Option<&T>; pub fn get_mut(&mut self) -> Option<&mut T>; pub fn set(&self, value: T) -> Result<(), T>; pub fn get_or_init<F>(&self, f: F) -> &T where F: FnOnce() -> T; pub fn into_inner(self) -> Option<T>; pub fn take(&mut self) -> Option<T>; } impl<T: Clone> Clone for OnceLock<T>; impl<T: Debug> Debug for OnceLock<T>; impl<T> Default for OnceLock<T>; impl<#[may_dangle] T> Drop for OnceLock<T>; impl<T> From<T> for OnceLock<T>; impl<T: PartialEq> PartialEq for OnceLock<T> impl<T: Eq> Eq for OnceLock<T>; impl<T: RefUnwindSafe + UnwindSafe> RefUnwindSafe for OnceLock<T>; unsafe impl<T: Send> Send for OnceLock<T>; unsafe impl<T: Sync + Send> Sync for OnceLock<T>; impl<T: UnwindSafe> UnwindSafe for OnceLock<T>; ``` No longer planned as part of this PR, and moved to the `rust_cell_try` feature gate: ```rust impl<T> OnceCell<T> { pub fn get_or_try_init<F, E>(&self, f: F) -> Result<&T, E> where F: FnOnce() -> Result<T, E>; } impl<T> OnceLock<T> { pub fn get_or_try_init<F, E>(&self, f: F) -> Result<&T, E> where F: FnOnce() -> Result<T, E>; } ``` I am new to this process so would appreciate mentorship wherever needed.
This commit is contained in:
commit
8a7ca936e6
@ -5,7 +5,7 @@
|
||||
#![feature(let_chains)]
|
||||
#![feature(min_specialization)]
|
||||
#![feature(never_type)]
|
||||
#![feature(once_cell)]
|
||||
#![feature(lazy_cell)]
|
||||
#![feature(rustc_attrs)]
|
||||
#![feature(stmt_expr_attributes)]
|
||||
#![feature(trusted_step)]
|
||||
|
@ -10,7 +10,6 @@
|
||||
#![feature(iter_intersperse)]
|
||||
#![feature(let_chains)]
|
||||
#![feature(never_type)]
|
||||
#![feature(once_cell)]
|
||||
#![recursion_limit = "256"]
|
||||
#![allow(rustc::potential_query_instability)]
|
||||
#![deny(rustc::untranslatable_diagnostic)]
|
||||
|
@ -5,7 +5,6 @@
|
||||
#![feature(int_roundings)]
|
||||
#![feature(let_chains)]
|
||||
#![feature(never_type)]
|
||||
#![feature(once_cell)]
|
||||
#![feature(strict_provenance)]
|
||||
#![feature(try_blocks)]
|
||||
#![recursion_limit = "256"]
|
||||
|
@ -20,7 +20,7 @@
|
||||
#![feature(never_type)]
|
||||
#![feature(type_alias_impl_trait)]
|
||||
#![feature(new_uninit)]
|
||||
#![feature(once_cell)]
|
||||
#![feature(lazy_cell)]
|
||||
#![feature(rustc_attrs)]
|
||||
#![feature(negative_impls)]
|
||||
#![feature(test)]
|
||||
|
@ -6,7 +6,7 @@
|
||||
|
||||
#![doc(html_root_url = "https://doc.rust-lang.org/nightly/nightly-rustc/")]
|
||||
#![feature(is_terminal)]
|
||||
#![feature(once_cell)]
|
||||
#![feature(lazy_cell)]
|
||||
#![feature(decl_macro)]
|
||||
#![recursion_limit = "256"]
|
||||
#![allow(rustc::potential_query_instability)]
|
||||
|
@ -1,5 +1,5 @@
|
||||
#![feature(let_chains)]
|
||||
#![feature(once_cell)]
|
||||
#![feature(lazy_cell)]
|
||||
#![feature(rustc_attrs)]
|
||||
#![feature(type_alias_impl_trait)]
|
||||
#![deny(rustc::untranslatable_diagnostic)]
|
||||
|
@ -11,7 +11,7 @@
|
||||
//! even if it is stabilized or removed, *do not remove it*. Instead, move the
|
||||
//! symbol to the `accepted` or `removed` modules respectively.
|
||||
|
||||
#![feature(once_cell)]
|
||||
#![feature(lazy_cell)]
|
||||
#![deny(rustc::untranslatable_diagnostic)]
|
||||
#![deny(rustc::diagnostic_outside_of_impl)]
|
||||
|
||||
|
@ -67,7 +67,7 @@ This API is completely unstable and subject to change.
|
||||
#![feature(let_chains)]
|
||||
#![feature(min_specialization)]
|
||||
#![feature(never_type)]
|
||||
#![feature(once_cell)]
|
||||
#![feature(lazy_cell)]
|
||||
#![feature(slice_partition_dedup)]
|
||||
#![feature(try_blocks)]
|
||||
#![feature(is_some_and)]
|
||||
|
@ -2,7 +2,7 @@
|
||||
#![feature(decl_macro)]
|
||||
#![feature(internal_output_capture)]
|
||||
#![feature(thread_spawn_unchecked)]
|
||||
#![feature(once_cell)]
|
||||
#![feature(lazy_cell)]
|
||||
#![feature(try_blocks)]
|
||||
#![recursion_limit = "256"]
|
||||
#![allow(rustc::potential_query_instability)]
|
||||
|
@ -4,7 +4,6 @@
|
||||
#![feature(generators)]
|
||||
#![feature(iter_from_generator)]
|
||||
#![feature(let_chains)]
|
||||
#![feature(once_cell)]
|
||||
#![feature(proc_macro_internals)]
|
||||
#![feature(macro_metavar_expr)]
|
||||
#![feature(min_specialization)]
|
||||
|
@ -39,7 +39,6 @@
|
||||
#![feature(never_type)]
|
||||
#![feature(extern_types)]
|
||||
#![feature(new_uninit)]
|
||||
#![feature(once_cell)]
|
||||
#![feature(let_chains)]
|
||||
#![feature(min_specialization)]
|
||||
#![feature(trusted_len)]
|
||||
|
@ -8,7 +8,6 @@
|
||||
#![feature(if_let_guard)]
|
||||
#![feature(let_chains)]
|
||||
#![feature(min_specialization)]
|
||||
#![feature(once_cell)]
|
||||
#![feature(try_blocks)]
|
||||
#![recursion_limit = "256"]
|
||||
|
||||
|
@ -3,7 +3,6 @@
|
||||
#![feature(exact_size_is_empty)]
|
||||
#![feature(let_chains)]
|
||||
#![feature(min_specialization)]
|
||||
#![feature(once_cell)]
|
||||
#![feature(stmt_expr_attributes)]
|
||||
#![feature(trusted_step)]
|
||||
#![recursion_limit = "256"]
|
||||
|
@ -5,7 +5,6 @@
|
||||
#![feature(map_try_insert)]
|
||||
#![feature(min_specialization)]
|
||||
#![feature(never_type)]
|
||||
#![feature(once_cell)]
|
||||
#![feature(option_get_or_insert_default)]
|
||||
#![feature(trusted_step)]
|
||||
#![feature(try_blocks)]
|
||||
|
@ -5,7 +5,6 @@
|
||||
#![feature(const_mut_refs)]
|
||||
#![feature(min_specialization)]
|
||||
#![feature(never_type)]
|
||||
#![feature(once_cell)]
|
||||
#![feature(rustc_attrs)]
|
||||
#![recursion_limit = "256"]
|
||||
#![allow(rustc::potential_query_instability)]
|
||||
|
@ -2,7 +2,7 @@
|
||||
#![feature(let_chains)]
|
||||
#![feature(min_specialization)]
|
||||
#![feature(never_type)]
|
||||
#![feature(once_cell)]
|
||||
#![feature(lazy_cell)]
|
||||
#![feature(option_get_or_insert_default)]
|
||||
#![feature(rustc_attrs)]
|
||||
#![feature(map_many_mut)]
|
||||
|
@ -42,7 +42,6 @@
|
||||
#![feature(slice_flatten)]
|
||||
#![feature(thin_box)]
|
||||
#![feature(strict_provenance)]
|
||||
#![feature(once_cell)]
|
||||
#![feature(drain_keep_rest)]
|
||||
#![deny(fuzzy_provenance_casts)]
|
||||
#![deny(unsafe_op_in_unsafe_fn)]
|
||||
|
@ -11,36 +11,77 @@
|
||||
//! mutate it.
|
||||
//!
|
||||
//! Shareable mutable containers exist to permit mutability in a controlled manner, even in the
|
||||
//! presence of aliasing. Both [`Cell<T>`] and [`RefCell<T>`] allow doing this in a single-threaded
|
||||
//! way. However, neither `Cell<T>` nor `RefCell<T>` are thread safe (they do not implement
|
||||
//! [`Sync`]). If you need to do aliasing and mutation between multiple threads it is possible to
|
||||
//! use [`Mutex<T>`], [`RwLock<T>`] or [`atomic`] types.
|
||||
//! presence of aliasing. [`Cell<T>`], [`RefCell<T>`], and [`OnceCell<T>`] allow doing this in
|
||||
//! a single-threaded way—they do not implement [`Sync`]. (If you need to do aliasing and
|
||||
//! mutation among multiple threads, [`Mutex<T>`], [`RwLock<T>`], [`OnceLock<T>`] or [`atomic`]
|
||||
//! types are the correct data structures to do so).
|
||||
//!
|
||||
//! Values of the `Cell<T>` and `RefCell<T>` types may be mutated through shared references (i.e.
|
||||
//! the common `&T` type), whereas most Rust types can only be mutated through unique (`&mut T`)
|
||||
//! references. We say that `Cell<T>` and `RefCell<T>` provide 'interior mutability', in contrast
|
||||
//! with typical Rust types that exhibit 'inherited mutability'.
|
||||
//! Values of the `Cell<T>`, `RefCell<T>`, and `OnceCell<T>` types may be mutated through shared
|
||||
//! references (i.e. the common `&T` type), whereas most Rust types can only be mutated through
|
||||
//! unique (`&mut T`) references. We say these cell types provide 'interior mutability'
|
||||
//! (mutable via `&T`), in contrast with typical Rust types that exhibit 'inherited mutability'
|
||||
//! (mutable only via `&mut T`).
|
||||
//!
|
||||
//! Cell types come in two flavors: `Cell<T>` and `RefCell<T>`. `Cell<T>` implements interior
|
||||
//! mutability by moving values in and out of the `Cell<T>`. To use references instead of values,
|
||||
//! one must use the `RefCell<T>` type, acquiring a write lock before mutating. `Cell<T>` provides
|
||||
//! methods to retrieve and change the current interior value:
|
||||
//! Cell types come in three flavors: `Cell<T>`, `RefCell<T>`, and `OnceCell<T>`. Each provides
|
||||
//! a different way of providing safe interior mutability.
|
||||
//!
|
||||
//! ## `Cell<T>`
|
||||
//!
|
||||
//! [`Cell<T>`] implements interior mutability by moving values in and out of the cell. That is, an
|
||||
//! `&mut T` to the inner value can never be obtained, and the value itself cannot be directly
|
||||
//! obtained without replacing it with something else. Both of these rules ensure that there is
|
||||
//! never more than one reference pointing to the inner value. This type provides the following
|
||||
//! methods:
|
||||
//!
|
||||
//! - For types that implement [`Copy`], the [`get`](Cell::get) method retrieves the current
|
||||
//! interior value.
|
||||
//! interior value by duplicating it.
|
||||
//! - For types that implement [`Default`], the [`take`](Cell::take) method replaces the current
|
||||
//! interior value with [`Default::default()`] and returns the replaced value.
|
||||
//! - For all types, the [`replace`](Cell::replace) method replaces the current interior value and
|
||||
//! returns the replaced value and the [`into_inner`](Cell::into_inner) method consumes the
|
||||
//! `Cell<T>` and returns the interior value. Additionally, the [`set`](Cell::set) method
|
||||
//! replaces the interior value, dropping the replaced value.
|
||||
//! - All types have:
|
||||
//! - [`replace`](Cell::replace): replaces the current interior value and returns the replaced
|
||||
//! value.
|
||||
//! - [`into_inner`](Cell::into_inner): this method consumes the `Cell<T>` and returns the
|
||||
//! interior value.
|
||||
//! - [`set`](Cell::set): this method replaces the interior value, dropping the replaced value.
|
||||
//!
|
||||
//! `RefCell<T>` uses Rust's lifetimes to implement 'dynamic borrowing', a process whereby one can
|
||||
//! `Cell<T>` is typically used for more simple types where copying or moving values isn't too
|
||||
//! resource intensive (e.g. numbers), and should usually be preferred over other cell types when
|
||||
//! possible. For larger and non-copy types, `RefCell` provides some advantages.
|
||||
//!
|
||||
//! ## `RefCell<T>`
|
||||
//!
|
||||
//! [`RefCell<T>`] uses Rust's lifetimes to implement "dynamic borrowing", a process whereby one can
|
||||
//! claim temporary, exclusive, mutable access to the inner value. Borrows for `RefCell<T>`s are
|
||||
//! tracked 'at runtime', unlike Rust's native reference types which are entirely tracked
|
||||
//! statically, at compile time. Because `RefCell<T>` borrows are dynamic it is possible to attempt
|
||||
//! to borrow a value that is already mutably borrowed; when this happens it results in thread
|
||||
//! panic.
|
||||
//! tracked at _runtime_, unlike Rust's native reference types which are entirely tracked
|
||||
//! statically, at compile time.
|
||||
//!
|
||||
//! An immutable reference to a `RefCell`'s inner value (`&T`) can be obtained with
|
||||
//! [`borrow`](`RefCell::borrow`), and a mutable borrow (`&mut T`) can be obtained with
|
||||
//! [`borrow_mut`](`RefCell::borrow_mut`). When these functions are called, they first verify that
|
||||
//! Rust's borrow rules will be satisfied: any number of immutable borrows are allowed or a
|
||||
//! single immutable borrow is allowed, but never both. If a borrow is attempted that would violate
|
||||
//! these rules, the thread will panic.
|
||||
//!
|
||||
//! The corresponding [`Sync`] version of `RefCell<T>` is [`RwLock<T>`].
|
||||
//!
|
||||
//! ## `OnceCell<T>`
|
||||
//!
|
||||
//! [`OnceCell<T>`] is somewhat of a hybrid of `Cell` and `RefCell` that works for values that
|
||||
//! typically only need to be set once. This means that a reference `&T` can be obtained without
|
||||
//! moving or copying the inner value (unlike `Cell`) but also without runtime checks (unlike
|
||||
//! `RefCell`). However, its value can also not be updated once set unless you have a mutable
|
||||
//! reference to the `OnceCell`.
|
||||
//!
|
||||
//! `OnceCell` provides the following methods:
|
||||
//!
|
||||
//! - [`get`](OnceCell::get): obtain a reference to the inner value
|
||||
//! - [`set`](OnceCell::set): set the inner value if it is unset (returns a `Result`)
|
||||
//! - [`get_or_init`](OnceCell::get_or_init): return the inner value, initializing it if needed
|
||||
//! - [`get_mut`](OnceCell::get_mut): provide a mutable reference to the inner value, only available
|
||||
//! if you have a mutable reference to the cell itself.
|
||||
//!
|
||||
//! The corresponding [`Sync`] version of `OnceCell<T>` is [`OnceLock<T>`].
|
||||
//!
|
||||
//!
|
||||
//! # When to choose interior mutability
|
||||
//!
|
||||
@ -188,6 +229,8 @@
|
||||
//! [`Rc<T>`]: ../../std/rc/struct.Rc.html
|
||||
//! [`RwLock<T>`]: ../../std/sync/struct.RwLock.html
|
||||
//! [`Mutex<T>`]: ../../std/sync/struct.Mutex.html
|
||||
//! [`OnceLock<T>`]: ../../std/sync/struct.OnceLock.html
|
||||
//! [`Sync`]: ../../std/marker/trait.Sync.html
|
||||
//! [`atomic`]: crate::sync::atomic
|
||||
|
||||
#![stable(feature = "rust1", since = "1.0.0")]
|
||||
@ -202,9 +245,9 @@ use crate::ptr::{self, NonNull};
|
||||
mod lazy;
|
||||
mod once;
|
||||
|
||||
#[unstable(feature = "once_cell", issue = "74465")]
|
||||
#[unstable(feature = "lazy_cell", issue = "109736")]
|
||||
pub use lazy::LazyCell;
|
||||
#[unstable(feature = "once_cell", issue = "74465")]
|
||||
#[stable(feature = "once_cell", since = "CURRENT_RUSTC_VERSION")]
|
||||
pub use once::OnceCell;
|
||||
|
||||
/// A mutable memory location.
|
||||
@ -419,7 +462,7 @@ impl<T> Cell<T> {
|
||||
mem::replace(unsafe { &mut *self.value.get() }, val)
|
||||
}
|
||||
|
||||
/// Unwraps the value.
|
||||
/// Unwraps the value, consuming the cell.
|
||||
///
|
||||
/// # Examples
|
||||
///
|
||||
@ -1969,7 +2012,7 @@ impl<T> UnsafeCell<T> {
|
||||
UnsafeCell { value }
|
||||
}
|
||||
|
||||
/// Unwraps the value.
|
||||
/// Unwraps the value, consuming the cell.
|
||||
///
|
||||
/// # Examples
|
||||
///
|
||||
@ -2133,7 +2176,7 @@ impl<T> SyncUnsafeCell<T> {
|
||||
Self { value: UnsafeCell { value } }
|
||||
}
|
||||
|
||||
/// Unwraps the value.
|
||||
/// Unwraps the value, consuming the cell.
|
||||
#[inline]
|
||||
pub const fn into_inner(self) -> T {
|
||||
self.value.into_inner()
|
||||
|
@ -11,7 +11,7 @@ use crate::ops::Deref;
|
||||
/// # Examples
|
||||
///
|
||||
/// ```
|
||||
/// #![feature(once_cell)]
|
||||
/// #![feature(lazy_cell)]
|
||||
///
|
||||
/// use std::cell::LazyCell;
|
||||
///
|
||||
@ -29,7 +29,7 @@ use crate::ops::Deref;
|
||||
/// // 92
|
||||
/// // 92
|
||||
/// ```
|
||||
#[unstable(feature = "once_cell", issue = "74465")]
|
||||
#[unstable(feature = "lazy_cell", issue = "109736")]
|
||||
pub struct LazyCell<T, F = fn() -> T> {
|
||||
cell: OnceCell<T>,
|
||||
init: Cell<Option<F>>,
|
||||
@ -41,7 +41,7 @@ impl<T, F: FnOnce() -> T> LazyCell<T, F> {
|
||||
/// # Examples
|
||||
///
|
||||
/// ```
|
||||
/// #![feature(once_cell)]
|
||||
/// #![feature(lazy_cell)]
|
||||
///
|
||||
/// use std::cell::LazyCell;
|
||||
///
|
||||
@ -52,7 +52,7 @@ impl<T, F: FnOnce() -> T> LazyCell<T, F> {
|
||||
/// assert_eq!(&*lazy, "HELLO, WORLD!");
|
||||
/// ```
|
||||
#[inline]
|
||||
#[unstable(feature = "once_cell", issue = "74465")]
|
||||
#[unstable(feature = "lazy_cell", issue = "109736")]
|
||||
pub const fn new(init: F) -> LazyCell<T, F> {
|
||||
LazyCell { cell: OnceCell::new(), init: Cell::new(Some(init)) }
|
||||
}
|
||||
@ -65,7 +65,7 @@ impl<T, F: FnOnce() -> T> LazyCell<T, F> {
|
||||
/// # Examples
|
||||
///
|
||||
/// ```
|
||||
/// #![feature(once_cell)]
|
||||
/// #![feature(lazy_cell)]
|
||||
///
|
||||
/// use std::cell::LazyCell;
|
||||
///
|
||||
@ -75,7 +75,7 @@ impl<T, F: FnOnce() -> T> LazyCell<T, F> {
|
||||
/// assert_eq!(&*lazy, &92);
|
||||
/// ```
|
||||
#[inline]
|
||||
#[unstable(feature = "once_cell", issue = "74465")]
|
||||
#[unstable(feature = "lazy_cell", issue = "109736")]
|
||||
pub fn force(this: &LazyCell<T, F>) -> &T {
|
||||
this.cell.get_or_init(|| match this.init.take() {
|
||||
Some(f) => f(),
|
||||
@ -84,7 +84,7 @@ impl<T, F: FnOnce() -> T> LazyCell<T, F> {
|
||||
}
|
||||
}
|
||||
|
||||
#[unstable(feature = "once_cell", issue = "74465")]
|
||||
#[unstable(feature = "lazy_cell", issue = "109736")]
|
||||
impl<T, F: FnOnce() -> T> Deref for LazyCell<T, F> {
|
||||
type Target = T;
|
||||
#[inline]
|
||||
@ -93,7 +93,7 @@ impl<T, F: FnOnce() -> T> Deref for LazyCell<T, F> {
|
||||
}
|
||||
}
|
||||
|
||||
#[unstable(feature = "once_cell", issue = "74465")]
|
||||
#[unstable(feature = "lazy_cell", issue = "109736")]
|
||||
impl<T: Default> Default for LazyCell<T> {
|
||||
/// Creates a new lazy value using `Default` as the initializing function.
|
||||
#[inline]
|
||||
@ -102,7 +102,7 @@ impl<T: Default> Default for LazyCell<T> {
|
||||
}
|
||||
}
|
||||
|
||||
#[unstable(feature = "once_cell", issue = "74465")]
|
||||
#[unstable(feature = "lazy_cell", issue = "109736")]
|
||||
impl<T: fmt::Debug, F> fmt::Debug for LazyCell<T, F> {
|
||||
fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
|
||||
f.debug_struct("Lazy").field("cell", &self.cell).field("init", &"..").finish()
|
||||
|
@ -4,8 +4,10 @@ use crate::mem;
|
||||
|
||||
/// 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.
|
||||
/// This allows obtaining a shared `&T` reference to its inner value without copying or replacing
|
||||
/// it (unlike [`Cell`]), and without runtime borrow checks (unlike [`RefCell`]). However,
|
||||
/// only immutable references can be obtained unless one has a mutable reference to the cell
|
||||
/// itself.
|
||||
///
|
||||
/// For a thread-safe version of this struct, see [`std::sync::OnceLock`].
|
||||
///
|
||||
@ -16,8 +18,6 @@ use crate::mem;
|
||||
/// # Examples
|
||||
///
|
||||
/// ```
|
||||
/// #![feature(once_cell)]
|
||||
///
|
||||
/// use std::cell::OnceCell;
|
||||
///
|
||||
/// let cell = OnceCell::new();
|
||||
@ -29,7 +29,7 @@ use crate::mem;
|
||||
/// assert_eq!(value, "Hello, World!");
|
||||
/// assert!(cell.get().is_some());
|
||||
/// ```
|
||||
#[unstable(feature = "once_cell", issue = "74465")]
|
||||
#[stable(feature = "once_cell", since = "CURRENT_RUSTC_VERSION")]
|
||||
pub struct OnceCell<T> {
|
||||
// Invariant: written to at most once.
|
||||
inner: UnsafeCell<Option<T>>,
|
||||
@ -39,7 +39,8 @@ impl<T> OnceCell<T> {
|
||||
/// Creates a new empty cell.
|
||||
#[inline]
|
||||
#[must_use]
|
||||
#[unstable(feature = "once_cell", issue = "74465")]
|
||||
#[stable(feature = "once_cell", since = "CURRENT_RUSTC_VERSION")]
|
||||
#[rustc_const_stable(feature = "once_cell", since = "CURRENT_RUSTC_VERSION")]
|
||||
pub const fn new() -> OnceCell<T> {
|
||||
OnceCell { inner: UnsafeCell::new(None) }
|
||||
}
|
||||
@ -48,7 +49,7 @@ impl<T> OnceCell<T> {
|
||||
///
|
||||
/// Returns `None` if the cell is empty.
|
||||
#[inline]
|
||||
#[unstable(feature = "once_cell", issue = "74465")]
|
||||
#[stable(feature = "once_cell", since = "CURRENT_RUSTC_VERSION")]
|
||||
pub fn get(&self) -> Option<&T> {
|
||||
// SAFETY: Safe due to `inner`'s invariant
|
||||
unsafe { &*self.inner.get() }.as_ref()
|
||||
@ -58,7 +59,7 @@ impl<T> OnceCell<T> {
|
||||
///
|
||||
/// Returns `None` if the cell is empty.
|
||||
#[inline]
|
||||
#[unstable(feature = "once_cell", issue = "74465")]
|
||||
#[stable(feature = "once_cell", since = "CURRENT_RUSTC_VERSION")]
|
||||
pub fn get_mut(&mut self) -> Option<&mut T> {
|
||||
self.inner.get_mut().as_mut()
|
||||
}
|
||||
@ -73,8 +74,6 @@ impl<T> OnceCell<T> {
|
||||
/// # Examples
|
||||
///
|
||||
/// ```
|
||||
/// #![feature(once_cell)]
|
||||
///
|
||||
/// use std::cell::OnceCell;
|
||||
///
|
||||
/// let cell = OnceCell::new();
|
||||
@ -86,7 +85,7 @@ impl<T> OnceCell<T> {
|
||||
/// assert!(cell.get().is_some());
|
||||
/// ```
|
||||
#[inline]
|
||||
#[unstable(feature = "once_cell", issue = "74465")]
|
||||
#[stable(feature = "once_cell", since = "CURRENT_RUSTC_VERSION")]
|
||||
pub fn set(&self, value: T) -> Result<(), T> {
|
||||
// SAFETY: Safe because we cannot have overlapping mutable borrows
|
||||
let slot = unsafe { &*self.inner.get() };
|
||||
@ -117,8 +116,6 @@ impl<T> OnceCell<T> {
|
||||
/// # Examples
|
||||
///
|
||||
/// ```
|
||||
/// #![feature(once_cell)]
|
||||
///
|
||||
/// use std::cell::OnceCell;
|
||||
///
|
||||
/// let cell = OnceCell::new();
|
||||
@ -128,7 +125,7 @@ impl<T> OnceCell<T> {
|
||||
/// assert_eq!(value, &92);
|
||||
/// ```
|
||||
#[inline]
|
||||
#[unstable(feature = "once_cell", issue = "74465")]
|
||||
#[stable(feature = "once_cell", since = "CURRENT_RUSTC_VERSION")]
|
||||
pub fn get_or_init<F>(&self, f: F) -> &T
|
||||
where
|
||||
F: FnOnce() -> T,
|
||||
@ -153,7 +150,7 @@ impl<T> OnceCell<T> {
|
||||
/// # Examples
|
||||
///
|
||||
/// ```
|
||||
/// #![feature(once_cell)]
|
||||
/// #![feature(once_cell_try)]
|
||||
///
|
||||
/// use std::cell::OnceCell;
|
||||
///
|
||||
@ -166,7 +163,7 @@ impl<T> OnceCell<T> {
|
||||
/// assert_eq!(value, Ok(&92));
|
||||
/// assert_eq!(cell.get(), Some(&92))
|
||||
/// ```
|
||||
#[unstable(feature = "once_cell", issue = "74465")]
|
||||
#[unstable(feature = "once_cell_try", issue = "109737")]
|
||||
pub fn get_or_try_init<F, E>(&self, f: F) -> Result<&T, E>
|
||||
where
|
||||
F: FnOnce() -> Result<T, E>,
|
||||
@ -199,8 +196,6 @@ impl<T> OnceCell<T> {
|
||||
/// # Examples
|
||||
///
|
||||
/// ```
|
||||
/// #![feature(once_cell)]
|
||||
///
|
||||
/// use std::cell::OnceCell;
|
||||
///
|
||||
/// let cell: OnceCell<String> = OnceCell::new();
|
||||
@ -211,7 +206,7 @@ impl<T> OnceCell<T> {
|
||||
/// assert_eq!(cell.into_inner(), Some("hello".to_string()));
|
||||
/// ```
|
||||
#[inline]
|
||||
#[unstable(feature = "once_cell", issue = "74465")]
|
||||
#[stable(feature = "once_cell", since = "CURRENT_RUSTC_VERSION")]
|
||||
pub fn into_inner(self) -> Option<T> {
|
||||
// Because `into_inner` takes `self` by value, the compiler statically verifies
|
||||
// that it is not currently borrowed. So it is safe to move out `Option<T>`.
|
||||
@ -227,8 +222,6 @@ impl<T> OnceCell<T> {
|
||||
/// # Examples
|
||||
///
|
||||
/// ```
|
||||
/// #![feature(once_cell)]
|
||||
///
|
||||
/// use std::cell::OnceCell;
|
||||
///
|
||||
/// let mut cell: OnceCell<String> = OnceCell::new();
|
||||
@ -240,13 +233,13 @@ impl<T> OnceCell<T> {
|
||||
/// assert_eq!(cell.get(), None);
|
||||
/// ```
|
||||
#[inline]
|
||||
#[unstable(feature = "once_cell", issue = "74465")]
|
||||
#[stable(feature = "once_cell", since = "CURRENT_RUSTC_VERSION")]
|
||||
pub fn take(&mut self) -> Option<T> {
|
||||
mem::take(self).into_inner()
|
||||
}
|
||||
}
|
||||
|
||||
#[unstable(feature = "once_cell", issue = "74465")]
|
||||
#[stable(feature = "once_cell", since = "CURRENT_RUSTC_VERSION")]
|
||||
impl<T> Default for OnceCell<T> {
|
||||
#[inline]
|
||||
fn default() -> Self {
|
||||
@ -254,7 +247,7 @@ impl<T> Default for OnceCell<T> {
|
||||
}
|
||||
}
|
||||
|
||||
#[unstable(feature = "once_cell", issue = "74465")]
|
||||
#[stable(feature = "once_cell", since = "CURRENT_RUSTC_VERSION")]
|
||||
impl<T: fmt::Debug> fmt::Debug for OnceCell<T> {
|
||||
fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
|
||||
match self.get() {
|
||||
@ -264,7 +257,7 @@ impl<T: fmt::Debug> fmt::Debug for OnceCell<T> {
|
||||
}
|
||||
}
|
||||
|
||||
#[unstable(feature = "once_cell", issue = "74465")]
|
||||
#[stable(feature = "once_cell", since = "CURRENT_RUSTC_VERSION")]
|
||||
impl<T: Clone> Clone for OnceCell<T> {
|
||||
#[inline]
|
||||
fn clone(&self) -> OnceCell<T> {
|
||||
@ -279,7 +272,7 @@ impl<T: Clone> Clone for OnceCell<T> {
|
||||
}
|
||||
}
|
||||
|
||||
#[unstable(feature = "once_cell", issue = "74465")]
|
||||
#[stable(feature = "once_cell", since = "CURRENT_RUSTC_VERSION")]
|
||||
impl<T: PartialEq> PartialEq for OnceCell<T> {
|
||||
#[inline]
|
||||
fn eq(&self, other: &Self) -> bool {
|
||||
@ -287,10 +280,11 @@ impl<T: PartialEq> PartialEq for OnceCell<T> {
|
||||
}
|
||||
}
|
||||
|
||||
#[unstable(feature = "once_cell", issue = "74465")]
|
||||
#[stable(feature = "once_cell", since = "CURRENT_RUSTC_VERSION")]
|
||||
impl<T: Eq> Eq for OnceCell<T> {}
|
||||
|
||||
#[unstable(feature = "once_cell", issue = "74465")]
|
||||
#[stable(feature = "once_cell", since = "CURRENT_RUSTC_VERSION")]
|
||||
#[rustc_const_unstable(feature = "const_convert", issue = "88674")]
|
||||
impl<T> const From<T> for OnceCell<T> {
|
||||
/// Creates a new `OnceCell<T>` which already contains the given `value`.
|
||||
#[inline]
|
||||
@ -300,5 +294,5 @@ impl<T> const From<T> for OnceCell<T> {
|
||||
}
|
||||
|
||||
// Just like for `Cell<T>` this isn't needed, but results in nicer error messages.
|
||||
#[unstable(feature = "once_cell", issue = "74465")]
|
||||
#[stable(feature = "once_cell", since = "CURRENT_RUSTC_VERSION")]
|
||||
impl<T> !Sync for OnceCell<T> {}
|
||||
|
@ -94,7 +94,7 @@
|
||||
#![feature(pointer_is_aligned)]
|
||||
#![feature(portable_simd)]
|
||||
#![feature(ptr_metadata)]
|
||||
#![feature(once_cell)]
|
||||
#![feature(lazy_cell)]
|
||||
#![feature(unsized_tuple_coercion)]
|
||||
#![feature(const_option)]
|
||||
#![feature(const_option_ext)]
|
||||
|
@ -339,7 +339,7 @@
|
||||
#![feature(edition_panic)]
|
||||
#![feature(format_args_nl)]
|
||||
#![feature(log_syntax)]
|
||||
#![feature(once_cell)]
|
||||
#![feature(lazy_cell)]
|
||||
#![feature(saturating_int_impl)]
|
||||
#![feature(stdsimd)]
|
||||
#![feature(test)]
|
||||
|
@ -26,7 +26,7 @@ union Data<T, F> {
|
||||
/// # Examples
|
||||
///
|
||||
/// ```
|
||||
/// #![feature(once_cell)]
|
||||
/// #![feature(lazy_cell)]
|
||||
///
|
||||
/// use std::collections::HashMap;
|
||||
///
|
||||
@ -54,7 +54,7 @@ union Data<T, F> {
|
||||
/// // Some("Hoyten")
|
||||
/// }
|
||||
/// ```
|
||||
#[unstable(feature = "once_cell", issue = "74465")]
|
||||
#[unstable(feature = "lazy_cell", issue = "109736")]
|
||||
pub struct LazyLock<T, F = fn() -> T> {
|
||||
once: Once,
|
||||
data: UnsafeCell<Data<T, F>>,
|
||||
@ -64,7 +64,7 @@ impl<T, F: FnOnce() -> T> LazyLock<T, F> {
|
||||
/// Creates a new lazy value with the given initializing
|
||||
/// function.
|
||||
#[inline]
|
||||
#[unstable(feature = "once_cell", issue = "74465")]
|
||||
#[unstable(feature = "lazy_cell", issue = "109736")]
|
||||
pub const fn new(f: F) -> LazyLock<T, F> {
|
||||
LazyLock { once: Once::new(), data: UnsafeCell::new(Data { f: ManuallyDrop::new(f) }) }
|
||||
}
|
||||
@ -76,7 +76,7 @@ impl<T, F: FnOnce() -> T> LazyLock<T, F> {
|
||||
/// # Examples
|
||||
///
|
||||
/// ```
|
||||
/// #![feature(once_cell)]
|
||||
/// #![feature(lazy_cell)]
|
||||
///
|
||||
/// use std::sync::LazyLock;
|
||||
///
|
||||
@ -86,7 +86,7 @@ impl<T, F: FnOnce() -> T> LazyLock<T, F> {
|
||||
/// assert_eq!(&*lazy, &92);
|
||||
/// ```
|
||||
#[inline]
|
||||
#[unstable(feature = "once_cell", issue = "74465")]
|
||||
#[unstable(feature = "lazy_cell", issue = "109736")]
|
||||
pub fn force(this: &LazyLock<T, F>) -> &T {
|
||||
this.once.call_once(|| {
|
||||
// SAFETY: `call_once` only runs this closure once, ever.
|
||||
@ -122,7 +122,7 @@ impl<T, F> LazyLock<T, F> {
|
||||
}
|
||||
}
|
||||
|
||||
#[unstable(feature = "once_cell", issue = "74465")]
|
||||
#[unstable(feature = "lazy_cell", issue = "109736")]
|
||||
impl<T, F> Drop for LazyLock<T, F> {
|
||||
fn drop(&mut self) {
|
||||
match self.once.state() {
|
||||
@ -135,7 +135,7 @@ impl<T, F> Drop for LazyLock<T, F> {
|
||||
}
|
||||
}
|
||||
|
||||
#[unstable(feature = "once_cell", issue = "74465")]
|
||||
#[unstable(feature = "lazy_cell", issue = "109736")]
|
||||
impl<T, F: FnOnce() -> T> Deref for LazyLock<T, F> {
|
||||
type Target = T;
|
||||
|
||||
@ -145,7 +145,7 @@ impl<T, F: FnOnce() -> T> Deref for LazyLock<T, F> {
|
||||
}
|
||||
}
|
||||
|
||||
#[unstable(feature = "once_cell", issue = "74465")]
|
||||
#[unstable(feature = "lazy_cell", issue = "109736")]
|
||||
impl<T: Default> Default for LazyLock<T> {
|
||||
/// Creates a new lazy value using `Default` as the initializing function.
|
||||
#[inline]
|
||||
@ -154,7 +154,7 @@ impl<T: Default> Default for LazyLock<T> {
|
||||
}
|
||||
}
|
||||
|
||||
#[unstable(feature = "once_cell", issue = "74465")]
|
||||
#[unstable(feature = "lazy_cell", issue = "109736")]
|
||||
impl<T: fmt::Debug, F> fmt::Debug for LazyLock<T, F> {
|
||||
fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
|
||||
match self.get() {
|
||||
@ -166,13 +166,13 @@ impl<T: fmt::Debug, F> fmt::Debug for LazyLock<T, F> {
|
||||
|
||||
// We never create a `&F` from a `&LazyLock<T, F>` so it is fine
|
||||
// to not impl `Sync` for `F`
|
||||
#[unstable(feature = "once_cell", issue = "74465")]
|
||||
#[unstable(feature = "lazy_cell", issue = "109736")]
|
||||
unsafe impl<T: Sync + Send, F: Send> Sync for LazyLock<T, F> {}
|
||||
// auto-derived `Send` impl is OK.
|
||||
|
||||
#[unstable(feature = "once_cell", issue = "74465")]
|
||||
#[unstable(feature = "lazy_cell", issue = "109736")]
|
||||
impl<T: RefUnwindSafe + UnwindSafe, F: UnwindSafe> RefUnwindSafe for LazyLock<T, F> {}
|
||||
#[unstable(feature = "once_cell", issue = "74465")]
|
||||
#[unstable(feature = "lazy_cell", issue = "109736")]
|
||||
impl<T: UnwindSafe, F: UnwindSafe> UnwindSafe for LazyLock<T, F> {}
|
||||
|
||||
#[cfg(test)]
|
||||
|
@ -133,7 +133,9 @@
|
||||
//! - [`Mutex`]: Mutual Exclusion mechanism, which ensures that at
|
||||
//! most one thread at a time is able to access some data.
|
||||
//!
|
||||
//! - [`Once`]: Used for thread-safe, one-time initialization of a
|
||||
//! - [`Once`]: Used for a thread-safe, one-time global initialization routine
|
||||
//!
|
||||
//! - [`OnceLock`]: Used for thread-safe, one-time initialization of a
|
||||
//! global variable.
|
||||
//!
|
||||
//! - [`RwLock`]: Provides a mutual exclusion mechanism which allows
|
||||
@ -147,6 +149,7 @@
|
||||
//! [`mpsc`]: crate::sync::mpsc
|
||||
//! [`Mutex`]: crate::sync::Mutex
|
||||
//! [`Once`]: crate::sync::Once
|
||||
//! [`OnceLock`]: crate::sync::OnceLock
|
||||
//! [`RwLock`]: crate::sync::RwLock
|
||||
|
||||
#![stable(feature = "rust1", since = "1.0.0")]
|
||||
@ -172,9 +175,9 @@ pub use self::poison::{LockResult, PoisonError, TryLockError, TryLockResult};
|
||||
#[stable(feature = "rust1", since = "1.0.0")]
|
||||
pub use self::rwlock::{RwLock, RwLockReadGuard, RwLockWriteGuard};
|
||||
|
||||
#[unstable(feature = "once_cell", issue = "74465")]
|
||||
#[unstable(feature = "lazy_cell", issue = "109736")]
|
||||
pub use self::lazy_lock::LazyLock;
|
||||
#[unstable(feature = "once_cell", issue = "74465")]
|
||||
#[stable(feature = "once_cell", since = "CURRENT_RUSTC_VERSION")]
|
||||
pub use self::once_lock::OnceLock;
|
||||
|
||||
pub(crate) use self::remutex::{ReentrantMutex, ReentrantMutexGuard};
|
||||
|
@ -14,8 +14,6 @@ use crate::sync::Once;
|
||||
/// # Examples
|
||||
///
|
||||
/// ```
|
||||
/// #![feature(once_cell)]
|
||||
///
|
||||
/// use std::sync::OnceLock;
|
||||
///
|
||||
/// static CELL: OnceLock<String> = OnceLock::new();
|
||||
@ -32,7 +30,7 @@ use crate::sync::Once;
|
||||
/// assert!(value.is_some());
|
||||
/// assert_eq!(value.unwrap().as_str(), "Hello, World!");
|
||||
/// ```
|
||||
#[unstable(feature = "once_cell", issue = "74465")]
|
||||
#[stable(feature = "once_cell", since = "CURRENT_RUSTC_VERSION")]
|
||||
pub struct OnceLock<T> {
|
||||
once: Once,
|
||||
// Whether or not the value is initialized is tracked by `once.is_completed()`.
|
||||
@ -40,8 +38,6 @@ pub struct OnceLock<T> {
|
||||
/// `PhantomData` to make sure dropck understands we're dropping T in our Drop impl.
|
||||
///
|
||||
/// ```compile_fail,E0597
|
||||
/// #![feature(once_cell)]
|
||||
///
|
||||
/// use std::sync::OnceLock;
|
||||
///
|
||||
/// struct A<'a>(&'a str);
|
||||
@ -63,7 +59,8 @@ impl<T> OnceLock<T> {
|
||||
/// Creates a new empty cell.
|
||||
#[inline]
|
||||
#[must_use]
|
||||
#[unstable(feature = "once_cell", issue = "74465")]
|
||||
#[stable(feature = "once_cell", since = "CURRENT_RUSTC_VERSION")]
|
||||
#[rustc_const_stable(feature = "once_cell", since = "CURRENT_RUSTC_VERSION")]
|
||||
pub const fn new() -> OnceLock<T> {
|
||||
OnceLock {
|
||||
once: Once::new(),
|
||||
@ -77,7 +74,7 @@ impl<T> OnceLock<T> {
|
||||
/// Returns `None` if the cell is empty, or being initialized. This
|
||||
/// method never blocks.
|
||||
#[inline]
|
||||
#[unstable(feature = "once_cell", issue = "74465")]
|
||||
#[stable(feature = "once_cell", since = "CURRENT_RUSTC_VERSION")]
|
||||
pub fn get(&self) -> Option<&T> {
|
||||
if self.is_initialized() {
|
||||
// Safe b/c checked is_initialized
|
||||
@ -91,7 +88,7 @@ impl<T> OnceLock<T> {
|
||||
///
|
||||
/// Returns `None` if the cell is empty. This method never blocks.
|
||||
#[inline]
|
||||
#[unstable(feature = "once_cell", issue = "74465")]
|
||||
#[stable(feature = "once_cell", since = "CURRENT_RUSTC_VERSION")]
|
||||
pub fn get_mut(&mut self) -> Option<&mut T> {
|
||||
if self.is_initialized() {
|
||||
// Safe b/c checked is_initialized and we have a unique access
|
||||
@ -111,8 +108,6 @@ impl<T> OnceLock<T> {
|
||||
/// # Examples
|
||||
///
|
||||
/// ```
|
||||
/// #![feature(once_cell)]
|
||||
///
|
||||
/// use std::sync::OnceLock;
|
||||
///
|
||||
/// static CELL: OnceLock<i32> = OnceLock::new();
|
||||
@ -129,7 +124,7 @@ impl<T> OnceLock<T> {
|
||||
/// }
|
||||
/// ```
|
||||
#[inline]
|
||||
#[unstable(feature = "once_cell", issue = "74465")]
|
||||
#[stable(feature = "once_cell", since = "CURRENT_RUSTC_VERSION")]
|
||||
pub fn set(&self, value: T) -> Result<(), T> {
|
||||
let mut value = Some(value);
|
||||
self.get_or_init(|| value.take().unwrap());
|
||||
@ -158,8 +153,6 @@ impl<T> OnceLock<T> {
|
||||
/// # Examples
|
||||
///
|
||||
/// ```
|
||||
/// #![feature(once_cell)]
|
||||
///
|
||||
/// use std::sync::OnceLock;
|
||||
///
|
||||
/// let cell = OnceLock::new();
|
||||
@ -169,7 +162,7 @@ impl<T> OnceLock<T> {
|
||||
/// assert_eq!(value, &92);
|
||||
/// ```
|
||||
#[inline]
|
||||
#[unstable(feature = "once_cell", issue = "74465")]
|
||||
#[stable(feature = "once_cell", since = "CURRENT_RUSTC_VERSION")]
|
||||
pub fn get_or_init<F>(&self, f: F) -> &T
|
||||
where
|
||||
F: FnOnce() -> T,
|
||||
@ -195,7 +188,7 @@ impl<T> OnceLock<T> {
|
||||
/// # Examples
|
||||
///
|
||||
/// ```
|
||||
/// #![feature(once_cell)]
|
||||
/// #![feature(once_cell_try)]
|
||||
///
|
||||
/// use std::sync::OnceLock;
|
||||
///
|
||||
@ -209,7 +202,7 @@ impl<T> OnceLock<T> {
|
||||
/// assert_eq!(cell.get(), Some(&92))
|
||||
/// ```
|
||||
#[inline]
|
||||
#[unstable(feature = "once_cell", issue = "74465")]
|
||||
#[unstable(feature = "once_cell_try", issue = "109737")]
|
||||
pub fn get_or_try_init<F, E>(&self, f: F) -> Result<&T, E>
|
||||
where
|
||||
F: FnOnce() -> Result<T, E>,
|
||||
@ -236,8 +229,6 @@ impl<T> OnceLock<T> {
|
||||
/// # Examples
|
||||
///
|
||||
/// ```
|
||||
/// #![feature(once_cell)]
|
||||
///
|
||||
/// use std::sync::OnceLock;
|
||||
///
|
||||
/// let cell: OnceLock<String> = OnceLock::new();
|
||||
@ -248,7 +239,7 @@ impl<T> OnceLock<T> {
|
||||
/// assert_eq!(cell.into_inner(), Some("hello".to_string()));
|
||||
/// ```
|
||||
#[inline]
|
||||
#[unstable(feature = "once_cell", issue = "74465")]
|
||||
#[stable(feature = "once_cell", since = "CURRENT_RUSTC_VERSION")]
|
||||
pub fn into_inner(mut self) -> Option<T> {
|
||||
self.take()
|
||||
}
|
||||
@ -262,8 +253,6 @@ impl<T> OnceLock<T> {
|
||||
/// # Examples
|
||||
///
|
||||
/// ```
|
||||
/// #![feature(once_cell)]
|
||||
///
|
||||
/// use std::sync::OnceLock;
|
||||
///
|
||||
/// let mut cell: OnceLock<String> = OnceLock::new();
|
||||
@ -275,7 +264,7 @@ impl<T> OnceLock<T> {
|
||||
/// assert_eq!(cell.get(), None);
|
||||
/// ```
|
||||
#[inline]
|
||||
#[unstable(feature = "once_cell", issue = "74465")]
|
||||
#[stable(feature = "once_cell", since = "CURRENT_RUSTC_VERSION")]
|
||||
pub fn take(&mut self) -> Option<T> {
|
||||
if self.is_initialized() {
|
||||
self.once = Once::new();
|
||||
@ -344,17 +333,17 @@ impl<T> OnceLock<T> {
|
||||
// scoped thread B, which fills the cell, which is
|
||||
// then destroyed by A. That is, destructor observes
|
||||
// a sent value.
|
||||
#[unstable(feature = "once_cell", issue = "74465")]
|
||||
#[stable(feature = "once_cell", since = "CURRENT_RUSTC_VERSION")]
|
||||
unsafe impl<T: Sync + Send> Sync for OnceLock<T> {}
|
||||
#[unstable(feature = "once_cell", issue = "74465")]
|
||||
#[stable(feature = "once_cell", since = "CURRENT_RUSTC_VERSION")]
|
||||
unsafe impl<T: Send> Send for OnceLock<T> {}
|
||||
|
||||
#[unstable(feature = "once_cell", issue = "74465")]
|
||||
#[stable(feature = "once_cell", since = "CURRENT_RUSTC_VERSION")]
|
||||
impl<T: RefUnwindSafe + UnwindSafe> RefUnwindSafe for OnceLock<T> {}
|
||||
#[unstable(feature = "once_cell", issue = "74465")]
|
||||
#[stable(feature = "once_cell", since = "CURRENT_RUSTC_VERSION")]
|
||||
impl<T: UnwindSafe> UnwindSafe for OnceLock<T> {}
|
||||
|
||||
#[unstable(feature = "once_cell", issue = "74465")]
|
||||
#[stable(feature = "once_cell", since = "CURRENT_RUSTC_VERSION")]
|
||||
#[rustc_const_unstable(feature = "const_default_impls", issue = "87864")]
|
||||
impl<T> const Default for OnceLock<T> {
|
||||
/// Creates a new empty cell.
|
||||
@ -362,8 +351,6 @@ impl<T> const Default for OnceLock<T> {
|
||||
/// # Example
|
||||
///
|
||||
/// ```
|
||||
/// #![feature(once_cell)]
|
||||
///
|
||||
/// use std::sync::OnceLock;
|
||||
///
|
||||
/// fn main() {
|
||||
@ -376,7 +363,7 @@ impl<T> const Default for OnceLock<T> {
|
||||
}
|
||||
}
|
||||
|
||||
#[unstable(feature = "once_cell", issue = "74465")]
|
||||
#[stable(feature = "once_cell", since = "CURRENT_RUSTC_VERSION")]
|
||||
impl<T: fmt::Debug> fmt::Debug for OnceLock<T> {
|
||||
fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
|
||||
match self.get() {
|
||||
@ -386,7 +373,7 @@ impl<T: fmt::Debug> fmt::Debug for OnceLock<T> {
|
||||
}
|
||||
}
|
||||
|
||||
#[unstable(feature = "once_cell", issue = "74465")]
|
||||
#[stable(feature = "once_cell", since = "CURRENT_RUSTC_VERSION")]
|
||||
impl<T: Clone> Clone for OnceLock<T> {
|
||||
#[inline]
|
||||
fn clone(&self) -> OnceLock<T> {
|
||||
@ -401,15 +388,13 @@ impl<T: Clone> Clone for OnceLock<T> {
|
||||
}
|
||||
}
|
||||
|
||||
#[unstable(feature = "once_cell", issue = "74465")]
|
||||
#[stable(feature = "once_cell", since = "CURRENT_RUSTC_VERSION")]
|
||||
impl<T> From<T> for OnceLock<T> {
|
||||
/// Create a new cell with its contents set to `value`.
|
||||
///
|
||||
/// # Example
|
||||
///
|
||||
/// ```
|
||||
/// #![feature(once_cell)]
|
||||
///
|
||||
/// use std::sync::OnceLock;
|
||||
///
|
||||
/// # fn main() -> Result<(), i32> {
|
||||
@ -430,7 +415,7 @@ impl<T> From<T> for OnceLock<T> {
|
||||
}
|
||||
}
|
||||
|
||||
#[unstable(feature = "once_cell", issue = "74465")]
|
||||
#[stable(feature = "once_cell", since = "CURRENT_RUSTC_VERSION")]
|
||||
impl<T: PartialEq> PartialEq for OnceLock<T> {
|
||||
#[inline]
|
||||
fn eq(&self, other: &OnceLock<T>) -> bool {
|
||||
@ -438,10 +423,10 @@ impl<T: PartialEq> PartialEq for OnceLock<T> {
|
||||
}
|
||||
}
|
||||
|
||||
#[unstable(feature = "once_cell", issue = "74465")]
|
||||
#[stable(feature = "once_cell", since = "CURRENT_RUSTC_VERSION")]
|
||||
impl<T: Eq> Eq for OnceLock<T> {}
|
||||
|
||||
#[unstable(feature = "once_cell", issue = "74465")]
|
||||
#[stable(feature = "once_cell", since = "CURRENT_RUSTC_VERSION")]
|
||||
unsafe impl<#[may_dangle] T> Drop for OnceLock<T> {
|
||||
#[inline]
|
||||
fn drop(&mut self) {
|
||||
|
@ -11,7 +11,7 @@
|
||||
#![feature(let_chains)]
|
||||
#![feature(test)]
|
||||
#![feature(never_type)]
|
||||
#![feature(once_cell)]
|
||||
#![feature(lazy_cell)]
|
||||
#![feature(type_ascription)]
|
||||
#![feature(iter_intersperse)]
|
||||
#![feature(type_alias_impl_trait)]
|
||||
|
@ -1,5 +1,4 @@
|
||||
#![feature(let_chains)]
|
||||
#![feature(once_cell)]
|
||||
#![feature(rustc_private)]
|
||||
#![cfg_attr(feature = "deny-warnings", deny(warnings))]
|
||||
// warn on lints, that are included in `rust-lang/rust`s bootstrap
|
||||
|
@ -7,7 +7,6 @@
|
||||
#![feature(let_chains)]
|
||||
#![feature(lint_reasons)]
|
||||
#![feature(never_type)]
|
||||
#![feature(once_cell)]
|
||||
#![feature(rustc_private)]
|
||||
#![feature(stmt_expr_attributes)]
|
||||
#![recursion_limit = "512"]
|
||||
|
@ -3,7 +3,6 @@
|
||||
#![feature(let_chains)]
|
||||
#![feature(lint_reasons)]
|
||||
#![feature(never_type)]
|
||||
#![feature(once_cell)]
|
||||
#![feature(rustc_private)]
|
||||
#![recursion_limit = "512"]
|
||||
#![cfg_attr(feature = "deny-warnings", deny(warnings))]
|
||||
|
@ -1,6 +1,6 @@
|
||||
#![feature(rustc_private)]
|
||||
#![feature(let_chains)]
|
||||
#![feature(once_cell)]
|
||||
#![feature(lazy_cell)]
|
||||
#![feature(lint_reasons)]
|
||||
#![cfg_attr(feature = "deny-warnings", deny(warnings))]
|
||||
// warn on lints, that are included in `rust-lang/rust`s bootstrap
|
||||
|
@ -1,5 +1,5 @@
|
||||
#![feature(test)] // compiletest_rs requires this attribute
|
||||
#![feature(once_cell)]
|
||||
#![feature(lazy_cell)]
|
||||
#![feature(is_sorted)]
|
||||
#![cfg_attr(feature = "deny-warnings", deny(warnings))]
|
||||
#![warn(rust_2018_idioms, unused_lifetimes)]
|
||||
|
@ -3,7 +3,7 @@
|
||||
//!
|
||||
//! See [Eating your own dog food](https://en.wikipedia.org/wiki/Eating_your_own_dog_food) for context
|
||||
|
||||
#![feature(once_cell)]
|
||||
#![feature(lazy_cell)]
|
||||
#![cfg_attr(feature = "deny-warnings", deny(warnings))]
|
||||
#![warn(rust_2018_idioms, unused_lifetimes)]
|
||||
|
||||
|
@ -1,4 +1,4 @@
|
||||
#![feature(once_cell)]
|
||||
#![feature(lazy_cell)]
|
||||
#![cfg_attr(feature = "deny-warnings", deny(warnings))]
|
||||
#![warn(rust_2018_idioms, unused_lifetimes)]
|
||||
|
||||
|
@ -1,4 +1,4 @@
|
||||
#![feature(once_cell)]
|
||||
#![feature(lazy_cell)]
|
||||
|
||||
use std::path::PathBuf;
|
||||
use std::process::Command;
|
||||
|
@ -1,5 +1,3 @@
|
||||
#![feature(once_cell)]
|
||||
|
||||
use std::{
|
||||
io::ErrorKind,
|
||||
sync::OnceLock,
|
||||
|
@ -1,6 +1,6 @@
|
||||
// check-pass
|
||||
|
||||
#![feature(const_trait_impl, once_cell)]
|
||||
#![feature(const_trait_impl, lazy_cell)]
|
||||
|
||||
use std::sync::LazyLock;
|
||||
|
||||
|
@ -1,5 +1,3 @@
|
||||
#![feature(once_cell)]
|
||||
|
||||
fn require_sync<T: Sync>() {}
|
||||
//~^ NOTE required by this bound in `require_sync`
|
||||
//~| NOTE required by a bound in `require_sync`
|
||||
|
@ -1,5 +1,5 @@
|
||||
error[E0277]: `OnceCell<()>` cannot be shared between threads safely
|
||||
--> $DIR/suggest-once-cell.rs:8:20
|
||||
--> $DIR/suggest-once-cell.rs:6:20
|
||||
|
|
||||
LL | require_sync::<std::cell::OnceCell<()>>();
|
||||
| ^^^^^^^^^^^^^^^^^^^^^^^ `OnceCell<()>` cannot be shared between threads safely
|
||||
@ -7,7 +7,7 @@ LL | require_sync::<std::cell::OnceCell<()>>();
|
||||
= help: the trait `Sync` is not implemented for `OnceCell<()>`
|
||||
= note: if you want to do aliasing and mutation between multiple threads, use `std::sync::OnceLock` instead
|
||||
note: required by a bound in `require_sync`
|
||||
--> $DIR/suggest-once-cell.rs:3:20
|
||||
--> $DIR/suggest-once-cell.rs:1:20
|
||||
|
|
||||
LL | fn require_sync<T: Sync>() {}
|
||||
| ^^^^ required by this bound in `require_sync`
|
||||
|
@ -1,5 +1,3 @@
|
||||
#![feature(once_cell)]
|
||||
|
||||
fn require_sync<T: Sync>() {}
|
||||
//~^ NOTE required by this bound in `require_sync`
|
||||
//~| NOTE required by a bound in `require_sync`
|
||||
|
@ -1,5 +1,5 @@
|
||||
error[E0277]: `RefCell<()>` cannot be shared between threads safely
|
||||
--> $DIR/suggest-ref-cell.rs:8:20
|
||||
--> $DIR/suggest-ref-cell.rs:6:20
|
||||
|
|
||||
LL | require_sync::<std::cell::RefCell<()>>();
|
||||
| ^^^^^^^^^^^^^^^^^^^^^^ `RefCell<()>` cannot be shared between threads safely
|
||||
@ -7,7 +7,7 @@ LL | require_sync::<std::cell::RefCell<()>>();
|
||||
= help: the trait `Sync` is not implemented for `RefCell<()>`
|
||||
= note: if you want to do aliasing and mutation between multiple threads, use `std::sync::RwLock` instead
|
||||
note: required by a bound in `require_sync`
|
||||
--> $DIR/suggest-ref-cell.rs:3:20
|
||||
--> $DIR/suggest-ref-cell.rs:1:20
|
||||
|
|
||||
LL | fn require_sync<T: Sync>() {}
|
||||
| ^^^^ required by this bound in `require_sync`
|
||||
|
Loading…
Reference in New Issue
Block a user