mikros/rust
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Document split{_ascii,}_whitespace() for empty strings

Browse Source
This commit is contained in:
Vojtech Kral 2022-11-23 15:36:51 +01:00
parent 4e0d0d757e
commit 07ccf67f59
1 changed files with 12 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

12
library/core/src/str/mod.rs
View File

@ -902,6 +902,12 @@ impl str {
/// ///
/// assert_eq!(None, iter.next()); /// assert_eq!(None, iter.next());
/// ``` /// ```
///
/// If the string is empty or all whitespace, the iterator yields no string slices:
/// ```
/// assert_eq!("".split_whitespace().next(), None);
/// assert_eq!(" ".split_whitespace().next(), None);
/// ```
#[must_use = "this returns the split string as an iterator, \ #[must_use = "this returns the split string as an iterator, \
without modifying the original"] without modifying the original"]
#[stable(feature = "split_whitespace", since = "1.1.0")] #[stable(feature = "split_whitespace", since = "1.1.0")]
@ -946,6 +952,12 @@ impl str {
/// ///
/// assert_eq!(None, iter.next()); /// assert_eq!(None, iter.next());
/// ``` /// ```
///
/// If the string is empty or all ASCII whitespace, the iterator yields no string slices:
/// ```
/// assert_eq!("".split_ascii_whitespace().next(), None);
/// assert_eq!(" ".split_ascii_whitespace().next(), None);
/// ```
#[must_use = "this returns the split string as an iterator, \ #[must_use = "this returns the split string as an iterator, \
without modifying the original"] without modifying the original"]
#[stable(feature = "split_ascii_whitespace", since = "1.34.0")] #[stable(feature = "split_ascii_whitespace", since = "1.34.0")]