/// 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
/// # Examples
///
/// ```
- /// #![feature(arc_unique)]
/// use std::sync::Arc;
///
/// let x = Arc::new(3);
/// 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) }
/// # 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
/// 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)
}
}
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)
/// # Examples
///
/// ```
- /// #![feature(arc_unique)]
/// use std::sync::Arc;
///
/// let mut data = Arc::new(5);
///
/// ```
#[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
/// # Examples
///
/// ```
- /// #![feature(arc_unique)]
/// use std::sync::Arc;
///
/// let mut x = Arc::new(3);
/// 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
/// # Examples
///
/// ```
- /// #![feature(arc_weak)]
/// use std::sync::Arc;
///
/// let five = Arc::new(5);
///
/// 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.
}
}
-#[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>`.
///
/// # Examples
///
/// ```
- /// #![feature(arc_weak)]
/// use std::sync::Arc;
///
/// let weak_five = Arc::downgrade(&Arc::new(5));
/// # Examples
///
/// ```
- /// #![feature(arc_weak)]
/// use std::sync::Arc;
///
/// {
/// Function is unsafe, because improper use of this function may
/// lead to memory problems like double-free, for example if the
/// function is called twice on the same raw pointer.
- #[unstable(feature = "box_raw",
- reason = "may be renamed or moved out of Box scope",
- issue = "27768")]
+ #[stable(feature = "box_raw", since = "1.4.0")]
#[inline]
- // NB: may want to be called from_ptr, see comments on CStr::from_ptr
pub unsafe fn from_raw(raw: *mut T) -> Self {
mem::transmute(raw)
}
/// `Box` does not specify, how memory is allocated.
///
/// # Examples
- /// ```
- /// #![feature(box_raw)]
///
+ /// ```
/// let seventeen = Box::new(17u32);
/// let raw = Box::into_raw(seventeen);
/// let boxed_again = unsafe { Box::from_raw(raw) };
/// ```
- #[unstable(feature = "box_raw", reason = "may be renamed",
- issue = "27768")]
+ #[stable(feature = "box_raw", since = "1.4.0")]
#[inline]
- // NB: may want to be called into_ptr, see comments on CStr::from_ptr
pub fn into_raw(b: Box<T>) -> *mut T {
unsafe { mem::transmute(b) }
}
/// # Examples
///
/// ```
- /// #![feature(box_raw)]
- ///
/// let x = Box::new(5);
/// let mut y = Box::new(10);
///
#![cfg_attr(stage0, feature(alloc_system))]
#![cfg_attr(not(stage0), feature(needs_allocator))]
-#![cfg_attr(test, feature(test, rustc_private, box_raw))]
+#![cfg_attr(test, feature(test, rustc_private))]
#[cfg(stage0)]
extern crate alloc_system;
// option. This file may not be copied, modified, or distributed
// except according to those terms.
-// FIXME(27718): rc_counts stuff is useful internally, but was previously public
#![allow(deprecated)]
//! Thread-local reference-counted boxes (the `Rc<T>` type).
//! documentation for more details on interior mutability.
//!
//! ```rust
-//! #![feature(rc_weak)]
-//!
//! use std::rc::Rc;
//! use std::rc::Weak;
//! use std::cell::RefCell;
/// assert_eq!(Rc::try_unwrap(x), Err(Rc::new(4)));
/// ```
#[inline]
- #[unstable(feature = "rc_unique", reason= "needs FCP", issue = "27718")]
+ #[stable(feature = "rc_unique", since = "1.4.0")]
pub fn try_unwrap(this: Self) -> Result<T, Self> {
if Rc::would_unwrap(&this) {
unsafe {
}
/// Checks if `Rc::try_unwrap` would return `Ok`.
- #[unstable(feature = "rc_would_unwrap", reason = "just added for niche usecase",
- issue = "27718")]
+ #[unstable(feature = "rc_would_unwrap",
+ reason = "just added for niche usecase",
+ issue = "28356")]
pub fn would_unwrap(this: &Self) -> bool {
Rc::strong_count(&this) == 1
}
/// # Examples
///
/// ```
- /// #![feature(rc_weak)]
- ///
/// use std::rc::Rc;
///
/// let five = Rc::new(5);
///
/// let weak_five = Rc::downgrade(&five);
/// ```
- #[unstable(feature = "rc_weak", reason = "needs FCP", issue = "27718")]
+ #[stable(feature = "rc_weak", since = "1.4.0")]
pub fn downgrade(this: &Self) -> Weak<T> {
this.inc_weak();
Weak { _ptr: this._ptr }
/// Get the number of weak references to this value.
#[inline]
- #[unstable(feature = "rc_counts", reason = "not clearly useful", issue = "27718")]
+ #[unstable(feature = "rc_counts", reason = "not clearly useful",
+ issue = "28356")]
pub fn weak_count(this: &Self) -> usize { this.weak() - 1 }
/// Get the number of strong references to this value.
#[inline]
- #[unstable(feature = "rc_counts", reason = "not clearly useful", issue = "27718")]
+ #[unstable(feature = "rc_counts", reason = "not clearly useful",
+ issue = "28356")]
pub fn strong_count(this: &Self) -> usize { this.strong() }
/// Returns true if there are no other `Rc` or `Weak<T>` values that share
/// assert!(Rc::is_unique(&five));
/// ```
#[inline]
- #[unstable(feature = "rc_counts", reason = "uniqueness has unclear meaning", issue = "27718")]
+ #[unstable(feature = "rc_counts", reason = "uniqueness has unclear meaning",
+ issue = "28356")]
pub fn is_unique(this: &Self) -> bool {
Rc::weak_count(this) == 0 && Rc::strong_count(this) == 1
}
/// # Examples
///
/// ```
- /// #![feature(rc_unique)]
- ///
/// use std::rc::Rc;
///
/// let mut x = Rc::new(3);
/// assert!(Rc::get_mut(&mut x).is_none());
/// ```
#[inline]
- #[unstable(feature = "rc_unique", reason = "needs FCP", issue = "27718")]
+ #[stable(feature = "rc_unique", since = "1.4.0")]
pub fn get_mut(this: &mut Self) -> Option<&mut T> {
if Rc::is_unique(this) {
let inner = unsafe { &mut **this._ptr };
impl<T: Clone> Rc<T> {
#[inline]
- #[unstable(feature = "rc_unique", reason = "renamed to Rc::make_mut", issue = "27718")]
+ #[unstable(feature = "rc_make_unique", reason = "renamed to Rc::make_mut",
+ issue = "27718")]
#[deprecated(since = "1.4.0", reason = "renamed to Rc::make_mut")]
pub fn make_unique(&mut self) -> &mut T {
Rc::make_mut(self)
///
/// ```
#[inline]
- #[unstable(feature = "rc_unique", reason = "needs FCP", issue = "27718")]
+ #[stable(feature = "rc_unique", since = "1.4.0")]
pub fn make_mut(this: &mut Self) -> &mut T {
if Rc::strong_count(this) != 1 {
// Gotta clone the data, there are other Rcs
///
/// See the [module level documentation](./index.html) for more.
#[unsafe_no_drop_flag]
-#[unstable(feature = "rc_weak", reason = "needs FCP", issue = "27718")]
+#[stable(feature = "rc_weak", since = "1.4.0")]
pub struct Weak<T: ?Sized> {
// FIXME #12808: strange names to try to avoid interfering with
// field accesses of the contained type via Deref
/// # Examples
///
/// ```
- /// #![feature(rc_weak)]
- ///
/// use std::rc::Rc;
///
/// let five = Rc::new(5);
///
/// let strong_five: Option<Rc<_>> = weak_five.upgrade();
/// ```
- #[unstable(feature = "rc_weak", reason = "needs FCP", issue = "27718")]
+ #[stable(feature = "rc_weak", since = "1.4.0")]
pub fn upgrade(&self) -> Option<Rc<T>> {
if self.strong() == 0 {
None
/// # Examples
///
/// ```
- /// #![feature(rc_weak)]
- ///
/// use std::rc::Rc;
///
/// {
}
}
-#[unstable(feature = "rc_weak", reason = "needs FCP", issue = "27718")]
+#[stable(feature = "rc_weak", since = "1.4.0")]
impl<T: ?Sized> Clone for Weak<T> {
/// Makes a clone of the `Weak<T>`.
/// # Examples
///
/// ```
- /// #![feature(rc_weak)]
- ///
/// use std::rc::Rc;
///
/// let weak_five = Rc::downgrade(&Rc::new(5));
impl<K: Ord, V> BTreeMap<K, V> {
/// Makes a new empty BTreeMap with a reasonable choice for B.
#[stable(feature = "rust1", since = "1.0.0")]
+ #[allow(deprecated)]
pub fn new() -> BTreeMap<K, V> {
//FIXME(Gankro): Tune this as a function of size_of<K/V>?
BTreeMap::with_b(6)
#[unstable(feature = "btree_b",
reason = "probably want this to be on the type, eventually",
issue = "27795")]
+ #[deprecated(since = "1.4.0", reason = "niche API")]
pub fn with_b(b: usize) -> BTreeMap<K, V> {
assert!(b > 1, "B must be greater than 1");
BTreeMap {
/// assert!(a.is_empty());
/// ```
#[stable(feature = "rust1", since = "1.0.0")]
+ #[allow(deprecated)]
pub fn clear(&mut self) {
let b = self.b;
// avoid recursive destructors by manually traversing the tree
#[unstable(feature = "btree_b",
reason = "probably want this to be on the type, eventually",
issue = "27795")]
+ #[deprecated(since = "1.4.0", reason = "niche API")]
+ #[allow(deprecated)]
pub fn with_b(b: usize) -> BTreeSet<T> {
BTreeSet { map: BTreeMap::with_b(b) }
}
/// assert_eq!(b, " 老虎 Léopard");
/// ```
#[inline]
- #[unstable(feature = "str_split_at", reason = "recently added",
- issue = "27792")]
+ #[stable(feature = "str_split_at", since = "1.4.0")]
pub fn split_at(&self, mid: usize) -> (&str, &str) {
core_str::StrExt::split_at(self, mid)
}
/// Divide one mutable string slice into two at an index.
#[inline]
- #[unstable(feature = "str_split_at", reason = "recently added",
- issue = "27792")]
+ #[stable(feature = "str_split_at", since = "1.4.0")]
pub fn split_at_mut(&mut self, mid: usize) -> (&mut str, &mut str) {
core_str::StrExt::split_at_mut(self, mid)
}
}
/// Converts the `Box<str>` into a `String` without copying or allocating.
- #[unstable(feature = "box_str",
- reason = "recently added, matches RFC",
- issue = "27785")]
+ #[stable(feature = "box_str", since = "1.4.0")]
pub fn into_string(self: Box<str>) -> String {
unsafe {
let slice = mem::transmute::<Box<str>, Box<[u8]>>(self);
/// Converts the string into `Box<str>`.
///
/// Note that this will drop any excess capacity.
- #[unstable(feature = "box_str",
- reason = "recently added, matches RFC",
- issue = "27785")]
+ #[stable(feature = "box_str", since = "1.4.0")]
pub fn into_boxed_str(self) -> Box<str> {
let slice = self.vec.into_boxed_slice();
unsafe { mem::transmute::<Box<[u8]>, Box<str>>(slice) }
/// Converts the string into `Box<str>`.
///
/// Note that this will drop any excess capacity.
- #[unstable(feature = "box_str",
+ #[unstable(feature = "box_str2",
reason = "recently added, matches RFC",
issue = "27785")]
#[deprecated(since = "1.4.0", reason = "renamed to `into_boxed_str`")]
/// # Examples
///
/// ```
- /// #![feature(append)]
- ///
/// let mut vec = vec![1, 2, 3];
/// let mut vec2 = vec![4, 5, 6];
/// vec.append(&mut vec2);
/// assert_eq!(vec2, []);
/// ```
#[inline]
- #[unstable(feature = "append",
- reason = "new API, waiting for dust to settle",
- issue = "27765")]
+ #[stable(feature = "append", since = "1.4.0")]
pub fn append(&mut self, other: &mut Self) {
self.reserve(other.len());
let len = self.len();
/// assert_eq!(vec2, [2, 3]);
/// ```
#[inline]
- #[unstable(feature = "split_off",
- reason = "new API, waiting for dust to settle",
- issue = "27766")]
+ #[stable(feature = "split_off", since = "1.4.0")]
pub fn split_off(&mut self, at: usize) -> Self {
assert!(at <= self.len(), "`at` out of bounds");
/// assert_eq!(buf2.len(), 2);
/// ```
#[inline]
- #[unstable(feature = "split_off",
- reason = "new API, waiting for dust to settle",
- issue = "27766")]
+ #[stable(feature = "split_off", since = "1.4.0")]
pub fn split_off(&mut self, at: usize) -> Self {
let len = self.len();
assert!(at <= len, "`at` out of bounds");
/// # Examples
///
/// ```
- /// #![feature(append)]
- ///
/// use std::collections::VecDeque;
///
/// let mut buf: VecDeque<_> = vec![1, 2, 3].into_iter().collect();
/// assert_eq!(buf2.len(), 0);
/// ```
#[inline]
- #[unstable(feature = "append",
- reason = "new API, waiting for dust to settle",
- issue = "27765")]
+ #[stable(feature = "append", since = "1.4.0")]
pub fn append(&mut self, other: &mut Self) {
// naive impl
self.extend(other.drain());
/// let v: Vec<_> = buf.into_iter().collect();
/// assert_eq!(&v[..], &[2, 4]);
/// ```
- #[unstable(feature = "vec_deque_retain",
- reason = "new API, waiting for dust to settle",
- issue = "27767")]
+ #[stable(feature = "vec_deque_retain", since = "1.4.0")]
pub fn retain<F>(&mut self, mut f: F) where F: FnMut(&T) -> bool {
let len = self.len();
let mut del = 0;
#[unstable(feature = "as_slice",
reason = "waiting for mut conventions",
issue = "27776")]
+ #[deprecated(since = "1.4.0", reason = "niche API, unclear of usefulness")]
pub fn as_mut_slice(&mut self) -> &mut [T] {
match *self {
Some(ref mut x) => {
/// Converts from `Option<T>` to `&[T]` (without copying)
#[inline]
- #[unstable(feature = "as_slice", since = "unsure of the utility here",
+ #[unstable(feature = "as_slice", reason = "unsure of the utility here",
issue = "27776")]
+ #[deprecated(since = "1.4.0", reason = "niche API, unclear of usefulness")]
pub fn as_slice(&self) -> &[T] {
match *self {
Some(ref x) => slice::ref_slice(x),
/// Converts from `Result<T, E>` to `&[T]` (without copying)
#[inline]
- #[unstable(feature = "as_slice", since = "unsure of the utility here",
+ #[unstable(feature = "as_slice", reason = "unsure of the utility here",
issue = "27776")]
+ #[deprecated(since = "1.4.0", reason = "niche API, unclear of usefulness")]
pub fn as_slice(&self) -> &[T] {
match *self {
Ok(ref x) => slice::ref_slice(x),
#[unstable(feature = "as_slice",
reason = "waiting for mut conventions",
issue = "27776")]
+ #[deprecated(since = "1.4.0", reason = "niche API, unclear of usefulness")]
pub fn as_mut_slice(&mut self) -> &mut [T] {
match *self {
Ok(ref mut x) => slice::mut_ref_slice(x),
///
/// # Examples
/// ```{.should_panic}
- /// #![feature(result_expect)]
/// let x: Result<u32, &str> = Err("emergency failure");
/// x.expect("Testing expect"); // panics with `Testing expect: emergency failure`
/// ```
#[inline]
- #[unstable(feature = "result_expect", reason = "newly introduced", issue = "27277")]
+ #[stable(feature = "result_expect", since = "1.4.0")]
pub fn expect(self, msg: &str) -> T {
match self {
Ok(t) => t,
///
/// This has the same lifetime as the original slice, and so the
/// iterator can continue to be used while this exists.
- #[unstable(feature = "iter_to_slice", issue = "27775")]
+ #[stable(feature = "iter_to_slice", since = "1.4.0")]
pub fn as_slice(&self) -> &'a [T] {
make_slice!(self.ptr, self.end)
}
/// to consume the iterator. Consider using the `Slice` and
/// `SliceMut` implementations for obtaining slices with more
/// restricted lifetimes that do not consume the iterator.
- #[unstable(feature = "iter_to_slice", issue = "27775")]
+ #[stable(feature = "iter_to_slice", since = "1.4.0")]
pub fn into_slice(self) -> &'a mut [T] {
make_mut_slice!(self.ptr, self.end)
}
///
/// This has the same lifetime as the original slice, and so the
/// iterator can continue to be used while this exists.
- #[unstable(feature = "iter_to_slice", issue = "27775")]
+ #[stable(feature = "iter_to_slice", since = "1.4.0")]
#[inline]
pub fn as_str(&self) -> &'a str {
unsafe { from_utf8_unchecked(self.iter.as_slice()) }
///
/// This has the same lifetime as the original slice, and so the
/// iterator can continue to be used while this exists.
- #[unstable(feature = "iter_to_slice", issue = "27775")]
+ #[stable(feature = "iter_to_slice", since = "1.4.0")]
#[inline]
pub fn as_str(&self) -> &'a str {
self.iter.as_str()
#![feature(rand)]
#![feature(range_inclusive)]
#![feature(raw)]
-#![feature(result_expect)]
#![feature(slice_bytes)]
#![feature(slice_patterns)]
#![feature(step_by)]
html_playground_url = "https://play.rust-lang.org/")]
#![deny(missing_docs)]
-#![feature(box_raw)]
#![feature(box_syntax)]
#![feature(const_fn)]
#![feature(iter_cmp)]
html_favicon_url = "https://doc.rust-lang.org/favicon.ico",
html_root_url = "https://doc.rust-lang.org/nightly/")]
-#![feature(append)]
#![feature(associated_consts)]
#![feature(box_patterns)]
#![feature(box_syntax)]
#![feature(rustc_private)]
#![feature(slice_splits)]
#![feature(staged_api)]
-#![feature(rc_weak)]
#[macro_use] extern crate log;
#[macro_use] extern crate syntax;
#![feature(unicode)]
#![feature(unicode)]
#![feature(vec_push_all)]
-#![feature(rc_weak)]
#![allow(trivial_casts)]
#![allow(non_camel_case_types)]
-#![feature(append)]
#![feature(box_patterns)]
#![feature(box_syntax)]
#![feature(drain)]
/// Converting a foreign C string into a Rust `String`
///
/// ```no_run
-/// # #![feature(libc,cstr_to_str)]
+/// # #![feature(libc)]
/// extern crate libc;
/// use std::ffi::CStr;
///
/// The only appropriate argument is a pointer obtained by calling
/// `into_ptr`. The length of the string will be recalculated
/// using the pointer.
- #[unstable(feature = "cstr_memory", reason = "recently added",
+ #[unstable(feature = "cstr_memory2", reason = "recently added",
issue = "27769")]
#[deprecated(since = "1.4.0", reason = "renamed to from_raw")]
pub unsafe fn from_ptr(ptr: *const libc::c_char) -> CString {
/// The only appropriate argument is a pointer obtained by calling
/// `into_raw`. The length of the string will be recalculated
/// using the pointer.
- #[unstable(feature = "cstr_memory", reason = "recently added",
- issue = "27769")]
+ #[stable(feature = "cstr_memory", since = "1.4.0")]
pub unsafe fn from_raw(ptr: *mut libc::c_char) -> CString {
let len = libc::strlen(ptr) + 1; // Including the NUL byte
let slice = slice::from_raw_parts(ptr, len as usize);
/// this string.
///
/// Failure to call `from_raw` will lead to a memory leak.
- #[unstable(feature = "cstr_memory", reason = "recently added",
+ #[unstable(feature = "cstr_memory2", reason = "recently added",
issue = "27769")]
#[deprecated(since = "1.4.0", reason = "renamed to into_raw")]
pub fn into_ptr(self) -> *const libc::c_char {
/// this string.
///
/// Failure to call `from_ptr` will lead to a memory leak.
- #[unstable(feature = "cstr_memory", reason = "recently added",
- issue = "27769")]
+ #[stable(feature = "cstr_memory", since = "1.4.0")]
pub fn into_raw(self) -> *mut libc::c_char {
Box::into_raw(self.inner) as *mut libc::c_char
}
/// > after a 0-cost cast, but it is planned to alter its definition in the
/// > future to perform the length calculation in addition to the UTF-8
/// > check whenever this method is called.
- #[unstable(feature = "cstr_to_str", reason = "recently added",
- issue = "27764")]
+ #[stable(feature = "cstr_to_str", since = "1.4.0")]
pub fn to_str(&self) -> Result<&str, str::Utf8Error> {
// NB: When CStr is changed to perform the length check in .to_bytes()
// instead of in from_ptr(), it may be worth considering if this should
/// > after a 0-cost cast, but it is planned to alter its definition in the
/// > future to perform the length calculation in addition to the UTF-8
/// > check whenever this method is called.
- #[unstable(feature = "cstr_to_str", reason = "recently added",
- issue = "27764")]
+ #[stable(feature = "cstr_to_str", since = "1.4.0")]
pub fn to_string_lossy(&self) -> Cow<str> {
String::from_utf8_lossy(self.to_bytes())
}
#![feature(allow_internal_unstable)]
#![feature(associated_consts)]
#![feature(borrow_state)]
-#![feature(box_raw)]
#![feature(box_syntax)]
#![feature(char_from_unchecked)]
#![feature(char_internals)]
/// If the value specified is `None`, then `read` calls will block
/// indefinitely. It is an error to pass the zero `Duration` to this
/// method.
- #[unstable(feature = "socket_timeout", reason = "RFC 1047 - recently added",
- issue = "27773")]
+ ///
+ /// # Note
+ ///
+ /// Platforms may return a different error code whenever a read times out as
+ /// a result of setting this option. For example Unix typically returns an
+ /// error of the kind `WouldBlock`, but Windows may return `TimedOut`.
+ #[stable(feature = "socket_timeout", since = "1.4.0")]
pub fn set_read_timeout(&self, dur: Option<Duration>) -> io::Result<()> {
self.0.set_read_timeout(dur)
}
/// If the value specified is `None`, then `write` calls will block
/// indefinitely. It is an error to pass the zero `Duration` to this
/// method.
- #[unstable(feature = "socket_timeout", reason = "RFC 1047 - recently added",
- issue = "27773")]
+ ///
+ /// # Note
+ ///
+ /// Platforms may return a different error code whenever a write times out
+ /// as a result of setting this option. For example Unix typically returns
+ /// an error of the kind `WouldBlock`, but Windows may return `TimedOut`.
+ #[stable(feature = "socket_timeout", since = "1.4.0")]
pub fn set_write_timeout(&self, dur: Option<Duration>) -> io::Result<()> {
self.0.set_write_timeout(dur)
}
/// # Note
///
/// Some platforms do not provide access to the current timeout.
- #[unstable(feature = "socket_timeout", reason = "RFC 1047 - recently added",
- issue = "27773")]
+ #[stable(feature = "socket_timeout", since = "1.4.0")]
pub fn read_timeout(&self) -> io::Result<Option<Duration>> {
self.0.read_timeout()
}
/// # Note
///
/// Some platforms do not provide access to the current timeout.
- #[unstable(feature = "socket_timeout", reason = "RFC 1047 - recently added",
- issue = "27773")]
+ #[stable(feature = "socket_timeout", since = "1.4.0")]
pub fn write_timeout(&self) -> io::Result<Option<Duration>> {
self.0.write_timeout()
}
/// If the value specified is `None`, then `read` calls will block
/// indefinitely. It is an error to pass the zero `Duration` to this
/// method.
- #[unstable(feature = "socket_timeout", reason = "RFC 1047 - recently added",
- issue = "27773")]
+ ///
+ /// # Note
+ ///
+ /// Platforms may return a different error code whenever a read times out as
+ /// a result of setting this option. For example Unix typically returns an
+ /// error of the kind `WouldBlock`, but Windows may return `TimedOut`.
+ #[stable(feature = "socket_timeout", since = "1.4.0")]
pub fn set_read_timeout(&self, dur: Option<Duration>) -> io::Result<()> {
self.0.set_read_timeout(dur)
}
/// If the value specified is `None`, then `write` calls will block
/// indefinitely. It is an error to pass the zero `Duration` to this
/// method.
- #[unstable(feature = "socket_timeout", reason = "RFC 1047 - recently added",
- issue = "27773")]
+ ///
+ /// # Note
+ ///
+ /// Platforms may return a different error code whenever a write times out
+ /// as a result of setting this option. For example Unix typically returns
+ /// an error of the kind `WouldBlock`, but Windows may return `TimedOut`.
+ #[stable(feature = "socket_timeout", since = "1.4.0")]
pub fn set_write_timeout(&self, dur: Option<Duration>) -> io::Result<()> {
self.0.set_write_timeout(dur)
}
/// Returns the read timeout of this socket.
///
/// If the timeout is `None`, then `read` calls will block indefinitely.
- #[unstable(feature = "socket_timeout", reason = "RFC 1047 - recently added",
- issue = "27773")]
+ #[stable(feature = "socket_timeout", since = "1.4.0")]
pub fn read_timeout(&self) -> io::Result<Option<Duration>> {
self.0.read_timeout()
}
/// Returns the write timeout of this socket.
///
/// If the timeout is `None`, then `write` calls will block indefinitely.
- #[unstable(feature = "socket_timeout", reason = "RFC 1047 - recently added",
- issue = "27773")]
+ #[stable(feature = "socket_timeout", since = "1.4.0")]
pub fn write_timeout(&self) -> io::Result<Option<Duration>> {
self.0.write_timeout()
}
/// Parses a float as with a given radix
#[unstable(feature = "float_from_str_radix", reason = "recently moved API",
issue = "27736")]
+ #[deprecated(since = "1.4.0",
+ reason = "unclear how useful or correct this is")]
pub fn from_str_radix(s: &str, radix: u32) -> Result<f32, ParseFloatError> {
num::Float::from_str_radix(s, radix)
}
/// Parses a float as with a given radix
#[unstable(feature = "float_from_str_radix", reason = "recently moved API",
issue = "27736")]
+ #[deprecated(since = "1.4.0",
+ reason = "unclear how useful or correct this is")]
pub fn from_str_radix(s: &str, radix: u32) -> Result<f64, ParseFloatError> {
num::Float::from_str_radix(s, radix)
}
/// the raw pointer. It doesn't destroy `T` or deallocate any memory.
///
/// ```
-/// #![feature(box_raw)]
-///
/// let my_speed: Box<i32> = Box::new(88);
/// let my_speed: *mut i32 = Box::into_raw(my_speed);
///
/// A trait to express the ability to consume an object and acquire ownership of
/// its raw file descriptor.
-#[unstable(feature = "into_raw_os", reason = "recently added API",
- issue = "27797")]
+#[stable(feature = "into_raw_os", since = "1.4.0")]
pub trait IntoRawFd {
/// Consumes this object, returning the raw underlying file descriptor.
///
/// This function **transfers ownership** of the underlying file descriptor
/// to the caller. Callers are then the unique owners of the file descriptor
/// and must close the descriptor once it's no longer needed.
+ #[stable(feature = "into_raw_os", since = "1.4.0")]
fn into_raw_fd(self) -> RawFd;
}
fs::File::from_inner(sys::fs::File::from_inner(fd))
}
}
+#[stable(feature = "into_raw_os", since = "1.4.0")]
impl IntoRawFd for fs::File {
fn into_raw_fd(self) -> RawFd {
self.into_inner().into_fd().into_raw()
}
}
+#[stable(feature = "into_raw_os", since = "1.4.0")]
impl IntoRawFd for net::TcpStream {
fn into_raw_fd(self) -> RawFd {
self.into_inner().into_socket().into_inner()
}
}
+#[stable(feature = "into_raw_os", since = "1.4.0")]
impl IntoRawFd for net::TcpListener {
fn into_raw_fd(self) -> RawFd {
self.into_inner().into_socket().into_inner()
}
}
+#[stable(feature = "into_raw_os", since = "1.4.0")]
impl IntoRawFd for net::UdpSocket {
fn into_raw_fd(self) -> RawFd {
self.into_inner().into_socket().into_inner()
/// A trait to express the ability to consume an object and acquire ownership of
/// its raw `HANDLE`.
-#[unstable(feature = "into_raw_os", reason = "recently added API",
- issue = "27797")]
+#[stable(feature = "into_raw_os", since = "1.4.0")]
pub trait IntoRawHandle {
/// Consumes this object, returning the raw underlying handle.
///
/// This function **transfers ownership** of the underlying handle to the
/// caller. Callers are then the unique owners of the handle and must close
/// it once it's no longer needed.
+ #[stable(feature = "into_raw_os", since = "1.4.0")]
fn into_raw_handle(self) -> RawHandle;
}
}
}
+#[stable(feature = "into_raw_os", since = "1.4.0")]
impl IntoRawHandle for fs::File {
fn into_raw_handle(self) -> RawHandle {
self.into_inner().into_handle().into_raw() as *mut _
/// A trait to express the ability to consume an object and acquire ownership of
/// its raw `SOCKET`.
-#[unstable(feature = "into_raw_os", reason = "recently added API",
- issue = "27797")]
+#[stable(feature = "into_raw_os", since = "1.4.0")]
pub trait IntoRawSocket {
/// Consumes this object, returning the raw underlying socket.
///
/// This function **transfers ownership** of the underlying socket to the
/// caller. Callers are then the unique owners of the socket and must close
/// it once it's no longer needed.
+ #[stable(feature = "into_raw_os", since = "1.4.0")]
fn into_raw_socket(self) -> RawSocket;
}
}
}
+#[stable(feature = "into_raw_os", since = "1.4.0")]
impl IntoRawSocket for net::TcpStream {
fn into_raw_socket(self) -> RawSocket {
self.into_inner().into_socket().into_inner()
}
}
+#[stable(feature = "into_raw_os", since = "1.4.0")]
impl IntoRawSocket for net::TcpListener {
fn into_raw_socket(self) -> RawSocket {
self.into_inner().into_socket().into_inner()
}
}
+#[stable(feature = "into_raw_os", since = "1.4.0")]
impl IntoRawSocket for net::UdpSocket {
fn into_raw_socket(self) -> RawSocket {
self.into_inner().into_socket().into_inner()
/// signal being received or a spurious wakeup. Platforms which do not support
/// nanosecond precision for sleeping will have `dur` rounded up to the nearest
/// granularity of time they can sleep for.
-#[unstable(feature = "thread_sleep", reason = "waiting on Duration",
- issue = "27771")]
+#[stable(feature = "thread_sleep", since = "1.4.0")]
pub fn sleep(dur: Duration) {
imp::Thread::sleep(dur)
}
///
/// Platforms which do not support nanosecond precision for sleeping will have
/// `dur` rounded up to the nearest granularity of time they can sleep for.
-#[unstable(feature = "park_timeout", reason = "waiting on Duration",
- issue = "27771")]
+#[stable(feature = "park_timeout", since = "1.4.0")]
pub fn park_timeout(dur: Duration) {
let thread = current();
let mut guard = thread.inner.lock.lock().unwrap();
// pretty-expanded FIXME #23616
#![feature(static_mutex, static_rwlock, static_condvar)]
-#![feature(arc_weak, semaphore)]
+#![feature(semaphore)]
use std::sync;