std: Stabilize/deprecate features for 1.4
The FCP is coming to a close and 1.4 is coming out soon, so this brings in the libs team decision for all library features this cycle. Stabilized APIs: * `<Box<str>>::into_string` * `Arc::downgrade` * `Arc::get_mut` * `Arc::make_mut` * `Arc::try_unwrap` * `Box::from_raw` * `Box::into_raw` * `CStr::to_str` * `CStr::to_string_lossy` * `CString::from_raw` * `CString::into_raw` * `IntoRawFd::into_raw_fd` * `IntoRawFd` * `IntoRawHandle::into_raw_handle` * `IntoRawHandle` * `IntoRawSocket::into_raw_socket` * `IntoRawSocket` * `Rc::downgrade` * `Rc::get_mut` * `Rc::make_mut` * `Rc::try_unwrap` * `Result::expect` * `String::into_boxed_slice` * `TcpSocket::read_timeout` * `TcpSocket::set_read_timeout` * `TcpSocket::set_write_timeout` * `TcpSocket::write_timeout` * `UdpSocket::read_timeout` * `UdpSocket::set_read_timeout` * `UdpSocket::set_write_timeout` * `UdpSocket::write_timeout` * `Vec::append` * `Vec::split_off` * `VecDeque::append` * `VecDeque::retain` * `VecDeque::split_off` * `rc::Weak::upgrade` * `rc::Weak` * `slice::Iter::as_slice` * `slice::IterMut::into_slice` * `str::CharIndices::as_str` * `str::Chars::as_str` * `str::split_at_mut` * `str::split_at` * `sync::Weak::upgrade` * `sync::Weak` * `thread::park_timeout` * `thread::sleep` Deprecated APIs * `BTreeMap::with_b` * `BTreeSet::with_b` * `Option::as_mut_slice` * `Option::as_slice` * `Result::as_mut_slice` * `Result::as_slice` * `f32::from_str_radix` * `f64::from_str_radix` Closes #27277 Closes #27718 Closes #27736 Closes #27764 Closes #27765 Closes #27766 Closes #27767 Closes #27768 Closes #27769 Closes #27771 Closes #27773 Closes #27775 Closes #27776 Closes #27785 Closes #27792 Closes #27795 Closes #27797
This commit is contained in:
Alex Crichton
parent
79c6a4d55c
commit
f0b1326dc7
31 changed files with 121 additions and 140 deletions
|
|
@ -137,7 +137,7 @@ impl<T: ?Sized + Unsize<U>, U: ?Sized> CoerceUnsized<Arc<U>> for Arc<T> {}
|
|||
/// Weak pointers will not keep the data inside of the `Arc` alive, and can be
|
||||
/// used to break cycles between `Arc` pointers.
|
||||
#[unsafe_no_drop_flag]
|
||||
#[unstable(feature = "arc_weak", reason = "needs FCP", issue = "27718")]
|
||||
#[stable(feature = "arc_weak", since = "1.4.0")]
|
||||
pub struct Weak<T: ?Sized> {
|
||||
// FIXME #12808: strange name to try to avoid interfering with
|
||||
// field accesses of the contained type via Deref
|
||||
|
|
@ -201,7 +201,6 @@ impl<T> Arc<T> {
|
|||
/// # Examples
|
||||
///
|
||||
/// ```
|
||||
/// #![feature(arc_unique)]
|
||||
/// use std::sync::Arc;
|
||||
///
|
||||
/// let x = Arc::new(3);
|
||||
|
|
@ -212,7 +211,7 @@ impl<T> Arc<T> {
|
|||
/// assert_eq!(Arc::try_unwrap(x), Err(Arc::new(4)));
|
||||
/// ```
|
||||
#[inline]
|
||||
#[unstable(feature = "arc_unique", reason = "needs FCP", issue = "27718")]
|
||||
#[stable(feature = "arc_unique", since = "1.4.0")]
|
||||
pub fn try_unwrap(this: Self) -> Result<T, Self> {
|
||||
// See `drop` for why all these atomics are like this
|
||||
if this.inner().strong.compare_and_swap(1, 0, Release) != 1 { return Err(this) }
|
||||
|
|
@ -238,14 +237,13 @@ impl<T: ?Sized> Arc<T> {
|
|||
/// # Examples
|
||||
///
|
||||
/// ```
|
||||
/// #![feature(arc_weak)]
|
||||
/// use std::sync::Arc;
|
||||
///
|
||||
/// let five = Arc::new(5);
|
||||
///
|
||||
/// let weak_five = Arc::downgrade(&five);
|
||||
/// ```
|
||||
#[unstable(feature = "arc_weak", reason = "needs FCP", issue = "27718")]
|
||||
#[stable(feature = "arc_weak", since = "1.4.0")]
|
||||
pub fn downgrade(this: &Self) -> Weak<T> {
|
||||
loop {
|
||||
// This Relaxed is OK because we're checking the value in the CAS
|
||||
|
|
@ -270,14 +268,16 @@ impl<T: ?Sized> Arc<T> {
|
|||
|
||||
/// Get the number of weak references to this value.
|
||||
#[inline]
|
||||
#[unstable(feature = "arc_counts", reason = "not clearly useful, and racy", issue = "27718")]
|
||||
#[unstable(feature = "arc_counts", reason = "not clearly useful, and racy",
|
||||
issue = "28356")]
|
||||
pub fn weak_count(this: &Self) -> usize {
|
||||
this.inner().weak.load(SeqCst) - 1
|
||||
}
|
||||
|
||||
/// Get the number of strong references to this value.
|
||||
#[inline]
|
||||
#[unstable(feature = "arc_counts", reason = "not clearly useful, and racy", issue = "27718")]
|
||||
#[unstable(feature = "arc_counts", reason = "not clearly useful, and racy",
|
||||
issue = "28356")]
|
||||
pub fn strong_count(this: &Self) -> usize {
|
||||
this.inner().strong.load(SeqCst)
|
||||
}
|
||||
|
|
@ -366,7 +366,8 @@ impl<T: ?Sized> Deref for Arc<T> {
|
|||
}
|
||||
|
||||
impl<T: Clone> Arc<T> {
|
||||
#[unstable(feature = "arc_unique", reason = "renamed to Arc::make_mut", issue = "27718")]
|
||||
#[unstable(feature = "arc_make_unique", reason = "renamed to Arc::make_mut",
|
||||
issue = "27718")]
|
||||
#[deprecated(since = "1.4.0", reason = "renamed to Arc::make_mut")]
|
||||
pub fn make_unique(this: &mut Self) -> &mut T {
|
||||
Arc::make_mut(this)
|
||||
|
|
@ -381,7 +382,6 @@ impl<T: Clone> Arc<T> {
|
|||
/// # Examples
|
||||
///
|
||||
/// ```
|
||||
/// #![feature(arc_unique)]
|
||||
/// use std::sync::Arc;
|
||||
///
|
||||
/// let mut data = Arc::new(5);
|
||||
|
|
@ -398,7 +398,7 @@ impl<T: Clone> Arc<T> {
|
|||
///
|
||||
/// ```
|
||||
#[inline]
|
||||
#[unstable(feature = "arc_unique", reason = "needs FCP", issue = "27718")]
|
||||
#[stable(feature = "arc_unique", since = "1.4.0")]
|
||||
pub fn make_mut(this: &mut Self) -> &mut T {
|
||||
// Note that we hold both a strong reference and a weak reference.
|
||||
// Thus, releasing our strong reference only will not, by itself, cause
|
||||
|
|
@ -460,7 +460,6 @@ impl<T: ?Sized> Arc<T> {
|
|||
/// # Examples
|
||||
///
|
||||
/// ```
|
||||
/// #![feature(arc_unique)]
|
||||
/// use std::sync::Arc;
|
||||
///
|
||||
/// let mut x = Arc::new(3);
|
||||
|
|
@ -471,7 +470,7 @@ impl<T: ?Sized> Arc<T> {
|
|||
/// assert!(Arc::get_mut(&mut x).is_none());
|
||||
/// ```
|
||||
#[inline]
|
||||
#[unstable(feature = "arc_unique", reason = "needs FCP", issue = "27718")]
|
||||
#[stable(feature = "arc_unique", since = "1.4.0")]
|
||||
pub fn get_mut(this: &mut Self) -> Option<&mut T> {
|
||||
if this.is_unique() {
|
||||
// This unsafety is ok because we're guaranteed that the pointer
|
||||
|
|
@ -595,7 +594,6 @@ impl<T: ?Sized> Weak<T> {
|
|||
/// # Examples
|
||||
///
|
||||
/// ```
|
||||
/// #![feature(arc_weak)]
|
||||
/// use std::sync::Arc;
|
||||
///
|
||||
/// let five = Arc::new(5);
|
||||
|
|
@ -604,7 +602,7 @@ impl<T: ?Sized> Weak<T> {
|
|||
///
|
||||
/// let strong_five: Option<Arc<_>> = weak_five.upgrade();
|
||||
/// ```
|
||||
#[unstable(feature = "arc_weak", reason = "needs FCP", issue = "27718")]
|
||||
#[stable(feature = "arc_weak", since = "1.4.0")]
|
||||
pub fn upgrade(&self) -> Option<Arc<T>> {
|
||||
// We use a CAS loop to increment the strong count instead of a
|
||||
// fetch_add because once the count hits 0 it must never be above 0.
|
||||
|
|
@ -630,7 +628,7 @@ impl<T: ?Sized> Weak<T> {
|
|||
}
|
||||
}
|
||||
|
||||
#[unstable(feature = "arc_weak", reason = "needs FCP", issue = "27718")]
|
||||
#[stable(feature = "arc_weak", since = "1.4.0")]
|
||||
impl<T: ?Sized> Clone for Weak<T> {
|
||||
/// Makes a clone of the `Weak<T>`.
|
||||
///
|
||||
|
|
@ -639,7 +637,6 @@ impl<T: ?Sized> Clone for Weak<T> {
|
|||
/// # Examples
|
||||
///
|
||||
/// ```
|
||||
/// #![feature(arc_weak)]
|
||||
/// use std::sync::Arc;
|
||||
///
|
||||
/// let weak_five = Arc::downgrade(&Arc::new(5));
|
||||
|
|
@ -672,7 +669,6 @@ impl<T: ?Sized> Drop for Weak<T> {
|
|||
/// # Examples
|
||||
///
|
||||
/// ```
|
||||
/// #![feature(arc_weak)]
|
||||
/// use std::sync::Arc;
|
||||
///
|
||||
/// {
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue