Document collection From
and FromIterator
impls that drop duplicate keys.
This behavior is worth documenting because there are other plausible alternatives, such as panicking when a duplicate is encountered, and it reminds the programmer to consider whether they should, for example, coalesce duplicate keys first.
This commit is contained in:
parent
13170cd787
commit
b5e8a5d393
4 changed files with 25 additions and 1 deletions
|
@ -1446,6 +1446,11 @@ impl<K, V, const N: usize> From<[(K, V); N]> for HashMap<K, V, RandomState>
|
|||
where
|
||||
K: Eq + Hash,
|
||||
{
|
||||
/// Converts a `[(K, V); N]` into a `HashMap<K, V>`.
|
||||
///
|
||||
/// If any entries in the array have equal keys, all but the last entry for each such key
|
||||
/// are discarded.
|
||||
///
|
||||
/// # Examples
|
||||
///
|
||||
/// ```
|
||||
|
@ -3219,6 +3224,10 @@ where
|
|||
K: Eq + Hash,
|
||||
S: BuildHasher + Default,
|
||||
{
|
||||
/// Constructs a `HashMap<K, V>` from an iterator of key-value pairs.
|
||||
///
|
||||
/// If the iterator produces any pairs with equal keys,
|
||||
/// all but the last value for each such key are discarded.
|
||||
fn from_iter<T: IntoIterator<Item = (K, V)>>(iter: T) -> HashMap<K, V, S> {
|
||||
let mut map = HashMap::with_hasher(Default::default());
|
||||
map.extend(iter);
|
||||
|
|
|
@ -1091,6 +1091,10 @@ impl<T, const N: usize> From<[T; N]> for HashSet<T, RandomState>
|
|||
where
|
||||
T: Eq + Hash,
|
||||
{
|
||||
/// Converts a `[T; N]` into a `HashSet<T>`.
|
||||
///
|
||||
/// If the array contains any equal values, all but the last instance of each are discarded.
|
||||
///
|
||||
/// # Examples
|
||||
///
|
||||
/// ```
|
||||
|
|
Loading…
Add table
Add a link
Reference in a new issue