Mirrors/rust
1
0
Fork 0
mirror of https://github.com/rust-lang/rust.git synced 2026-05-15 12:39:31 +03:00
Code Issues Packages Projects Releases Wiki Activity

Improved documentation for HashMap/BTreeMap Entry's .or_insert_with_key method

Browse Source
This commit is contained in:
Chai T. Rex
2020-12-07 21:36:01 -05:00
parent 866ef87d3f
commit f1b930d57c
2 changed files with 12 additions and 6 deletions
Download Patch File Download Diff File Expand all files Collapse all files
library/alloc/src/collections/btree/map/entry.rs
+6 -3
View File
@@ -116,9 +116,12 @@ pub fn or_insert_with<F: FnOnce() -> V>(self, default: F) -> &'a mut V {
}
}
/// Ensures a value is in the entry by inserting, if empty, the result of the default function,
/// which takes the key as its argument, and returns a mutable reference to the value in the
/// entry.
/// Ensures a value is in the entry by inserting, if empty, the result of the default function.
/// This method allows for generating key-derived values for insertion by providing the default
/// function a reference to the key that was moved during the `.entry(key)` method call.<br />
///
/// The reference to the moved key is provided so that cloning or copying the key is
/// unnecessary, unlike with `.or_insert_with(|| ... )`.
///
/// # Examples
///
library/std/src/collections/hash/map.rs
+6 -3
View File
@@ -2222,9 +2222,12 @@ pub fn or_insert_with<F: FnOnce() -> V>(self, default: F) -> &'a mut V {
}
}
/// Ensures a value is in the entry by inserting, if empty, the result of the default function,
/// which takes the key as its argument, and returns a mutable reference to the value in the
/// entry.
/// Ensures a value is in the entry by inserting, if empty, the result of the default function.
/// This method allows for generating key-derived values for insertion by providing the default
/// function a reference to the key that was moved during the `.entry(key)` method call.
///
/// The reference to the moved key is provided so that cloning or copying the key is
/// unnecessary, unlike with `.or_insert_with(|| ... )`.
///
/// # Examples
///