edlang/hashbrown/hash_map/enum.EntryRef.html

244 lines
50 KiB
HTML
Raw Normal View History

<!DOCTYPE html><html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1.0"><meta name="generator" content="rustdoc"><meta name="description" content="A view into a single entry in a map, which may either be vacant or occupied, with any borrowed form of the maps key type."><title>EntryRef in hashbrown::hash_map - Rust</title><link rel="preload" as="font" type="font/woff2" crossorigin href="../../static.files/SourceSerif4-Regular-46f98efaafac5295.ttf.woff2"><link rel="preload" as="font" type="font/woff2" crossorigin href="../../static.files/FiraSans-Regular-018c141bf0843ffd.woff2"><link rel="preload" as="font" type="font/woff2" crossorigin href="../../static.files/FiraSans-Medium-8f9a781e4970d388.woff2"><link rel="preload" as="font" type="font/woff2" crossorigin href="../../static.files/SourceCodePro-Regular-562dcc5011b6de7d.ttf.woff2"><link rel="preload" as="font" type="font/woff2" crossorigin href="../../static.files/SourceCodePro-Semibold-d899c5a5c4aeb14a.ttf.woff2"><link rel="stylesheet" href="../../static.files/normalize-76eba96aa4d2e634.css"><link rel="stylesheet" href="../../static.files/rustdoc-5bc39a1768837dd0.css"><meta name="rustdoc-vars" data-root-path="../../" data-static-root-path="../../static.files/" data-current-crate="hashbrown" data-themes="" data-resource-suffix="" data-rustdoc-version="1.77.1 (7cf61ebde 2024-03-27)" data-channel="1.77.1" data-search-js="search-dd67cee4cfa65049.js" data-settings-js="settings-4313503d2e1961c2.js" ><script src="../../static.files/storage-4c98445ec4002617.js"></script><script defer src="sidebar-items.js"></script><script defer src="../../static.files/main-48f368f3872407c8.js"></script><noscript><link rel="stylesheet" href="../../static.files/noscript-04d5337699b92874.css"></noscript><link rel="alternate icon" type="image/png" href="../../static.files/favicon-16x16-8b506e7a72182f1c.png"><link rel="alternate icon" type="image/png" href="../../static.files/favicon-32x32-422f7d1d52889060.png"><link rel="icon" type="image/svg+xml" href="../../static.files/favicon-2c020d218678b618.svg"></head><body class="rustdoc enum"><!--[if lte IE 11]><div class="warning">This old browser is unsupported and will most likely display funky things.</div><![endif]--><nav class="mobile-topbar"><button class="sidebar-menu-toggle" title="show sidebar"></button></nav><nav class="sidebar"><div class="sidebar-crate"><h2><a href="../../hashbrown/index.html">hashbrown</a><span class="version">0.14.3</span></h2></div><h2 class="location"><a href="#">EntryRef</a></h2><div class="sidebar-elems"><section><h3><a href="#variants">Variants</a></h3><ul class="block variant"><li><a href="#variant.Occupied">Occupied</a></li><li><a href="#variant.Vacant">Vacant</a></li></ul><h3><a href="#implementations">Methods</a></h3><ul class="block method"><li><a href="#method.and_modify">and_modify</a></li><li><a href="#method.and_replace_entry_with">and_replace_entry_with</a></li><li><a href="#method.insert">insert</a></li><li><a href="#method.key">key</a></li><li><a href="#method.or_default">or_default</a></li><li><a href="#method.or_insert">or_insert</a></li><li><a href="#method.or_insert_with">or_insert_with</a></li><li><a href="#method.or_insert_with_key">or_insert_with_key</a></li></ul><h3><a href="#trait-implementations">Trait Implementations</a></h3><ul class="block trait-implementation"><li><a href="#impl-Debug-for-EntryRef%3C'_,+'_,+K,+Q,+V,+S,+A%3E">Debug</a></li></ul><h3><a href="#synthetic-implementations">Auto Trait Implementations</a></h3><ul class="block synthetic-implementation"><li><a href="#impl-UnwindSafe-for-EntryRef%3C'a,+'b,+K,+Q,+V,+S,+A%3E">!UnwindSafe</a></li><li><a href="#impl-RefUnwindSafe-for-EntryRef%3C'a,+'b,+K,+Q,+V,+S,+A%3E">RefUnwindSafe</a></li><li><a href="#impl-Send-for-EntryRef%3C'a,+'b,+K,+Q,+V,+S,+A%3E">Send</a></li><li><a href="#impl-Sync-for-EntryRef%3C'a,+'b,+K,+Q,+V,+S,+A%3E">Sync</a></li><li><a href="#impl-Unpin-for-EntryRef%3C'a,+'b,+K,+Q,+V,+S,+A%3E">Unpin</a></li></ul><h3><a href="#blanket-implementations">Blanket Impleme
<main><div class="width-limiter"><nav class="sub"><form class="search-form"><span></span><div id="sidebar-button" tabindex="-1"><a href="../../hashbrown/all.html" title="show sidebar"></a></div><input class="search-input" name="search" aria-label="Run search in the documentation" autocomplete="off" spellcheck="false" placeholder="Click or press S to search, ? for more options…" type="search"><div id="help-button" tabindex="-1"><a href="../../help.html" title="help">?</a></div><div id="settings-menu" tabindex="-1"><a href="../../settings.html" title="settings"><img width="22" height="22" alt="Change settings" src="../../static.files/wheel-7b819b6101059cd0.svg"></a></div></form></nav><section id="main-content" class="content"><div class="main-heading"><h1>Enum <a href="../index.html">hashbrown</a>::<wbr><a href="index.html">hash_map</a>::<wbr><a class="enum" href="#">EntryRef</a><button id="copy-path" title="Copy item path to clipboard"><img src="../../static.files/clipboard-7571035ce49a181d.svg" width="19" height="18" alt="Copy item path"></button></h1><span class="out-of-band"><a class="src" href="../../src/hashbrown/map.rs.html#4377-4410">source</a> · <button id="toggle-all-docs" title="collapse all docs">[<span>&#x2212;</span>]</button></span></div><pre class="rust item-decl"><code>pub enum EntryRef&lt;'a, 'b, K, Q: ?<a class="trait" href="https://doc.rust-lang.org/1.77.1/core/marker/trait.Sized.html" title="trait core::marker::Sized">Sized</a>, V, S, A = Global&gt;<div class="where">where
A: Allocator,</div>{
Occupied(<a class="struct" href="struct.OccupiedEntryRef.html" title="struct hashbrown::hash_map::OccupiedEntryRef">OccupiedEntryRef</a>&lt;'a, 'b, K, Q, V, S, A&gt;),
Vacant(<a class="struct" href="struct.VacantEntryRef.html" title="struct hashbrown::hash_map::VacantEntryRef">VacantEntryRef</a>&lt;'a, 'b, K, Q, V, S, A&gt;),
}</code></pre><details class="toggle top-doc" open><summary class="hideme"><span>Expand description</span></summary><div class="docblock"><p>A view into a single entry in a map, which may either be vacant or occupied,
with any borrowed form of the maps key type.</p>
<p>This <code>enum</code> is constructed from the <a href="struct.HashMap.html#method.entry_ref"><code>entry_ref</code></a> method on <a href="struct.HashMap.html"><code>HashMap</code></a>.</p>
<p><a href="https://doc.rust-lang.org/std/hash/trait.Hash.html"><code>Hash</code></a> and <a href="https://doc.rust-lang.org/std/cmp/trait.Eq.html"><code>Eq</code></a> on the borrowed form of the maps key type <em>must</em> match those
for the key type. It also require that key may be constructed from the borrowed
form through the <a href="https://doc.rust-lang.org/std/convert/trait.From.html"><code>From</code></a> trait.</p>
<h2 id="examples"><a class="doc-anchor" href="#examples">§</a>Examples</h2>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>hashbrown::hash_map::{EntryRef, HashMap, OccupiedEntryRef};
<span class="kw">let </span><span class="kw-2">mut </span>map = HashMap::new();
map.extend([(<span class="string">"a"</span>.to_owned(), <span class="number">10</span>), (<span class="string">"b"</span>.into(), <span class="number">20</span>), (<span class="string">"c"</span>.into(), <span class="number">30</span>)]);
<span class="macro">assert_eq!</span>(map.len(), <span class="number">3</span>);
<span class="comment">// Existing key (insert)
</span><span class="kw">let </span>key = String::from(<span class="string">"a"</span>);
<span class="kw">let </span>entry: EntryRef&lt;<span class="kw">_</span>, <span class="kw">_</span>, <span class="kw">_</span>, <span class="kw">_</span>&gt; = map.entry_ref(<span class="kw-2">&amp;</span>key);
<span class="kw">let </span>_raw_o: OccupiedEntryRef&lt;<span class="kw">_</span>, <span class="kw">_</span>, <span class="kw">_</span>, <span class="kw">_</span>&gt; = entry.insert(<span class="number">1</span>);
<span class="macro">assert_eq!</span>(map.len(), <span class="number">3</span>);
<span class="comment">// Nonexistent key (insert)
</span>map.entry_ref(<span class="string">"d"</span>).insert(<span class="number">4</span>);
<span class="comment">// Existing key (or_insert)
</span><span class="kw">let </span>v = map.entry_ref(<span class="string">"b"</span>).or_insert(<span class="number">2</span>);
<span class="macro">assert_eq!</span>(std::mem::replace(v, <span class="number">2</span>), <span class="number">20</span>);
<span class="comment">// Nonexistent key (or_insert)
</span>map.entry_ref(<span class="string">"e"</span>).or_insert(<span class="number">5</span>);
<span class="comment">// Existing key (or_insert_with)
</span><span class="kw">let </span>v = map.entry_ref(<span class="string">"c"</span>).or_insert_with(|| <span class="number">3</span>);
<span class="macro">assert_eq!</span>(std::mem::replace(v, <span class="number">3</span>), <span class="number">30</span>);
<span class="comment">// Nonexistent key (or_insert_with)
</span>map.entry_ref(<span class="string">"f"</span>).or_insert_with(|| <span class="number">6</span>);
<span class="macro">println!</span>(<span class="string">"Our HashMap: {:?}"</span>, map);
<span class="kw">for </span>(key, value) <span class="kw">in </span>[<span class="string">"a"</span>, <span class="string">"b"</span>, <span class="string">"c"</span>, <span class="string">"d"</span>, <span class="string">"e"</span>, <span class="string">"f"</span>].into_iter().zip(<span class="number">1</span>..=<span class="number">6</span>) {
<span class="macro">assert_eq!</span>(map[key], value)
}
<span class="macro">assert_eq!</span>(map.len(), <span class="number">6</span>);</code></pre></div>
</div></details><h2 id="variants" class="variants section-header">Variants<a href="#variants" class="anchor">§</a></h2><div class="variants"><section id="variant.Occupied" class="variant"><a href="#variant.Occupied" class="anchor">§</a><h3 class="code-header">Occupied(<a class="struct" href="struct.OccupiedEntryRef.html" title="struct hashbrown::hash_map::OccupiedEntryRef">OccupiedEntryRef</a>&lt;'a, 'b, K, Q, V, S, A&gt;)</h3></section><div class="docblock"><p>An occupied entry.</p>
<h4 id="examples-1"><a class="doc-anchor" href="#examples-1">§</a>Examples</h4>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>hashbrown::hash_map::{EntryRef, HashMap};
<span class="kw">let </span><span class="kw-2">mut </span>map: HashMap&lt;<span class="kw">_</span>, <span class="kw">_</span>&gt; = [(<span class="string">"a"</span>.to_owned(), <span class="number">100</span>), (<span class="string">"b"</span>.into(), <span class="number">200</span>)].into();
<span class="kw">match </span>map.entry_ref(<span class="string">"a"</span>) {
EntryRef::Vacant(<span class="kw">_</span>) =&gt; <span class="macro">unreachable!</span>(),
EntryRef::Occupied(<span class="kw">_</span>) =&gt; { }
}</code></pre></div>
</div><section id="variant.Vacant" class="variant"><a href="#variant.Vacant" class="anchor">§</a><h3 class="code-header">Vacant(<a class="struct" href="struct.VacantEntryRef.html" title="struct hashbrown::hash_map::VacantEntryRef">VacantEntryRef</a>&lt;'a, 'b, K, Q, V, S, A&gt;)</h3></section><div class="docblock"><p>A vacant entry.</p>
<h4 id="examples-2"><a class="doc-anchor" href="#examples-2">§</a>Examples</h4>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>hashbrown::hash_map::{EntryRef, HashMap};
<span class="kw">let </span><span class="kw-2">mut </span>map: HashMap&lt;String, i32&gt; = HashMap::new();
<span class="kw">match </span>map.entry_ref(<span class="string">"a"</span>) {
EntryRef::Occupied(<span class="kw">_</span>) =&gt; <span class="macro">unreachable!</span>(),
EntryRef::Vacant(<span class="kw">_</span>) =&gt; { }
}</code></pre></div>
</div></div><h2 id="implementations" class="section-header">Implementations<a href="#implementations" class="anchor">§</a></h2><div id="implementations-list"><details class="toggle implementors-toggle" open><summary><section id="impl-EntryRef%3C'a,+'b,+K,+Q,+V,+S,+A%3E" class="impl"><a class="src rightside" href="../../src/hashbrown/map.rs.html#5709-5954">source</a><a href="#impl-EntryRef%3C'a,+'b,+K,+Q,+V,+S,+A%3E" class="anchor">§</a><h3 class="code-header">impl&lt;'a, 'b, K, Q: ?<a class="trait" href="https://doc.rust-lang.org/1.77.1/core/marker/trait.Sized.html" title="trait core::marker::Sized">Sized</a>, V, S, A: Allocator&gt; <a class="enum" href="enum.EntryRef.html" title="enum hashbrown::hash_map::EntryRef">EntryRef</a>&lt;'a, 'b, K, Q, V, S, A&gt;</h3></section></summary><div class="impl-items"><details class="toggle method-toggle" open><summary><section id="method.insert" class="method"><a class="src rightside" href="../../src/hashbrown/map.rs.html#5723-5735">source</a><h4 class="code-header">pub fn <a href="#method.insert" class="fn">insert</a>(self, value: V) -&gt; <a class="struct" href="struct.OccupiedEntryRef.html" title="struct hashbrown::hash_map::OccupiedEntryRef">OccupiedEntryRef</a>&lt;'a, 'b, K, Q, V, S, A&gt;<div class="where">where
K: <a class="trait" href="https://doc.rust-lang.org/1.77.1/core/hash/trait.Hash.html" title="trait core::hash::Hash">Hash</a> + <a class="trait" href="https://doc.rust-lang.org/1.77.1/core/convert/trait.From.html" title="trait core::convert::From">From</a>&lt;<a class="primitive" href="https://doc.rust-lang.org/1.77.1/core/primitive.reference.html">&amp;'b Q</a>&gt;,
S: <a class="trait" href="https://doc.rust-lang.org/1.77.1/core/hash/trait.BuildHasher.html" title="trait core::hash::BuildHasher">BuildHasher</a>,</div></h4></section></summary><div class="docblock"><p>Sets the value of the entry, and returns an OccupiedEntryRef.</p>
<h5 id="examples-3"><a class="doc-anchor" href="#examples-3">§</a>Examples</h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>hashbrown::HashMap;
<span class="kw">let </span><span class="kw-2">mut </span>map: HashMap&lt;String, u32&gt; = HashMap::new();
<span class="kw">let </span>entry = map.entry_ref(<span class="string">"horseyland"</span>).insert(<span class="number">37</span>);
<span class="macro">assert_eq!</span>(entry.key(), <span class="string">"horseyland"</span>);</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.or_insert" class="method"><a class="src rightside" href="../../src/hashbrown/map.rs.html#5756-5765">source</a><h4 class="code-header">pub fn <a href="#method.or_insert" class="fn">or_insert</a>(self, default: V) -&gt; <a class="primitive" href="https://doc.rust-lang.org/1.77.1/core/primitive.reference.html">&amp;'a mut V</a><div class="where">where
K: <a class="trait" href="https://doc.rust-lang.org/1.77.1/core/hash/trait.Hash.html" title="trait core::hash::Hash">Hash</a> + <a class="trait" href="https://doc.rust-lang.org/1.77.1/core/convert/trait.From.html" title="trait core::convert::From">From</a>&lt;<a class="primitive" href="https://doc.rust-lang.org/1.77.1/core/primitive.reference.html">&amp;'b Q</a>&gt;,
S: <a class="trait" href="https://doc.rust-lang.org/1.77.1/core/hash/trait.BuildHasher.html" title="trait core::hash::BuildHasher">BuildHasher</a>,</div></h4></section></summary><div class="docblock"><p>Ensures a value is in the entry by inserting the default if empty, and returns
a mutable reference to the value in the entry.</p>
<h5 id="examples-4"><a class="doc-anchor" href="#examples-4">§</a>Examples</h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>hashbrown::HashMap;
<span class="kw">let </span><span class="kw-2">mut </span>map: HashMap&lt;String, u32&gt; = HashMap::new();
<span class="comment">// nonexistent key
</span>map.entry_ref(<span class="string">"poneyland"</span>).or_insert(<span class="number">3</span>);
<span class="macro">assert_eq!</span>(map[<span class="string">"poneyland"</span>], <span class="number">3</span>);
<span class="comment">// existing key
</span><span class="kw-2">*</span>map.entry_ref(<span class="string">"poneyland"</span>).or_insert(<span class="number">10</span>) <span class="kw-2">*</span>= <span class="number">2</span>;
<span class="macro">assert_eq!</span>(map[<span class="string">"poneyland"</span>], <span class="number">6</span>);</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.or_insert_with" class="method"><a class="src rightside" href="../../src/hashbrown/map.rs.html#5786-5795">source</a><h4 class="code-header">pub fn <a href="#method.or_insert_with" class="fn">or_insert_with</a>&lt;F: <a class="trait" href="https://doc.rust-lang.org/1.77.1/core/ops/function/trait.FnOnce.html" title="trait core::ops::function::FnOnce">FnOnce</a>() -&gt; V&gt;(self, default: F) -&gt; <a class="primitive" href="https://doc.rust-lang.org/1.77.1/core/primitive.reference.html">&amp;'a mut V</a><div class="where">where
K: <a class="trait" href="https://doc.rust-lang.org/1.77.1/core/hash/trait.Hash.html" title="trait core::hash::Hash">Hash</a> + <a class="trait" href="https://doc.rust-lang.org/1.77.1/core/convert/trait.From.html" title="trait core::convert::From">From</a>&lt;<a class="primitive" href="https://doc.rust-lang.org/1.77.1/core/primitive.reference.html">&amp;'b Q</a>&gt;,
S: <a class="trait" href="https://doc.rust-lang.org/1.77.1/core/hash/trait.BuildHasher.html" title="trait core::hash::BuildHasher">BuildHasher</a>,</div></h4></section></summary><div class="docblock"><p>Ensures a value is in the entry by inserting the result of the default function if empty,
and returns a mutable reference to the value in the entry.</p>
<h5 id="examples-5"><a class="doc-anchor" href="#examples-5">§</a>Examples</h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>hashbrown::HashMap;
<span class="kw">let </span><span class="kw-2">mut </span>map: HashMap&lt;String, u32&gt; = HashMap::new();
<span class="comment">// nonexistent key
</span>map.entry_ref(<span class="string">"poneyland"</span>).or_insert_with(|| <span class="number">3</span>);
<span class="macro">assert_eq!</span>(map[<span class="string">"poneyland"</span>], <span class="number">3</span>);
<span class="comment">// existing key
</span><span class="kw-2">*</span>map.entry_ref(<span class="string">"poneyland"</span>).or_insert_with(|| <span class="number">10</span>) <span class="kw-2">*</span>= <span class="number">2</span>;
<span class="macro">assert_eq!</span>(map[<span class="string">"poneyland"</span>], <span class="number">6</span>);</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.or_insert_with_key" class="method"><a class="src rightside" href="../../src/hashbrown/map.rs.html#5817-5829">source</a><h4 class="code-header">pub fn <a href="#method.or_insert_with_key" class="fn">or_insert_with_key</a>&lt;F: <a class="trait" href="https://doc.rust-lang.org/1.77.1/core/ops/function/trait.FnOnce.html" title="trait core::ops::function::FnOnce">FnOnce</a>(<a class="primitive" href="https://doc.rust-lang.org/1.77.1/core/primitive.reference.html">&amp;Q</a>) -&gt; V&gt;(self, default: F) -&gt; <a class="primitive" href="https://doc.rust-lang.org/1.77.1/core/primitive.reference.html">&amp;'a mut V</a><div class="where">where
K: <a class="trait" href="https://doc.rust-lang.org/1.77.1/core/hash/trait.Hash.html" title="trait core::hash::Hash">Hash</a> + <a class="trait" href="https://doc.rust-lang.org/1.77.1/core/borrow/trait.Borrow.html" title="trait core::borrow::Borrow">Borrow</a>&lt;Q&gt; + <a class="trait" href="https://doc.rust-lang.org/1.77.1/core/convert/trait.From.html" title="trait core::convert::From">From</a>&lt;<a class="primitive" href="https://doc.rust-lang.org/1.77.1/core/primitive.reference.html">&amp;'b Q</a>&gt;,
S: <a class="trait" href="https://doc.rust-lang.org/1.77.1/core/hash/trait.BuildHasher.html" title="trait core::hash::BuildHasher">BuildHasher</a>,</div></h4></section></summary><div class="docblock"><p>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 an access to the borrower form of the key.</p>
<h5 id="examples-6"><a class="doc-anchor" href="#examples-6">§</a>Examples</h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>hashbrown::HashMap;
<span class="kw">let </span><span class="kw-2">mut </span>map: HashMap&lt;String, usize&gt; = HashMap::new();
<span class="comment">// nonexistent key
</span>map.entry_ref(<span class="string">"poneyland"</span>).or_insert_with_key(|key| key.chars().count());
<span class="macro">assert_eq!</span>(map[<span class="string">"poneyland"</span>], <span class="number">9</span>);
<span class="comment">// existing key
</span><span class="kw-2">*</span>map.entry_ref(<span class="string">"poneyland"</span>).or_insert_with_key(|key| key.chars().count() * <span class="number">10</span>) <span class="kw-2">*</span>= <span class="number">2</span>;
<span class="macro">assert_eq!</span>(map[<span class="string">"poneyland"</span>], <span class="number">18</span>);</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.key" class="method"><a class="src rightside" href="../../src/hashbrown/map.rs.html#5846-5854">source</a><h4 class="code-header">pub fn <a href="#method.key" class="fn">key</a>(&amp;self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/1.77.1/core/primitive.reference.html">&amp;Q</a><div class="where">where
K: <a class="trait" href="https://doc.rust-lang.org/1.77.1/core/borrow/trait.Borrow.html" title="trait core::borrow::Borrow">Borrow</a>&lt;Q&gt;,</div></h4></section></summary><div class="docblock"><p>Returns a reference to this entrys key.</p>
<h5 id="examples-7"><a class="doc-anchor" href="#examples-7">§</a>Examples</h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>hashbrown::HashMap;
<span class="kw">let </span><span class="kw-2">mut </span>map: HashMap&lt;String, u32&gt; = HashMap::new();
map.entry_ref(<span class="string">"poneyland"</span>).or_insert(<span class="number">3</span>);
<span class="comment">// existing key
</span><span class="macro">assert_eq!</span>(map.entry_ref(<span class="string">"poneyland"</span>).key(), <span class="string">"poneyland"</span>);
<span class="comment">// nonexistent key
</span><span class="macro">assert_eq!</span>(map.entry_ref(<span class="string">"horseland"</span>).key(), <span class="string">"horseland"</span>);</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.and_modify" class="method"><a class="src rightside" href="../../src/hashbrown/map.rs.html#5877-5888">source</a><h4 class="code-header">pub fn <a href="#method.and_modify" class="fn">and_modify</a>&lt;F&gt;(self, f: F) -&gt; Self<div class="where">where
F: <a class="trait" href="https://doc.rust-lang.org/1.77.1/core/ops/function/trait.FnOnce.html" title="trait core::ops::function::FnOnce">FnOnce</a>(<a class="primitive" href="https://doc.rust-lang.org/1.77.1/core/primitive.reference.html">&amp;mut V</a>),</div></h4></section></summary><div class="docblock"><p>Provides in-place mutable access to an occupied entry before any
potential inserts into the map.</p>
<h5 id="examples-8"><a class="doc-anchor" href="#examples-8">§</a>Examples</h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>hashbrown::HashMap;
<span class="kw">let </span><span class="kw-2">mut </span>map: HashMap&lt;String, u32&gt; = HashMap::new();
map.entry_ref(<span class="string">"poneyland"</span>)
.and_modify(|e| { <span class="kw-2">*</span>e += <span class="number">1 </span>})
.or_insert(<span class="number">42</span>);
<span class="macro">assert_eq!</span>(map[<span class="string">"poneyland"</span>], <span class="number">42</span>);
map.entry_ref(<span class="string">"poneyland"</span>)
.and_modify(|e| { <span class="kw-2">*</span>e += <span class="number">1 </span>})
.or_insert(<span class="number">42</span>);
<span class="macro">assert_eq!</span>(map[<span class="string">"poneyland"</span>], <span class="number">43</span>);</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.and_replace_entry_with" class="method"><a class="src rightside" href="../../src/hashbrown/map.rs.html#5945-5953">source</a><h4 class="code-header">pub fn <a href="#method.and_replace_entry_with" class="fn">and_replace_entry_with</a>&lt;F&gt;(self, f: F) -&gt; Self<div class="where">where
F: <a class="trait" href="https://doc.rust-lang.org/1.77.1/core/ops/function/trait.FnOnce.html" title="trait core::ops::function::FnOnce">FnOnce</a>(<a class="primitive" href="https://doc.rust-lang.org/1.77.1/core/primitive.reference.html">&amp;K</a>, V) -&gt; <a class="enum" href="https://doc.rust-lang.org/1.77.1/core/option/enum.Option.html" title="enum core::option::Option">Option</a>&lt;V&gt;,</div></h4></section></summary><div class="docblock"><p>Provides shared access to the key and owned access to the value of
an occupied entry and allows to replace or remove it based on the
value of the returned option.</p>
<h5 id="examples-9"><a class="doc-anchor" href="#examples-9">§</a>Examples</h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>hashbrown::HashMap;
<span class="kw">use </span>hashbrown::hash_map::EntryRef;
<span class="kw">let </span><span class="kw-2">mut </span>map: HashMap&lt;String, u32&gt; = HashMap::new();
<span class="kw">let </span>entry = map
.entry_ref(<span class="string">"poneyland"</span>)
.and_replace_entry_with(|_k, _v| <span class="macro">panic!</span>());
<span class="kw">match </span>entry {
EntryRef::Vacant(e) =&gt; {
<span class="macro">assert_eq!</span>(e.key(), <span class="string">"poneyland"</span>);
}
EntryRef::Occupied(<span class="kw">_</span>) =&gt; <span class="macro">panic!</span>(),
}
map.insert(<span class="string">"poneyland"</span>.to_string(), <span class="number">42</span>);
<span class="kw">let </span>entry = map
.entry_ref(<span class="string">"poneyland"</span>)
.and_replace_entry_with(|k, v| {
<span class="macro">assert_eq!</span>(k, <span class="string">"poneyland"</span>);
<span class="macro">assert_eq!</span>(v, <span class="number">42</span>);
<span class="prelude-val">Some</span>(v + <span class="number">1</span>)
});
<span class="kw">match </span>entry {
EntryRef::Occupied(e) =&gt; {
<span class="macro">assert_eq!</span>(e.key(), <span class="string">"poneyland"</span>);
<span class="macro">assert_eq!</span>(e.get(), <span class="kw-2">&amp;</span><span class="number">43</span>);
}
EntryRef::Vacant(<span class="kw">_</span>) =&gt; <span class="macro">panic!</span>(),
}
<span class="macro">assert_eq!</span>(map[<span class="string">"poneyland"</span>], <span class="number">43</span>);
<span class="kw">let </span>entry = map
.entry_ref(<span class="string">"poneyland"</span>)
.and_replace_entry_with(|_k, _v| <span class="prelude-val">None</span>);
<span class="kw">match </span>entry {
EntryRef::Vacant(e) =&gt; <span class="macro">assert_eq!</span>(e.key(), <span class="string">"poneyland"</span>),
EntryRef::Occupied(<span class="kw">_</span>) =&gt; <span class="macro">panic!</span>(),
}
<span class="macro">assert!</span>(!map.contains_key(<span class="string">"poneyland"</span>));</code></pre></div>
</div></details></div></details><details class="toggle implementors-toggle" open><summary><section id="impl-EntryRef%3C'a,+'b,+K,+Q,+V,+S,+A%3E-1" class="impl"><a class="src rightside" href="../../src/hashbrown/map.rs.html#5956-5987">source</a><a href="#impl-EntryRef%3C'a,+'b,+K,+Q,+V,+S,+A%3E-1" class="anchor">§</a><h3 class="code-header">impl&lt;'a, 'b, K, Q: ?<a class="trait" href="https://doc.rust-lang.org/1.77.1/core/marker/trait.Sized.html" title="trait core::marker::Sized">Sized</a>, V: <a class="trait" href="https://doc.rust-lang.org/1.77.1/core/default/trait.Default.html" title="trait core::default::Default">Default</a>, S, A: Allocator&gt; <a class="enum" href="enum.EntryRef.html" title="enum hashbrown::hash_map::EntryRef">EntryRef</a>&lt;'a, 'b, K, Q, V, S, A&gt;</h3></section></summary><div class="impl-items"><details class="toggle method-toggle" open><summary><section id="method.or_default" class="method"><a class="src rightside" href="../../src/hashbrown/map.rs.html#5977-5986">source</a><h4 class="code-header">pub fn <a href="#method.or_default" class="fn">or_default</a>(self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/1.77.1/core/primitive.reference.html">&amp;'a mut V</a><div class="where">where
K: <a class="trait" href="https://doc.rust-lang.org/1.77.1/core/hash/trait.Hash.html" title="trait core::hash::Hash">Hash</a> + <a class="trait" href="https://doc.rust-lang.org/1.77.1/core/convert/trait.From.html" title="trait core::convert::From">From</a>&lt;<a class="primitive" href="https://doc.rust-lang.org/1.77.1/core/primitive.reference.html">&amp;'b Q</a>&gt;,
S: <a class="trait" href="https://doc.rust-lang.org/1.77.1/core/hash/trait.BuildHasher.html" title="trait core::hash::BuildHasher">BuildHasher</a>,</div></h4></section></summary><div class="docblock"><p>Ensures a value is in the entry by inserting the default value if empty,
and returns a mutable reference to the value in the entry.</p>
<h5 id="examples-10"><a class="doc-anchor" href="#examples-10">§</a>Examples</h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>hashbrown::HashMap;
<span class="kw">let </span><span class="kw-2">mut </span>map: HashMap&lt;String, <span class="prelude-ty">Option</span>&lt;u32&gt;&gt; = HashMap::new();
<span class="comment">// nonexistent key
</span>map.entry_ref(<span class="string">"poneyland"</span>).or_default();
<span class="macro">assert_eq!</span>(map[<span class="string">"poneyland"</span>], <span class="prelude-val">None</span>);
map.insert(<span class="string">"horseland"</span>.to_string(), <span class="prelude-val">Some</span>(<span class="number">3</span>));
<span class="comment">// existing key
</span><span class="macro">assert_eq!</span>(map.entry_ref(<span class="string">"horseland"</span>).or_default(), <span class="kw-2">&amp;mut </span><span class="prelude-val">Some</span>(<span class="number">3</span>));</code></pre></div>
</div></details></div></details></div><h2 id="trait-implementations" class="section-header">Trait Implementations<a href="#trait-implementations" class="anchor">§</a></h2><div id="trait-implementations-list"><details class="toggle implementors-toggle" open><summary><section id="impl-Debug-for-EntryRef%3C'_,+'_,+K,+Q,+V,+S,+A%3E" class="impl"><a class="src rightside" href="../../src/hashbrown/map.rs.html#4412-4421">source</a><a href="#impl-Debug-for-EntryRef%3C'_,+'_,+K,+Q,+V,+S,+A%3E" class="anchor">§</a><h3 class="code-header">impl&lt;K: <a class="trait" href="https://doc.rust-lang.org/1.77.1/core/borrow/trait.Borrow.html" title="trait core::borrow::Borrow">Borrow</a>&lt;Q&gt;, Q: ?<a class="trait" href="https://doc.rust-lang.org/1.77.1/core/marker/trait.Sized.html" title="trait core::marker::Sized">Sized</a> + <a class="trait" href="https://doc.rust-lang.org/1.77.1/core/fmt/trait.Debug.html" title="trait core::fmt::Debug">Debug</a>, V: <a class="trait" href="https://doc.rust-lang.org/1.77.1/core/fmt/trait.Debug.html" title="trait core::fmt::Debug">Debug</a>, S, A: Allocator&gt; <a class="trait" href="https://doc.rust-lang.org/1.77.1/core/fmt/trait.Debug.html" title="trait core::fmt::Debug">Debug</a> for <a class="enum" href="enum.EntryRef.html" title="enum hashbrown::hash_map::EntryRef">EntryRef</a>&lt;'_, '_, K, Q, V, S, A&gt;</h3></section></summary><div class="impl-items"><details class="toggle method-toggle" open><summary><section id="method.fmt" class="method trait-impl"><a class="src rightside" href="../../src/hashbrown/map.rs.html#4415-4420">source</a><a href="#method.fmt" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.77.1/core/fmt/trait.Debug.html#tymethod.fmt" class="fn">fmt</a>(&amp;self, f: &amp;mut <a class="struct" href="https://doc.rust-lang.org/1.77.1/core/fmt/struct.Formatter.html" title="struct core::fmt::Formatter">Formatter</a>&lt;'_&gt;) -&gt; <a class="type" href="https://doc.rust-lang.org/1.77.1/core/fmt/type.Result.html" title="type core::fmt::Result">Result</a></h4></section></summary><div class='docblock'>Formats the value using the given formatter. <a href="https://doc.rust-lang.org/1.77.1/core/fmt/trait.Debug.html#tymethod.fmt">Read more</a></div></details></div></details></div><h2 id="synthetic-implementations" class="section-header">Auto Trait Implementations<a href="#synthetic-implementations" class="anchor">§</a></h2><div id="synthetic-implementations-list"><section id="impl-RefUnwindSafe-for-EntryRef%3C'a,+'b,+K,+Q,+V,+S,+A%3E" class="impl"><a href="#impl-RefUnwindSafe-for-EntryRef%3C'a,+'b,+K,+Q,+V,+S,+A%3E" class="anchor">§</a><h3 class="code-header">impl&lt;'a, 'b, K, Q: ?<a class="trait" href="https://doc.rust-lang.org/1.77.1/core/marker/trait.Sized.html" title="trait core::marker::Sized">Sized</a>, V, S, A&gt; <a class="trait" href="https://doc.rust-lang.org/1.77.1/core/panic/unwind_safe/trait.RefUnwindSafe.html" title="trait core::panic::unwind_safe::RefUnwindSafe">RefUnwindSafe</a> for <a class="enum" href="enum.EntryRef.html" title="enum hashbrown::hash_map::EntryRef">EntryRef</a>&lt;'a, 'b, K, Q, V, S, A&gt;<div class="where">where
A: <a class="trait" href="https://doc.rust-lang.org/1.77.1/core/panic/unwind_safe/trait.RefUnwindSafe.html" title="trait core::panic::unwind_safe::RefUnwindSafe">RefUnwindSafe</a>,
K: <a class="trait" href="https://doc.rust-lang.org/1.77.1/core/panic/unwind_safe/trait.RefUnwindSafe.html" title="trait core::panic::unwind_safe::RefUnwindSafe">RefUnwindSafe</a>,
Q: <a class="trait" href="https://doc.rust-lang.org/1.77.1/core/panic/unwind_safe/trait.RefUnwindSafe.html" title="trait core::panic::unwind_safe::RefUnwindSafe">RefUnwindSafe</a>,
S: <a class="trait" href="https://doc.rust-lang.org/1.77.1/core/panic/unwind_safe/trait.RefUnwindSafe.html" title="trait core::panic::unwind_safe::RefUnwindSafe">RefUnwindSafe</a>,
V: <a class="trait" href="https://doc.rust-lang.org/1.77.1/core/panic/unwind_safe/trait.RefUnwindSafe.html" title="trait core::panic::unwind_safe::RefUnwindSafe">RefUnwindSafe</a>,</div></h3></section><section id="impl-Send-for-EntryRef%3C'a,+'b,+K,+Q,+V,+S,+A%3E" class="impl"><a href="#impl-Send-for-EntryRef%3C'a,+'b,+K,+Q,+V,+S,+A%3E" class="anchor">§</a><h3 class="code-header">impl&lt;'a, 'b, K, Q: ?<a class="trait" href="https://doc.rust-lang.org/1.77.1/core/marker/trait.Sized.html" title="trait core::marker::Sized">Sized</a>, V, S, A&gt; <a class="trait" href="https://doc.rust-lang.org/1.77.1/core/marker/trait.Send.html" title="trait core::marker::Send">Send</a> for <a class="enum" href="enum.EntryRef.html" title="enum hashbrown::hash_map::EntryRef">EntryRef</a>&lt;'a, 'b, K, Q, V, S, A&gt;<div class="where">where
A: <a class="trait" href="https://doc.rust-lang.org/1.77.1/core/marker/trait.Send.html" title="trait core::marker::Send">Send</a>,
K: <a class="trait" href="https://doc.rust-lang.org/1.77.1/core/marker/trait.Send.html" title="trait core::marker::Send">Send</a>,
Q: <a class="trait" href="https://doc.rust-lang.org/1.77.1/core/marker/trait.Sync.html" title="trait core::marker::Sync">Sync</a>,
S: <a class="trait" href="https://doc.rust-lang.org/1.77.1/core/marker/trait.Send.html" title="trait core::marker::Send">Send</a>,
V: <a class="trait" href="https://doc.rust-lang.org/1.77.1/core/marker/trait.Send.html" title="trait core::marker::Send">Send</a>,</div></h3></section><section id="impl-Sync-for-EntryRef%3C'a,+'b,+K,+Q,+V,+S,+A%3E" class="impl"><a href="#impl-Sync-for-EntryRef%3C'a,+'b,+K,+Q,+V,+S,+A%3E" class="anchor">§</a><h3 class="code-header">impl&lt;'a, 'b, K, Q: ?<a class="trait" href="https://doc.rust-lang.org/1.77.1/core/marker/trait.Sized.html" title="trait core::marker::Sized">Sized</a>, V, S, A&gt; <a class="trait" href="https://doc.rust-lang.org/1.77.1/core/marker/trait.Sync.html" title="trait core::marker::Sync">Sync</a> for <a class="enum" href="enum.EntryRef.html" title="enum hashbrown::hash_map::EntryRef">EntryRef</a>&lt;'a, 'b, K, Q, V, S, A&gt;<div class="where">where
A: <a class="trait" href="https://doc.rust-lang.org/1.77.1/core/marker/trait.Sync.html" title="trait core::marker::Sync">Sync</a>,
K: <a class="trait" href="https://doc.rust-lang.org/1.77.1/core/marker/trait.Sync.html" title="trait core::marker::Sync">Sync</a>,
Q: <a class="trait" href="https://doc.rust-lang.org/1.77.1/core/marker/trait.Sync.html" title="trait core::marker::Sync">Sync</a>,
S: <a class="trait" href="https://doc.rust-lang.org/1.77.1/core/marker/trait.Sync.html" title="trait core::marker::Sync">Sync</a>,
V: <a class="trait" href="https://doc.rust-lang.org/1.77.1/core/marker/trait.Sync.html" title="trait core::marker::Sync">Sync</a>,</div></h3></section><section id="impl-Unpin-for-EntryRef%3C'a,+'b,+K,+Q,+V,+S,+A%3E" class="impl"><a href="#impl-Unpin-for-EntryRef%3C'a,+'b,+K,+Q,+V,+S,+A%3E" class="anchor">§</a><h3 class="code-header">impl&lt;'a, 'b, K, Q: ?<a class="trait" href="https://doc.rust-lang.org/1.77.1/core/marker/trait.Sized.html" title="trait core::marker::Sized">Sized</a>, V, S, A&gt; <a class="trait" href="https://doc.rust-lang.org/1.77.1/core/marker/trait.Unpin.html" title="trait core::marker::Unpin">Unpin</a> for <a class="enum" href="enum.EntryRef.html" title="enum hashbrown::hash_map::EntryRef">EntryRef</a>&lt;'a, 'b, K, Q, V, S, A&gt;<div class="where">where
K: <a class="trait" href="https://doc.rust-lang.org/1.77.1/core/marker/trait.Unpin.html" title="trait core::marker::Unpin">Unpin</a>,</div></h3></section><section id="impl-UnwindSafe-for-EntryRef%3C'a,+'b,+K,+Q,+V,+S,+A%3E" class="impl"><a href="#impl-UnwindSafe-for-EntryRef%3C'a,+'b,+K,+Q,+V,+S,+A%3E" class="anchor">§</a><h3 class="code-header">impl&lt;'a, 'b, K, Q, V, S, A = Global&gt; !<a class="trait" href="https://doc.rust-lang.org/1.77.1/core/panic/unwind_safe/trait.UnwindSafe.html" title="trait core::panic::unwind_safe::UnwindSafe">UnwindSafe</a> for <a class="enum" href="enum.EntryRef.html" title="enum hashbrown::hash_map::EntryRef">EntryRef</a>&lt;'a, 'b, K, Q, V, S, A&gt;</h3></section></div><h2 id="blanket-implementations" class="section-header">Blanket Implementations<a href="#blanket-implementations" class="anchor">§</a></h2><div id="blanket-implementations-list"><details class="toggle implementors-toggle"><summary><section id="impl-Any-for-T" class="impl"><a class="src rightside" href="https://doc.rust-lang.org/1.77.1/src/core/any.rs.html#140">source</a><a href="#impl-Any-for-T" class="anchor">§</a><h3 class="code-header">impl&lt;T&gt; <a class="trait" href="https://doc.rust-lang.org/1.77.1/core/any/trait.Any.html" title="trait core::any::Any">Any</a> for T<div class="where">where
T: 'static + ?<a class="trait" href="https://doc.rust-lang.org/1.77.1/core/marker/trait.Sized.html" title="trait core::marker::Sized">Sized</a>,</div></h3></section></summary><div class="impl-items"><details class="toggle method-toggle" open><summary><section id="method.type_id" class="method trait-impl"><a class="src rightside" href="https://doc.rust-lang.org/1.77.1/src/core/any.rs.html#141">source</a><a href="#method.type_id" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.77.1/core/any/trait.Any.html#tymethod.type_id" class="fn">type_id</a>(&amp;self) -&gt; <a class="struct" href="https://doc.rust-lang.org/1.77.1/core/any/struct.TypeId.html" title="struct core::any::TypeId">TypeId</a></h4></section></summary><div class='docblock'>Gets the <code>TypeId</code> of <code>self</code>. <a href="https://doc.rust-lang.org/1.77.1/core/any/trait.Any.html#tymethod.type_id">Read more</a></div></details></div></details><details class="toggle implementors-toggle"><summary><section id="impl-Borrow%3CT%3E-for-T" class="impl"><a class="src rightside" href="https://doc.rust-lang.org/1.77.1/src/core/borrow.rs.html#208">source</a><a href="#impl-Borrow%3CT%3E-for-T" class="anchor">§</a><h3 class="code-header">impl&lt;T&gt; <a class="trait" href="https://doc.rust-lang.org/1.77.1/core/borrow/trait.Borrow.html" title="trait core::borrow::Borrow">Borrow</a>&lt;T&gt; for T<div class="where">where
T: ?<a class="trait" href="https://doc.rust-lang.org/1.77.1/core/marker/trait.Sized.html" title="trait core::marker::Sized">Sized</a>,</div></h3></section></summary><div class="impl-items"><details class="toggle method-toggle" open><summary><section id="method.borrow" class="method trait-impl"><a class="src rightside" href="https://doc.rust-lang.org/1.77.1/src/core/borrow.rs.html#210">source</a><a href="#method.borrow" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.77.1/core/borrow/trait.Borrow.html#tymethod.borrow" class="fn">borrow</a>(&amp;self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/1.77.1/core/primitive.reference.html">&amp;T</a></h4></section></summary><div class='docblock'>Immutably borrows from an owned value. <a href="https://doc.rust-lang.org/1.77.1/core/borrow/trait.Borrow.html#tymethod.borrow">Read more</a></div></details></div></details><details class="toggle implementors-toggle"><summary><section id="impl-BorrowMut%3CT%3E-for-T" class="impl"><a class="src rightside" href="https://doc.rust-lang.org/1.77.1/src/core/borrow.rs.html#216">source</a><a href="#impl-BorrowMut%3CT%3E-for-T" class="anchor">§</a><h3 class="code-header">impl&lt;T&gt; <a class="trait" href="https://doc.rust-lang.org/1.77.1/core/borrow/trait.BorrowMut.html" title="trait core::borrow::BorrowMut">BorrowMut</a>&lt;T&gt; for T<div class="where">where
T: ?<a class="trait" href="https://doc.rust-lang.org/1.77.1/core/marker/trait.Sized.html" title="trait core::marker::Sized">Sized</a>,</div></h3></section></summary><div class="impl-items"><details class="toggle method-toggle" open><summary><section id="method.borrow_mut" class="method trait-impl"><a class="src rightside" href="https://doc.rust-lang.org/1.77.1/src/core/borrow.rs.html#217">source</a><a href="#method.borrow_mut" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.77.1/core/borrow/trait.BorrowMut.html#tymethod.borrow_mut" class="fn">borrow_mut</a>(&amp;mut self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/1.77.1/core/primitive.reference.html">&amp;mut T</a></h4></section></summary><div class='docblock'>Mutably borrows from an owned value. <a href="https://doc.rust-lang.org/1.77.1/core/borrow/trait.BorrowMut.html#tymethod.borrow_mut">Read more</a></div></details></div></details><details class="toggle implementors-toggle"><summary><section id="impl-From%3CT%3E-for-T" class="impl"><a class="src rightside" href="https://doc.rust-lang.org/1.77.1/src/core/convert/mod.rs.html#764">source</a><a href="#impl-From%3CT%3E-for-T" class="anchor">§</a><h3 class="code-header">impl&lt;T&gt; <a class="trait" href="https://doc.rust-lang.org/1.77.1/core/convert/trait.From.html" title="trait core::convert::From">From</a>&lt;T&gt; for T</h3></section></summary><div class="impl-items"><details class="toggle method-toggle" open><summary><section id="method.from" class="method trait-impl"><a class="src rightside" href="https://doc.rust-lang.org/1.77.1/src/core/convert/mod.rs.html#767">source</a><a href="#method.from" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.77.1/core/convert/trait.From.html#tymethod.from" class="fn">from</a>(t: T) -&gt; T</h4></section></summary><div class="docblock"><p>Returns the argument unchanged.</p>
</div></details></div></details><details class="toggle implementors-toggle"><summary><section id="impl-Into%3CU%3E-for-T" class="impl"><a class="src rightside" href="https://doc.rust-lang.org/1.77.1/src/core/convert/mod.rs.html#747-749">source</a><a href="#impl-Into%3CU%3E-for-T" class="anchor">§</a><h3 class="code-header">impl&lt;T, U&gt; <a class="trait" href="https://doc.rust-lang.org/1.77.1/core/convert/trait.Into.html" title="trait core::convert::Into">Into</a>&lt;U&gt; for T<div class="where">where
U: <a class="trait" href="https://doc.rust-lang.org/1.77.1/core/convert/trait.From.html" title="trait core::convert::From">From</a>&lt;T&gt;,</div></h3></section></summary><div class="impl-items"><details class="toggle method-toggle" open><summary><section id="method.into" class="method trait-impl"><a class="src rightside" href="https://doc.rust-lang.org/1.77.1/src/core/convert/mod.rs.html#757">source</a><a href="#method.into" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.77.1/core/convert/trait.Into.html#tymethod.into" class="fn">into</a>(self) -&gt; U</h4></section></summary><div class="docblock"><p>Calls <code>U::from(self)</code>.</p>
<p>That is, this conversion is whatever the implementation of
<code><a href="https://doc.rust-lang.org/1.77.1/core/convert/trait.From.html" title="trait core::convert::From">From</a>&lt;T&gt; for U</code> chooses to do.</p>
</div></details></div></details><details class="toggle implementors-toggle"><summary><section id="impl-TryFrom%3CU%3E-for-T" class="impl"><a class="src rightside" href="https://doc.rust-lang.org/1.77.1/src/core/convert/mod.rs.html#804-806">source</a><a href="#impl-TryFrom%3CU%3E-for-T" class="anchor">§</a><h3 class="code-header">impl&lt;T, U&gt; <a class="trait" href="https://doc.rust-lang.org/1.77.1/core/convert/trait.TryFrom.html" title="trait core::convert::TryFrom">TryFrom</a>&lt;U&gt; for T<div class="where">where
U: <a class="trait" href="https://doc.rust-lang.org/1.77.1/core/convert/trait.Into.html" title="trait core::convert::Into">Into</a>&lt;T&gt;,</div></h3></section></summary><div class="impl-items"><details class="toggle" open><summary><section id="associatedtype.Error-1" class="associatedtype trait-impl"><a href="#associatedtype.Error-1" class="anchor">§</a><h4 class="code-header">type <a href="https://doc.rust-lang.org/1.77.1/core/convert/trait.TryFrom.html#associatedtype.Error" class="associatedtype">Error</a> = <a class="enum" href="https://doc.rust-lang.org/1.77.1/core/convert/enum.Infallible.html" title="enum core::convert::Infallible">Infallible</a></h4></section></summary><div class='docblock'>The type returned in the event of a conversion error.</div></details><details class="toggle method-toggle" open><summary><section id="method.try_from" class="method trait-impl"><a class="src rightside" href="https://doc.rust-lang.org/1.77.1/src/core/convert/mod.rs.html#811">source</a><a href="#method.try_from" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.77.1/core/convert/trait.TryFrom.html#tymethod.try_from" class="fn">try_from</a>(value: U) -&gt; <a class="enum" href="https://doc.rust-lang.org/1.77.1/core/result/enum.Result.html" title="enum core::result::Result">Result</a>&lt;T, &lt;T as <a class="trait" href="https://doc.rust-lang.org/1.77.1/core/convert/trait.TryFrom.html" title="trait core::convert::TryFrom">TryFrom</a>&lt;U&gt;&gt;::<a class="associatedtype" href="https://doc.rust-lang.org/1.77.1/core/convert/trait.TryFrom.html#associatedtype.Error" title="type core::convert::TryFrom::Error">Error</a>&gt;</h4></section></summary><div class='docblock'>Performs the conversion.</div></details></div></details><details class="toggle implementors-toggle"><summary><section id="impl-TryInto%3CU%3E-for-T" class="impl"><a class="src rightside" href="https://doc.rust-lang.org/1.77.1/src/core/convert/mod.rs.html#789-791">source</a><a href="#impl-TryInto%3CU%3E-for-T" class="anchor">§</a><h3 class="code-header">impl&lt;T, U&gt; <a class="trait" href="https://doc.rust-lang.org/1.77.1/core/convert/trait.TryInto.html" title="trait core::convert::TryInto">TryInto</a>&lt;U&gt; for T<div class="where">where
U: <a class="trait" href="https://doc.rust-lang.org/1.77.1/core/convert/trait.TryFrom.html" title="trait core::convert::TryFrom">TryFrom</a>&lt;T&gt;,</div></h3></section></summary><div class="impl-items"><details class="toggle" open><summary><section id="associatedtype.Error" class="associatedtype trait-impl"><a href="#associatedtype.Error" class="anchor">§</a><h4 class="code-header">type <a href="https://doc.rust-lang.org/1.77.1/core/convert/trait.TryInto.html#associatedtype.Error" class="associatedtype">Error</a> = &lt;U as <a class="trait" href="https://doc.rust-lang.org/1.77.1/core/convert/trait.TryFrom.html" title="trait core::convert::TryFrom">TryFrom</a>&lt;T&gt;&gt;::<a class="associatedtype" href="https://doc.rust-lang.org/1.77.1/core/convert/trait.TryFrom.html#associatedtype.Error" title="type core::convert::TryFrom::Error">Error</a></h4></section></summary><div class='docblock'>The type returned in the event of a conversion error.</div></details><details class="toggle method-toggle" open><summary><section id="method.try_into" class="method trait-impl"><a class="src rightside" href="https://doc.rust-lang.org/1.77.1/src/core/convert/mod.rs.html#796">source</a><a href="#method.try_into" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.77.1/core/convert/trait.TryInto.html#tymethod.try_into" class="fn">try_into</a>(self) -&gt; <a class="enum" href="https://doc.rust-lang.org/1.77.1/core/result/enum.Result.html" title="enum core::result::Result">Result</a>&lt;U, &lt;U as <a class="trait" href="https://doc.rust-lang.org/1.77.1/core/convert/trait.TryFrom.html" title="trait core::convert::TryFrom">TryFrom</a>&lt;T&gt;&gt;::<a class="associatedtype" href="https://doc.rust-lang.org/1.77.1/core/convert/trait.TryFrom.html#associatedtype.Error" title="type core::convert::TryFrom::Error">Error</a>&gt;</h4></section></summary><div class='docblock'>Performs the conversion.</div></details></div></details></div></section></div></main></body></html>