This commit stabilizes and deprecates the FCP (final comment period) APIs for
the upcoming 1.7 beta release. The specific APIs which changed were:
Stabilized
* `Path::strip_prefix` (renamed from `relative_from`)
* `path::StripPrefixError` (new error type returned from `strip_prefix`)
* `Ipv4Addr::is_loopback`
* `Ipv4Addr::is_private`
* `Ipv4Addr::is_link_local`
* `Ipv4Addr::is_multicast`
* `Ipv4Addr::is_broadcast`
* `Ipv4Addr::is_documentation`
* `Ipv6Addr::is_unspecified`
* `Ipv6Addr::is_loopback`
* `Ipv6Addr::is_unique_local`
* `Ipv6Addr::is_multicast`
* `Vec::as_slice`
* `Vec::as_mut_slice`
* `String::as_str`
* `String::as_mut_str`
* `<[T]>::clone_from_slice` - the `usize` return value is removed
* `<[T]>::sort_by_key`
* `i32::checked_rem` (and other signed types)
* `i32::checked_neg` (and other signed types)
* `i32::checked_shl` (and other signed types)
* `i32::checked_shr` (and other signed types)
* `i32::saturating_mul` (and other signed types)
* `i32::overflowing_add` (and other signed types)
* `i32::overflowing_sub` (and other signed types)
* `i32::overflowing_mul` (and other signed types)
* `i32::overflowing_div` (and other signed types)
* `i32::overflowing_rem` (and other signed types)
* `i32::overflowing_neg` (and other signed types)
* `i32::overflowing_shl` (and other signed types)
* `i32::overflowing_shr` (and other signed types)
* `u32::checked_rem` (and other unsigned types)
* `u32::checked_neg` (and other unsigned types)
* `u32::checked_shl` (and other unsigned types)
* `u32::saturating_mul` (and other unsigned types)
* `u32::overflowing_add` (and other unsigned types)
* `u32::overflowing_sub` (and other unsigned types)
* `u32::overflowing_mul` (and other unsigned types)
* `u32::overflowing_div` (and other unsigned types)
* `u32::overflowing_rem` (and other unsigned types)
* `u32::overflowing_neg` (and other unsigned types)
* `u32::overflowing_shl` (and other unsigned types)
* `u32::overflowing_shr` (and other unsigned types)
* `ffi::IntoStringError`
* `CString::into_string`
* `CString::into_bytes`
* `CString::into_bytes_with_nul`
* `From<CString> for Vec<u8>`
* `From<CString> for Vec<u8>`
* `IntoStringError::into_cstring`
* `IntoStringError::utf8_error`
* `Error for IntoStringError`
Deprecated
* `Path::relative_from` - renamed to `strip_prefix`
* `Path::prefix` - use `components().next()` instead
* `os::unix::fs` constants - moved to the `libc` crate
* `fmt::{radix, Radix, RadixFmt}` - not used enough to stabilize
* `IntoCow` - conflicts with `Into` and may come back later
* `i32::{BITS, BYTES}` (and other integers) - not pulling their weight
* `DebugTuple::formatter` - will be removed
* `sync::Semaphore` - not used enough and confused with system semaphores
Closes #23284
cc #27709 (still lots more methods though)
Closes #27712
Closes #27722
Closes #27728
Closes #27735
Closes #27729
Closes #27755
Closes #27782
Closes #27798
52 lines
2 KiB
Rust
52 lines
2 KiB
Rust
// Copyright 2013 The Rust Project Developers. See the COPYRIGHT
|
|
// file at the top-level directory of this distribution and at
|
|
// http://rust-lang.org/COPYRIGHT.
|
|
//
|
|
// Licensed under the Apache License, Version 2.0 <LICENSE-APACHE or
|
|
// http://www.apache.org/licenses/LICENSE-2.0> or the MIT license
|
|
// <LICENSE-MIT or http://opensource.org/licenses/MIT>, at your
|
|
// option. This file may not be copied, modified, or distributed
|
|
// except according to those terms.
|
|
|
|
//! Useful synchronization primitives
|
|
//!
|
|
//! This module contains useful safe and unsafe synchronization primitives.
|
|
//! Most of the primitives in this module do not provide any sort of locking
|
|
//! and/or blocking at all, but rather provide the necessary tools to build
|
|
//! other types of concurrent primitives.
|
|
|
|
#![stable(feature = "rust1", since = "1.0.0")]
|
|
|
|
#[stable(feature = "rust1", since = "1.0.0")]
|
|
pub use alloc::arc::{Arc, Weak};
|
|
#[stable(feature = "rust1", since = "1.0.0")]
|
|
pub use core::sync::atomic;
|
|
|
|
#[stable(feature = "rust1", since = "1.0.0")]
|
|
pub use self::barrier::{Barrier, BarrierWaitResult};
|
|
#[stable(feature = "rust1", since = "1.0.0")]
|
|
pub use self::condvar::{Condvar, StaticCondvar, WaitTimeoutResult, CONDVAR_INIT};
|
|
#[stable(feature = "rust1", since = "1.0.0")]
|
|
pub use self::mutex::MUTEX_INIT;
|
|
#[stable(feature = "rust1", since = "1.0.0")]
|
|
pub use self::mutex::{Mutex, MutexGuard, StaticMutex};
|
|
#[stable(feature = "rust1", since = "1.0.0")]
|
|
pub use self::once::{Once, ONCE_INIT};
|
|
#[stable(feature = "rust1", since = "1.0.0")]
|
|
pub use sys_common::poison::{PoisonError, TryLockError, TryLockResult, LockResult};
|
|
#[stable(feature = "rust1", since = "1.0.0")]
|
|
pub use self::rwlock::{RwLockReadGuard, RwLockWriteGuard};
|
|
#[stable(feature = "rust1", since = "1.0.0")]
|
|
pub use self::rwlock::{RwLock, StaticRwLock, RW_LOCK_INIT};
|
|
#[stable(feature = "rust1", since = "1.0.0")]
|
|
#[allow(deprecated)]
|
|
pub use self::semaphore::{Semaphore, SemaphoreGuard};
|
|
|
|
pub mod mpsc;
|
|
|
|
mod barrier;
|
|
mod condvar;
|
|
mod mutex;
|
|
mod once;
|
|
mod rwlock;
|
|
mod semaphore;
|