bjoernager/rust
bjoernager/rust
1
Fork 0
Code Activity

Improve the documentation for Vec::drain

Browse source
This commit is contained in:
Alexis Bourget 2020-07-22 21:50:16 +02:00
parent 8ad7bc3f42
commit e601e2ac48
1 changed files with 7 additions and 4 deletions
Download patch file Download diff file Expand all files Collapse all files

11
src/liballoc/vec.rs
View file

@ -1274,11 +1274,12 @@ impl<T> Vec<T> {
/// Creates a draining iterator that removes the specified range in the vector
/// and yields the removed items.
///
/// Note 1: The element range is removed even if the iterator is only
/// partially consumed or not consumed at all.
/// The element range is removed even if the iterator is only partially
/// consumed or not consumed at all.
///
/// Note 2: It is unspecified how many elements are removed from the vector
/// if the `Drain` value is leaked.
/// Note: Be aware that if the iterator is leaked (eg: [`mem::forget`]), it
/// cancels this property so it is unspecified how many elements are removed
/// from the vector in this case.
///
/// # Panics
///
@ -1297,6 +1298,8 @@ impl<T> Vec<T> {
/// v.drain(..);
/// assert_eq!(v, &[]);
/// ```
///
/// [`mem::forget`]: mem::forget
#[stable(feature = "drain", since = "1.6.0")]
pub fn drain<R>(&mut self, range: R) -> Drain<'_, T>
where