1
Fork 0

Auto merge of #34357 - tbu-:pr_exact_size_is_empty, r=brson

Add `is_empty` function to `ExactSizeIterator`

All other types implementing a `len` functions have `is_empty` already.
This commit is contained in:
bors 2016-07-18 14:26:22 -07:00 committed by GitHub
commit bbfcb471db
2 changed files with 32 additions and 5 deletions

View file

@ -491,8 +491,6 @@ impl<'a, I: DoubleEndedIterator + ?Sized> DoubleEndedIterator for &'a mut I {
/// ``` /// ```
#[stable(feature = "rust1", since = "1.0.0")] #[stable(feature = "rust1", since = "1.0.0")]
pub trait ExactSizeIterator: Iterator { pub trait ExactSizeIterator: Iterator {
#[inline]
#[stable(feature = "rust1", since = "1.0.0")]
/// Returns the exact number of times the iterator will iterate. /// Returns the exact number of times the iterator will iterate.
/// ///
/// This method has a default implementation, so you usually should not /// This method has a default implementation, so you usually should not
@ -516,6 +514,8 @@ pub trait ExactSizeIterator: Iterator {
/// ///
/// assert_eq!(5, five.len()); /// assert_eq!(5, five.len());
/// ``` /// ```
#[inline]
#[stable(feature = "rust1", since = "1.0.0")]
fn len(&self) -> usize { fn len(&self) -> usize {
let (lower, upper) = self.size_hint(); let (lower, upper) = self.size_hint();
// Note: This assertion is overly defensive, but it checks the invariant // Note: This assertion is overly defensive, but it checks the invariant
@ -525,6 +525,32 @@ pub trait ExactSizeIterator: Iterator {
assert_eq!(upper, Some(lower)); assert_eq!(upper, Some(lower));
lower lower
} }
/// Returns whether the iterator is empty.
///
/// This method has a default implementation using `self.len()`, so you
/// don't need to implement it yourself.
///
/// # Examples
///
/// Basic usage:
///
/// ```
/// #![feature(exact_size_is_empty)]
///
/// let mut one_element = 0..1;
/// assert!(!one_element.is_empty());
///
/// assert_eq!(one_element.next(), Some(0));
/// assert!(one_element.is_empty());
///
/// assert_eq!(one_element.next(), None);
/// ```
#[inline]
#[unstable(feature = "exact_size_is_empty", issue = "0")]
fn is_empty(&self) -> bool {
self.len() == 0
}
} }
#[stable(feature = "rust1", since = "1.0.0")] #[stable(feature = "rust1", since = "1.0.0")]

View file

@ -18,7 +18,8 @@ fn foo<F>(f: F) where F: FnMut(Foo) {}
fn main() { fn main() {
foo(|s| s.is_empty()); foo(|s| s.is_empty());
//~^ ERROR no method named `is_empty` found //~^ ERROR no method named `is_empty` found
//~^^ HELP #1: `core::slice::SliceExt` //~^^ HELP #1: `std::iter::ExactSizeIterator`
//~^^^ HELP #2: `core::str::StrExt` //~^^^ HELP #2: `core::slice::SliceExt`
//~^^^^ HELP items from traits can only be used if the trait is implemented and in scope; the following traits define an item `is_empty`, perhaps you need to implement one of them: //~^^^^ HELP #3: `core::str::StrExt`
//~^^^^^ HELP items from traits can only be used if the trait is implemented and in scope; the following traits define an item `is_empty`, perhaps you need to implement one of them:
} }