min_max

Returns the smallest and largest item of iter in one pass, or None when it is empty.

Equivalent to calling .min() and .max() separately, but only iterates once, so it also works on an iterator that can only be consumed a single time. Comparisons follow T’s PartialOrd: with f64, a NaN is neither smaller nor larger than anything, exactly as < and > say, so a NaN that is never replaced (for instance the very first item) stays in the result.

Import

use helpers4::iter::min_max;

Cargo feature iter (enabled by default). To compile only this module:

cargo add helpers4 --no-default-features --features iter

or in Cargo.toml:

[dependencies]
helpers4 = { version = "0.0.5", default-features = false, features = ["iter"] }

Signature

pub fn min_max<T: PartialOrd + Copy>(iter: impl IntoIterator<Item = T>) -> Option<(T, T)>

Parameters

Parameter	Type	Description
iter	impl IntoIterator<Item = T>	The items to scan.

Returns

Option<(T, T)> — (min, max), or None when iter is empty.

Examples

use helpers4::iter::min_max;

assert_eq!(min_max(1..=5), Some((1, 5)));
assert_eq!(min_max([3, 1, 4, 1, 5]), Some((1, 5)));
assert_eq!(min_max(Vec::<i32>::new()), None);

Source

src/iter/min_max.rs