Navigation Menu

Skip to content

Commit

Permalink
Add a few missing stability markers.
Browse files Browse the repository at this point in the history
  • Loading branch information
chris-morgan committed Jan 30, 2015
1 parent 52c74e6 commit 9836742
Show file tree
Hide file tree
Showing 4 changed files with 38 additions and 0 deletions.
3 changes: 3 additions & 0 deletions src/libstd/collections/hash/map.rs
Expand Up @@ -46,6 +46,7 @@ use super::table::BucketState::{
use super::state::HashState;

const INITIAL_LOG2_CAP: uint = 5;
#[unstable(feature = "std_misc")]
pub const INITIAL_CAPACITY: uint = 1 << INITIAL_LOG2_CAP; // 2^5

/// The default behavior of HashMap implements a load factor of 90.9%.
Expand Down Expand Up @@ -1596,6 +1597,8 @@ impl Default for RandomState {
/// typically declare an ability to explicitly hash into this particular type,
/// but rather in a `H: hash::Writer` type parameter.
#[allow(missing_copy_implementations)]
#[unstable(feature = "std_misc",
reason = "hashing an hash maps may be altered")]
pub struct Hasher { inner: SipHasher }

impl hash::Writer for Hasher {
Expand Down
2 changes: 2 additions & 0 deletions src/libstd/collections/hash/state.rs
Expand Up @@ -24,6 +24,7 @@ use hash;
/// algorithm can implement the `Default` trait and create hash maps with the
/// `DefaultState` structure. This state is 0-sized and will simply delegate
/// to `Default` when asked to create a hasher.
#[unstable(feature = "std_misc", reason = "hasher stuff is unclear")]
pub trait HashState {
type Hasher: hash::Hasher;

Expand All @@ -35,6 +36,7 @@ pub trait HashState {
/// default trait.
///
/// This struct has is 0-sized and does not need construction.
#[unstable(feature = "std_misc", reason = "hasher stuff is unclear")]
pub struct DefaultState<H>;

impl<H: Default + hash::Hasher> HashState for DefaultState<H> {
Expand Down
31 changes: 31 additions & 0 deletions src/libstd/time/duration.rs
Expand Up @@ -45,19 +45,22 @@ macro_rules! try_opt {

/// ISO 8601 time duration with nanosecond precision.
/// This also allows for the negative duration; see individual methods for details.
#[unstable(feature = "std_misc")]
#[derive(Clone, Copy, PartialEq, Eq, PartialOrd, Ord, Debug)]
pub struct Duration {
secs: i64,
nanos: i32, // Always 0 <= nanos < NANOS_PER_SEC
}

/// The minimum possible `Duration`: `i64::MIN` milliseconds.
#[unstable(feature = "std_misc")]
pub const MIN: Duration = Duration {
secs: i64::MIN / MILLIS_PER_SEC - 1,
nanos: NANOS_PER_SEC + (i64::MIN % MILLIS_PER_SEC) as i32 * NANOS_PER_MILLI
};

/// The maximum possible `Duration`: `i64::MAX` milliseconds.
#[unstable(feature = "std_misc")]
pub const MAX: Duration = Duration {
secs: i64::MAX / MILLIS_PER_SEC,
nanos: (i64::MAX % MILLIS_PER_SEC) as i32 * NANOS_PER_MILLI
Expand All @@ -68,6 +71,7 @@ impl Duration {
/// Equivalent to `Duration::seconds(weeks * 7 * 24 * 60 * 60), with overflow checks.
/// Panics when the duration is out of bounds.
#[inline]
#[unstable(feature = "std_misc")]
pub fn weeks(weeks: i64) -> Duration {
let secs = weeks.checked_mul(SECS_PER_WEEK).expect("Duration::weeks out of bounds");
Duration::seconds(secs)
Expand All @@ -77,6 +81,7 @@ impl Duration {
/// Equivalent to `Duration::seconds(days * 24 * 60 * 60)` with overflow checks.
/// Panics when the duration is out of bounds.
#[inline]
#[unstable(feature = "std_misc")]
pub fn days(days: i64) -> Duration {
let secs = days.checked_mul(SECS_PER_DAY).expect("Duration::days out of bounds");
Duration::seconds(secs)
Expand All @@ -86,6 +91,7 @@ impl Duration {
/// Equivalent to `Duration::seconds(hours * 60 * 60)` with overflow checks.
/// Panics when the duration is out of bounds.
#[inline]
#[unstable(feature = "std_misc")]
pub fn hours(hours: i64) -> Duration {
let secs = hours.checked_mul(SECS_PER_HOUR).expect("Duration::hours ouf of bounds");
Duration::seconds(secs)
Expand All @@ -95,6 +101,7 @@ impl Duration {
/// Equivalent to `Duration::seconds(minutes * 60)` with overflow checks.
/// Panics when the duration is out of bounds.
#[inline]
#[unstable(feature = "std_misc")]
pub fn minutes(minutes: i64) -> Duration {
let secs = minutes.checked_mul(SECS_PER_MINUTE).expect("Duration::minutes out of bounds");
Duration::seconds(secs)
Expand All @@ -104,6 +111,7 @@ impl Duration {
/// Panics when the duration is more than `i64::MAX` milliseconds
/// or less than `i64::MIN` milliseconds.
#[inline]
#[unstable(feature = "std_misc")]
pub fn seconds(seconds: i64) -> Duration {
let d = Duration { secs: seconds, nanos: 0 };
if d < MIN || d > MAX {
Expand All @@ -114,6 +122,7 @@ impl Duration {

/// Makes a new `Duration` with given number of milliseconds.
#[inline]
#[unstable(feature = "std_misc")]
pub fn milliseconds(milliseconds: i64) -> Duration {
let (secs, millis) = div_mod_floor_64(milliseconds, MILLIS_PER_SEC);
let nanos = millis as i32 * NANOS_PER_MILLI;
Expand All @@ -122,6 +131,7 @@ impl Duration {

/// Makes a new `Duration` with given number of microseconds.
#[inline]
#[unstable(feature = "std_misc")]
pub fn microseconds(microseconds: i64) -> Duration {
let (secs, micros) = div_mod_floor_64(microseconds, MICROS_PER_SEC);
let nanos = micros as i32 * NANOS_PER_MICRO;
Expand All @@ -130,13 +140,15 @@ impl Duration {

/// Makes a new `Duration` with given number of nanoseconds.
#[inline]
#[unstable(feature = "std_misc")]
pub fn nanoseconds(nanos: i64) -> Duration {
let (secs, nanos) = div_mod_floor_64(nanos, NANOS_PER_SEC as i64);
Duration { secs: secs, nanos: nanos as i32 }
}

/// Runs a closure, returning the duration of time it took to run the
/// closure.
#[unstable(feature = "std_misc")]
pub fn span<F>(f: F) -> Duration where F: FnOnce() {
let before = super::precise_time_ns();
f();
Expand All @@ -145,28 +157,33 @@ impl Duration {

/// Returns the total number of whole weeks in the duration.
#[inline]
#[unstable(feature = "std_misc")]
pub fn num_weeks(&self) -> i64 {
self.num_days() / 7
}

/// Returns the total number of whole days in the duration.
#[unstable(feature = "std_misc")]
pub fn num_days(&self) -> i64 {
self.num_seconds() / SECS_PER_DAY
}

/// Returns the total number of whole hours in the duration.
#[inline]
#[unstable(feature = "std_misc")]
pub fn num_hours(&self) -> i64 {
self.num_seconds() / SECS_PER_HOUR
}

/// Returns the total number of whole minutes in the duration.
#[inline]
#[unstable(feature = "std_misc")]
pub fn num_minutes(&self) -> i64 {
self.num_seconds() / SECS_PER_MINUTE
}

/// Returns the total number of whole seconds in the duration.
#[unstable(feature = "std_misc")]
pub fn num_seconds(&self) -> i64 {
// If secs is negative, nanos should be subtracted from the duration.
if self.secs < 0 && self.nanos > 0 {
Expand All @@ -188,6 +205,7 @@ impl Duration {
}

/// Returns the total number of whole milliseconds in the duration,
#[unstable(feature = "std_misc")]
pub fn num_milliseconds(&self) -> i64 {
// A proper Duration will not overflow, because MIN and MAX are defined
// such that the range is exactly i64 milliseconds.
Expand All @@ -198,6 +216,7 @@ impl Duration {

/// Returns the total number of whole microseconds in the duration,
/// or `None` on overflow (exceeding 2^63 microseconds in either direction).
#[unstable(feature = "std_misc")]
pub fn num_microseconds(&self) -> Option<i64> {
let secs_part = try_opt!(self.num_seconds().checked_mul(MICROS_PER_SEC));
let nanos_part = self.nanos_mod_sec() / NANOS_PER_MICRO;
Expand All @@ -206,13 +225,15 @@ impl Duration {

/// Returns the total number of whole nanoseconds in the duration,
/// or `None` on overflow (exceeding 2^63 nanoseconds in either direction).
#[unstable(feature = "std_misc")]
pub fn num_nanoseconds(&self) -> Option<i64> {
let secs_part = try_opt!(self.num_seconds().checked_mul(NANOS_PER_SEC as i64));
let nanos_part = self.nanos_mod_sec();
secs_part.checked_add(nanos_part as i64)
}

/// Add two durations, returning `None` if overflow occured.
#[unstable(feature = "std_misc")]
pub fn checked_add(&self, rhs: &Duration) -> Option<Duration> {
let mut secs = try_opt!(self.secs.checked_add(rhs.secs));
let mut nanos = self.nanos + rhs.nanos;
Expand All @@ -227,6 +248,7 @@ impl Duration {
}

/// Subtract two durations, returning `None` if overflow occured.
#[unstable(feature = "std_misc")]
pub fn checked_sub(&self, rhs: &Duration) -> Option<Duration> {
let mut secs = try_opt!(self.secs.checked_sub(rhs.secs));
let mut nanos = self.nanos - rhs.nanos;
Expand All @@ -242,25 +264,30 @@ impl Duration {

/// The minimum possible `Duration`: `i64::MIN` milliseconds.
#[inline]
#[unstable(feature = "std_misc")]
pub fn min_value() -> Duration { MIN }

/// The maximum possible `Duration`: `i64::MAX` milliseconds.
#[inline]
#[unstable(feature = "std_misc")]
pub fn max_value() -> Duration { MAX }

/// A duration where the stored seconds and nanoseconds are equal to zero.
#[inline]
#[unstable(feature = "std_misc")]
pub fn zero() -> Duration {
Duration { secs: 0, nanos: 0 }
}

/// Returns `true` if the duration equals `Duration::zero()`.
#[inline]
#[unstable(feature = "std_misc")]
pub fn is_zero(&self) -> bool {
self.secs == 0 && self.nanos == 0
}
}

#[unstable(feature = "std_misc")]
impl Neg for Duration {
type Output = Duration;

Expand All @@ -274,6 +301,7 @@ impl Neg for Duration {
}
}

#[unstable(feature = "std_misc")]
impl Add for Duration {
type Output = Duration;

Expand All @@ -288,6 +316,7 @@ impl Add for Duration {
}
}

#[unstable(feature = "std_misc")]
impl Sub for Duration {
type Output = Duration;

Expand All @@ -302,6 +331,7 @@ impl Sub for Duration {
}
}

#[unstable(feature = "std_misc")]
impl Mul<i32> for Duration {
type Output = Duration;

Expand All @@ -314,6 +344,7 @@ impl Mul<i32> for Duration {
}
}

#[unstable(feature = "std_misc")]
impl Div<i32> for Duration {
type Output = Duration;

Expand Down
2 changes: 2 additions & 0 deletions src/libstd/time/mod.rs
Expand Up @@ -10,6 +10,8 @@

//! Temporal quantification.

#![unstable(feature = "std_misc")]

use sys::time::SteadyTime;

pub use self::duration::Duration;
Expand Down

0 comments on commit 9836742

Please sign in to comment.