OMGeeky/google-apis-rs
1
0
Fork 0
mirror of https://github.com/OMGeeky/google-apis-rs.git synced 2026-01-25 12:44:07 +01:00
Code Issues Packages Projects Releases Wiki Activity
Files
gh-pages
google-apis-rs/hyper/header/struct.HeaderMap.html
Sebastian Thiel f4bb79d2d6 Update documentation
2024-03-05 21:06:01 +01:00

453 lines
112 KiB
HTML
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<!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 set of HTTP headers"><title>HeaderMap in hyper::header - 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-ac92e1bbe349e143.css"><meta name="rustdoc-vars" data-root-path="../../" data-static-root-path="../../static.files/" data-current-crate="hyper" data-themes="" data-resource-suffix="" data-rustdoc-version="1.76.0 (07dca489a 2024-02-04)" data-channel="1.76.0" data-search-js="search-2b6ce74ff89ae146.js" data-settings-js="settings-4313503d2e1961c2.js" ><script src="../../static.files/storage-f2adc0d6ca4d09fb.js"></script><script defer src="sidebar-items.js"></script><script defer src="../../static.files/main-305769736d49e732.js"></script><noscript><link rel="stylesheet" href="../../static.files/noscript-feafe1bb7466e4bd.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 struct"><!--[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">&#9776;</button></nav><nav class="sidebar"><div class="sidebar-crate"><h2><a href="../../hyper/index.html">hyper</a><span class="version">0.14.27</span></h2></div><h2 class="location"><a href="#">HeaderMap</a></h2><div class="sidebar-elems"><section><h3><a href="#implementations">Methods</a></h3><ul class="block method"><li><a href="#method.append">append</a></li><li><a href="#method.capacity">capacity</a></li><li><a href="#method.clear">clear</a></li><li><a href="#method.contains_key">contains_key</a></li><li><a href="#method.drain">drain</a></li><li><a href="#method.entry">entry</a></li><li><a href="#method.get">get</a></li><li><a href="#method.get_all">get_all</a></li><li><a href="#method.get_mut">get_mut</a></li><li><a href="#method.insert">insert</a></li><li><a href="#method.is_empty">is_empty</a></li><li><a href="#method.iter">iter</a></li><li><a href="#method.iter_mut">iter_mut</a></li><li><a href="#method.keys">keys</a></li><li><a href="#method.keys_len">keys_len</a></li><li><a href="#method.len">len</a></li><li><a href="#method.new">new</a></li><li><a href="#method.remove">remove</a></li><li><a href="#method.reserve">reserve</a></li><li><a href="#method.try_entry">try_entry</a></li><li><a href="#method.values">values</a></li><li><a href="#method.values_mut">values_mut</a></li><li><a href="#method.with_capacity">with_capacity</a></li></ul><h3><a href="#trait-implementations">Trait Implementations</a></h3><ul class="block trait-implementation"><li><a href="#impl-Clone-for-HeaderMap%3CT%3E">Clone</a></li><li><a href="#impl-Debug-for-HeaderMap%3CT%3E">Debug</a></li><li><a href="#impl-Default-for-HeaderMap%3CT%3E">Default</a></li><li><a href="#impl-Eq-for-HeaderMap%3CT%3E">Eq</a></li><li><a href="#impl-Extend%3C(HeaderName,+T)%3E-for-HeaderMap%3CT%3E">Extend&lt;(HeaderName, T)&gt;</a></li><li><a href="#impl-Extend%3C(Option%3CHeaderName%3E,+T)%3E-for-HeaderMap%3CT%3E">Extend&lt;(Option&lt;HeaderName&gt;, T)&gt;</a></li><li><a href="#impl-FromIterator%3C(HeaderName,+T)%3E-for-HeaderMap%3CT%3E">FromIterator&lt;(HeaderName, T)&gt;</a></li><li><a href="#impl-Index%3CK%3E-for-HeaderMap%3CT%3E">Index&lt;K&gt;</a></li><li><a href="#impl-IntoIterator-for-%26HeaderMap%3CT%3E">IntoIterator</a></li><li><a href="#impl-IntoIterator-for-%26mut+HeaderMap%3CT%3E">IntoIterator</a></li><li><a href="#impl-IntoIterator-for-HeaderMap%3CT%3E">IntoIterator</a></li><li><a href="#impl-PartialEq-for-HeaderMap%3CT%3E">PartialEq</a></li><li><a href="#impl-TryFrom%3C%26HashMap%3CK,+V%3E%3E-for-HeaderMap%3CT%3E">TryFrom&lt;&amp;&#x27;a HashMap&lt;K, V&gt;&gt;</a></li></ul><h3><a href="#synthetic-implementations">Auto Trait Implementations</a></h3><ul class="block synthetic-implementation"><li><a href="#impl-RefUnwindSafe-for-HeaderMap%3CT%3E">RefUnwindSafe</a></li><li><a href="#impl-Send-for-HeaderMap%3CT%3E">Send</a></li><li><a href="#impl-Sync-for-HeaderMap%3CT%3E">Sync</a></li><li><a href="#impl-Unpin-for-HeaderMap%3CT%3E">Unpin</a></li><li><a href="#impl-UnwindSafe-for-HeaderMap%3CT%3E">UnwindSafe</a></li></ul><h3><a href="#blanket-implementations">Blanket Implementations</a></h3><ul class="block blanket-implementation"><li><a href="#impl-Any-for-T">Any</a></li><li><a href="#impl-Borrow%3CT%3E-for-T">Borrow&lt;T&gt;</a></li><li><a href="#impl-BorrowMut%3CT%3E-for-T">BorrowMut&lt;T&gt;</a></li><li><a href="#impl-Equivalent%3CK%3E-for-Q">Equivalent&lt;K&gt;</a></li><li><a href="#impl-From%3CT%3E-for-T">From&lt;T&gt;</a></li><li><a href="#impl-Instrument-for-T">Instrument</a></li><li><a href="#impl-Into%3CU%3E-for-T">Into&lt;U&gt;</a></li><li><a href="#impl-ToOwned-for-T">ToOwned</a></li><li><a href="#impl-TryFrom%3CU%3E-for-T">TryFrom&lt;U&gt;</a></li><li><a href="#impl-TryInto%3CU%3E-for-T">TryInto&lt;U&gt;</a></li><li><a href="#impl-WithSubscriber-for-T">WithSubscriber</a></li></ul></section><h2><a href="index.html">In hyper::header</a></h2></div></nav><div class="sidebar-resizer"></div>
<main><div class="width-limiter"><nav class="sub"><form class="search-form"><span></span><div id="sidebar-button" tabindex="-1"><a href="../../hyper/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>Struct <a href="../index.html">hyper</a>::<wbr><a href="index.html">header</a>::<wbr><a class="struct" href="#">HeaderMap</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/http/header/map.rs.html#45">source</a> · <button id="toggle-all-docs" title="collapse all docs">[<span>&#x2212;</span>]</button></span></div><pre class="rust item-decl"><code>pub struct HeaderMap&lt;T = <a class="struct" href="struct.HeaderValue.html" title="struct hyper::header::HeaderValue">HeaderValue</a>&gt; { <span class="comment">/* private fields */</span> }</code></pre><details class="toggle top-doc" open><summary class="hideme"><span>Expand description</span></summary><div class="docblock"><p>A set of HTTP headers</p>
<p><code>HeaderMap</code> is an multimap of <a href="struct.HeaderName.html"><code>HeaderName</code></a> to values.</p>
<h2 id="examples"><a href="#examples">Examples</a></h2>
<p>Basic usage</p>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">let </span><span class="kw-2">mut </span>headers = HeaderMap::new();
headers.insert(HOST, <span class="string">"example.com"</span>.parse().unwrap());
headers.insert(CONTENT_LENGTH, <span class="string">"123"</span>.parse().unwrap());
<span class="macro">assert!</span>(headers.contains_key(HOST));
<span class="macro">assert!</span>(!headers.contains_key(LOCATION));
<span class="macro">assert_eq!</span>(headers[HOST], <span class="string">"example.com"</span>);
headers.remove(HOST);
<span class="macro">assert!</span>(!headers.contains_key(HOST));</code></pre></div>
</div></details><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-HeaderMap" class="impl"><a class="src rightside" href="../../src/http/header/map.rs.html#426">source</a><a href="#impl-HeaderMap" class="anchor">§</a><h3 class="code-header">impl <a class="struct" href="struct.HeaderMap.html" title="struct hyper::header::HeaderMap">HeaderMap</a></h3></section></summary><div class="impl-items"><details class="toggle method-toggle" open><summary><section id="method.new" class="method"><a class="src rightside" href="../../src/http/header/map.rs.html#441">source</a><h4 class="code-header">pub fn <a href="#method.new" class="fn">new</a>() -&gt; <a class="struct" href="struct.HeaderMap.html" title="struct hyper::header::HeaderMap">HeaderMap</a></h4></section></summary><div class="docblock"><p>Create an empty <code>HeaderMap</code>.</p>
<p>The map will be created without any capacity. This function will not
allocate.</p>
<h5 id="examples-1"><a href="#examples-1">Examples</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">let </span>map = HeaderMap::new();
<span class="macro">assert!</span>(map.is_empty());
<span class="macro">assert_eq!</span>(<span class="number">0</span>, map.capacity());</code></pre></div>
</div></details></div></details><details class="toggle implementors-toggle" open><summary><section id="impl-HeaderMap%3CT%3E" class="impl"><a class="src rightside" href="../../src/http/header/map.rs.html#446">source</a><a href="#impl-HeaderMap%3CT%3E" class="anchor">§</a><h3 class="code-header">impl&lt;T&gt; <a class="struct" href="struct.HeaderMap.html" title="struct hyper::header::HeaderMap">HeaderMap</a>&lt;T&gt;</h3></section></summary><div class="impl-items"><details class="toggle method-toggle" open><summary><section id="method.with_capacity" class="method"><a class="src rightside" href="../../src/http/header/map.rs.html#465">source</a><h4 class="code-header">pub fn <a href="#method.with_capacity" class="fn">with_capacity</a>(capacity: <a class="primitive" href="https://doc.rust-lang.org/1.76.0/std/primitive.usize.html">usize</a>) -&gt; <a class="struct" href="struct.HeaderMap.html" title="struct hyper::header::HeaderMap">HeaderMap</a>&lt;T&gt;</h4></section></summary><div class="docblock"><p>Create an empty <code>HeaderMap</code> with the specified capacity.</p>
<p>The returned map will allocate internal storage in order to hold about
<code>capacity</code> elements without reallocating. However, this is a “best
effort” as there are usage patterns that could cause additional
allocations before <code>capacity</code> headers are stored in the map.</p>
<p>More capacity than requested may be allocated.</p>
<h5 id="examples-2"><a href="#examples-2">Examples</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">let </span>map: HeaderMap&lt;u32&gt; = HeaderMap::with_capacity(<span class="number">10</span>);
<span class="macro">assert!</span>(map.is_empty());
<span class="macro">assert_eq!</span>(<span class="number">12</span>, map.capacity());</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.len" class="method"><a class="src rightside" href="../../src/http/header/map.rs.html#513">source</a><h4 class="code-header">pub fn <a href="#method.len" class="fn">len</a>(&amp;self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/1.76.0/std/primitive.usize.html">usize</a></h4></section></summary><div class="docblock"><p>Returns the number of headers stored in the map.</p>
<p>This number represents the total number of <strong>values</strong> stored in the map.
This number can be greater than or equal to the number of <strong>keys</strong>
stored given that a single key may have more than one associated value.</p>
<h5 id="examples-3"><a href="#examples-3">Examples</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">let </span><span class="kw-2">mut </span>map = HeaderMap::new();
<span class="macro">assert_eq!</span>(<span class="number">0</span>, map.len());
map.insert(ACCEPT, <span class="string">"text/plain"</span>.parse().unwrap());
map.insert(HOST, <span class="string">"localhost"</span>.parse().unwrap());
<span class="macro">assert_eq!</span>(<span class="number">2</span>, map.len());
map.append(ACCEPT, <span class="string">"text/html"</span>.parse().unwrap());
<span class="macro">assert_eq!</span>(<span class="number">3</span>, map.len());</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.keys_len" class="method"><a class="src rightside" href="../../src/http/header/map.rs.html#540">source</a><h4 class="code-header">pub fn <a href="#method.keys_len" class="fn">keys_len</a>(&amp;self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/1.76.0/std/primitive.usize.html">usize</a></h4></section></summary><div class="docblock"><p>Returns the number of keys stored in the map.</p>
<p>This number will be less than or equal to <code>len()</code> as each key may have
more than one associated value.</p>
<h5 id="examples-4"><a href="#examples-4">Examples</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">let </span><span class="kw-2">mut </span>map = HeaderMap::new();
<span class="macro">assert_eq!</span>(<span class="number">0</span>, map.keys_len());
map.insert(ACCEPT, <span class="string">"text/plain"</span>.parse().unwrap());
map.insert(HOST, <span class="string">"localhost"</span>.parse().unwrap());
<span class="macro">assert_eq!</span>(<span class="number">2</span>, map.keys_len());
map.insert(ACCEPT, <span class="string">"text/html"</span>.parse().unwrap());
<span class="macro">assert_eq!</span>(<span class="number">2</span>, map.keys_len());</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.is_empty" class="method"><a class="src rightside" href="../../src/http/header/map.rs.html#559">source</a><h4 class="code-header">pub fn <a href="#method.is_empty" class="fn">is_empty</a>(&amp;self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/1.76.0/std/primitive.bool.html">bool</a></h4></section></summary><div class="docblock"><p>Returns true if the map contains no elements.</p>
<h5 id="examples-5"><a href="#examples-5">Examples</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">let </span><span class="kw-2">mut </span>map = HeaderMap::new();
<span class="macro">assert!</span>(map.is_empty());
map.insert(HOST, <span class="string">"hello.world"</span>.parse().unwrap());
<span class="macro">assert!</span>(!map.is_empty());</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.clear" class="method"><a class="src rightside" href="../../src/http/header/map.rs.html#578">source</a><h4 class="code-header">pub fn <a href="#method.clear" class="fn">clear</a>(&amp;mut self)</h4></section></summary><div class="docblock"><p>Clears the map, removing all key-value pairs. Keeps the allocated memory
for reuse.</p>
<h5 id="examples-6"><a href="#examples-6">Examples</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">let </span><span class="kw-2">mut </span>map = HeaderMap::new();
map.insert(HOST, <span class="string">"hello.world"</span>.parse().unwrap());
map.clear();
<span class="macro">assert!</span>(map.is_empty());
<span class="macro">assert!</span>(map.capacity() &gt; <span class="number">0</span>);</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.capacity" class="method"><a class="src rightside" href="../../src/http/header/map.rs.html#605">source</a><h4 class="code-header">pub fn <a href="#method.capacity" class="fn">capacity</a>(&amp;self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/1.76.0/std/primitive.usize.html">usize</a></h4></section></summary><div class="docblock"><p>Returns the number of headers the map can hold without reallocating.</p>
<p>This number is an approximation as certain usage patterns could cause
additional allocations before the returned capacity is filled.</p>
<h5 id="examples-7"><a href="#examples-7">Examples</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">let </span><span class="kw-2">mut </span>map = HeaderMap::new();
<span class="macro">assert_eq!</span>(<span class="number">0</span>, map.capacity());
map.insert(HOST, <span class="string">"hello.world"</span>.parse().unwrap());
<span class="macro">assert_eq!</span>(<span class="number">6</span>, map.capacity());</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.reserve" class="method"><a class="src rightside" href="../../src/http/header/map.rs.html#631">source</a><h4 class="code-header">pub fn <a href="#method.reserve" class="fn">reserve</a>(&amp;mut self, additional: <a class="primitive" href="https://doc.rust-lang.org/1.76.0/std/primitive.usize.html">usize</a>)</h4></section></summary><div class="docblock"><p>Reserves capacity for at least <code>additional</code> more headers to be inserted
into the <code>HeaderMap</code>.</p>
<p>The header map may reserve more space to avoid frequent reallocations.
Like with <code>with_capacity</code>, this will be a “best effort” to avoid
allocations until <code>additional</code> more headers are inserted. Certain usage
patterns could cause additional allocations before the number is
reached.</p>
<h5 id="panics"><a href="#panics">Panics</a></h5>
<p>Panics if the new allocation size overflows <code>usize</code>.</p>
<h5 id="examples-8"><a href="#examples-8">Examples</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">let </span><span class="kw-2">mut </span>map = HeaderMap::new();
map.reserve(<span class="number">10</span>);</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.get" class="method"><a class="src rightside" href="../../src/http/header/map.rs.html#676-678">source</a><h4 class="code-header">pub fn <a href="#method.get" class="fn">get</a>&lt;K&gt;(&amp;self, key: K) -&gt; <a class="enum" href="https://doc.rust-lang.org/1.76.0/core/option/enum.Option.html" title="enum core::option::Option">Option</a>&lt;<a class="primitive" href="https://doc.rust-lang.org/1.76.0/std/primitive.reference.html">&amp;T</a>&gt;<div class="where">where
K: <a class="trait" href="trait.AsHeaderName.html" title="trait hyper::header::AsHeaderName">AsHeaderName</a>,</div></h4></section></summary><div class="docblock"><p>Returns a reference to the value associated with the key.</p>
<p>If there are multiple values associated with the key, then the first one
is returned. Use <code>get_all</code> to get all values associated with a given
key. Returns <code>None</code> if there are no values associated with the key.</p>
<h5 id="examples-9"><a href="#examples-9">Examples</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">let </span><span class="kw-2">mut </span>map = HeaderMap::new();
<span class="macro">assert!</span>(map.get(<span class="string">"host"</span>).is_none());
map.insert(HOST, <span class="string">"hello"</span>.parse().unwrap());
<span class="macro">assert_eq!</span>(map.get(HOST).unwrap(), <span class="kw-2">&amp;</span><span class="string">"hello"</span>);
<span class="macro">assert_eq!</span>(map.get(<span class="string">"host"</span>).unwrap(), <span class="kw-2">&amp;</span><span class="string">"hello"</span>);
map.append(HOST, <span class="string">"world"</span>.parse().unwrap());
<span class="macro">assert_eq!</span>(map.get(<span class="string">"host"</span>).unwrap(), <span class="kw-2">&amp;</span><span class="string">"hello"</span>);</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.get_mut" class="method"><a class="src rightside" href="../../src/http/header/map.rs.html#713-715">source</a><h4 class="code-header">pub fn <a href="#method.get_mut" class="fn">get_mut</a>&lt;K&gt;(&amp;mut self, key: K) -&gt; <a class="enum" href="https://doc.rust-lang.org/1.76.0/core/option/enum.Option.html" title="enum core::option::Option">Option</a>&lt;<a class="primitive" href="https://doc.rust-lang.org/1.76.0/std/primitive.reference.html">&amp;mut T</a>&gt;<div class="where">where
K: <a class="trait" href="trait.AsHeaderName.html" title="trait hyper::header::AsHeaderName">AsHeaderName</a>,</div></h4></section></summary><div class="docblock"><p>Returns a mutable reference to the value associated with the key.</p>
<p>If there are multiple values associated with the key, then the first one
is returned. Use <code>entry</code> to get all values associated with a given
key. Returns <code>None</code> if there are no values associated with the key.</p>
<h5 id="examples-10"><a href="#examples-10">Examples</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">let </span><span class="kw-2">mut </span>map = HeaderMap::default();
map.insert(HOST, <span class="string">"hello"</span>.to_string());
map.get_mut(<span class="string">"host"</span>).unwrap().push_str(<span class="string">"-world"</span>);
<span class="macro">assert_eq!</span>(map.get(HOST).unwrap(), <span class="kw-2">&amp;</span><span class="string">"hello-world"</span>);</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.get_all" class="method"><a class="src rightside" href="../../src/http/header/map.rs.html#751-753">source</a><h4 class="code-header">pub fn <a href="#method.get_all" class="fn">get_all</a>&lt;K&gt;(&amp;self, key: K) -&gt; <a class="struct" href="struct.GetAll.html" title="struct hyper::header::GetAll">GetAll</a>&lt;'_, T&gt;<div class="where">where
K: <a class="trait" href="trait.AsHeaderName.html" title="trait hyper::header::AsHeaderName">AsHeaderName</a>,</div></h4></section></summary><div class="docblock"><p>Returns a view of all values associated with a key.</p>
<p>The returned view does not incur any allocations and allows iterating
the values associated with the key. See <a href="struct.GetAll.html"><code>GetAll</code></a> for more details.
Returns <code>None</code> if there are no values associated with the key.</p>
<h5 id="examples-11"><a href="#examples-11">Examples</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">let </span><span class="kw-2">mut </span>map = HeaderMap::new();
map.insert(HOST, <span class="string">"hello"</span>.parse().unwrap());
map.append(HOST, <span class="string">"goodbye"</span>.parse().unwrap());
<span class="kw">let </span>view = map.get_all(<span class="string">"host"</span>);
<span class="kw">let </span><span class="kw-2">mut </span>iter = view.iter();
<span class="macro">assert_eq!</span>(<span class="kw-2">&amp;</span><span class="string">"hello"</span>, iter.next().unwrap());
<span class="macro">assert_eq!</span>(<span class="kw-2">&amp;</span><span class="string">"goodbye"</span>, iter.next().unwrap());
<span class="macro">assert!</span>(iter.next().is_none());</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.contains_key" class="method"><a class="src rightside" href="../../src/http/header/map.rs.html#774-776">source</a><h4 class="code-header">pub fn <a href="#method.contains_key" class="fn">contains_key</a>&lt;K&gt;(&amp;self, key: K) -&gt; <a class="primitive" href="https://doc.rust-lang.org/1.76.0/std/primitive.bool.html">bool</a><div class="where">where
K: <a class="trait" href="trait.AsHeaderName.html" title="trait hyper::header::AsHeaderName">AsHeaderName</a>,</div></h4></section></summary><div class="docblock"><p>Returns true if the map contains a value for the specified key.</p>
<h5 id="examples-12"><a href="#examples-12">Examples</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">let </span><span class="kw-2">mut </span>map = HeaderMap::new();
<span class="macro">assert!</span>(!map.contains_key(HOST));
map.insert(HOST, <span class="string">"world"</span>.parse().unwrap());
<span class="macro">assert!</span>(map.contains_key(<span class="string">"host"</span>));</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.iter" class="method"><a class="src rightside" href="../../src/http/header/map.rs.html#802">source</a><h4 class="code-header">pub fn <a href="#method.iter" class="fn">iter</a>(&amp;self) -&gt; <a class="struct" href="struct.Iter.html" title="struct hyper::header::Iter">Iter</a>&lt;'_, T&gt; <a href="#" class="tooltip" data-notable-ty="Iter&lt;&#39;_, T&gt;">ⓘ</a></h4></section></summary><div class="docblock"><p>An iterator visiting all key-value pairs.</p>
<p>The iteration order is arbitrary, but consistent across platforms for
the same crate version. Each key will be yielded once per associated
value. So, if a key has 3 associated values, it will be yielded 3 times.</p>
<h5 id="examples-13"><a href="#examples-13">Examples</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">let </span><span class="kw-2">mut </span>map = HeaderMap::new();
map.insert(HOST, <span class="string">"hello"</span>.parse().unwrap());
map.append(HOST, <span class="string">"goodbye"</span>.parse().unwrap());
map.insert(CONTENT_LENGTH, <span class="string">"123"</span>.parse().unwrap());
<span class="kw">for </span>(key, value) <span class="kw">in </span>map.iter() {
<span class="macro">println!</span>(<span class="string">"{:?}: {:?}"</span>, key, value);
}</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.iter_mut" class="method"><a class="src rightside" href="../../src/http/header/map.rs.html#834">source</a><h4 class="code-header">pub fn <a href="#method.iter_mut" class="fn">iter_mut</a>(&amp;mut self) -&gt; <a class="struct" href="struct.IterMut.html" title="struct hyper::header::IterMut">IterMut</a>&lt;'_, T&gt; <a href="#" class="tooltip" data-notable-ty="IterMut&lt;&#39;_, T&gt;">ⓘ</a></h4></section></summary><div class="docblock"><p>An iterator visiting all key-value pairs, with mutable value references.</p>
<p>The iterator order is arbitrary, but consistent across platforms for the
same crate version. Each key will be yielded once per associated value,
so if a key has 3 associated values, it will be yielded 3 times.</p>
<h5 id="examples-14"><a href="#examples-14">Examples</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">let </span><span class="kw-2">mut </span>map = HeaderMap::default();
map.insert(HOST, <span class="string">"hello"</span>.to_string());
map.append(HOST, <span class="string">"goodbye"</span>.to_string());
map.insert(CONTENT_LENGTH, <span class="string">"123"</span>.to_string());
<span class="kw">for </span>(key, value) <span class="kw">in </span>map.iter_mut() {
value.push_str(<span class="string">"-boop"</span>);
}</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.keys" class="method"><a class="src rightside" href="../../src/http/header/map.rs.html#864">source</a><h4 class="code-header">pub fn <a href="#method.keys" class="fn">keys</a>(&amp;self) -&gt; <a class="struct" href="struct.Keys.html" title="struct hyper::header::Keys">Keys</a>&lt;'_, T&gt; <a href="#" class="tooltip" data-notable-ty="Keys&lt;&#39;_, T&gt;">ⓘ</a></h4></section></summary><div class="docblock"><p>An iterator visiting all keys.</p>
<p>The iteration order is arbitrary, but consistent across platforms for
the same crate version. Each key will be yielded only once even if it
has multiple associated values.</p>
<h5 id="examples-15"><a href="#examples-15">Examples</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">let </span><span class="kw-2">mut </span>map = HeaderMap::new();
map.insert(HOST, <span class="string">"hello"</span>.parse().unwrap());
map.append(HOST, <span class="string">"goodbye"</span>.parse().unwrap());
map.insert(CONTENT_LENGTH, <span class="string">"123"</span>.parse().unwrap());
<span class="kw">for </span>key <span class="kw">in </span>map.keys() {
<span class="macro">println!</span>(<span class="string">"{:?}"</span>, key);
}</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.values" class="method"><a class="src rightside" href="../../src/http/header/map.rs.html#890">source</a><h4 class="code-header">pub fn <a href="#method.values" class="fn">values</a>(&amp;self) -&gt; <a class="struct" href="struct.Values.html" title="struct hyper::header::Values">Values</a>&lt;'_, T&gt; <a href="#" class="tooltip" data-notable-ty="Values&lt;&#39;_, T&gt;">ⓘ</a></h4></section></summary><div class="docblock"><p>An iterator visiting all values.</p>
<p>The iteration order is arbitrary, but consistent across platforms for
the same crate version.</p>
<h5 id="examples-16"><a href="#examples-16">Examples</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">let </span><span class="kw-2">mut </span>map = HeaderMap::new();
map.insert(HOST, <span class="string">"hello"</span>.parse().unwrap());
map.append(HOST, <span class="string">"goodbye"</span>.parse().unwrap());
map.insert(CONTENT_LENGTH, <span class="string">"123"</span>.parse().unwrap());
<span class="kw">for </span>value <span class="kw">in </span>map.values() {
<span class="macro">println!</span>(<span class="string">"{:?}"</span>, value);
}</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.values_mut" class="method"><a class="src rightside" href="../../src/http/header/map.rs.html#914">source</a><h4 class="code-header">pub fn <a href="#method.values_mut" class="fn">values_mut</a>(&amp;mut self) -&gt; <a class="struct" href="struct.ValuesMut.html" title="struct hyper::header::ValuesMut">ValuesMut</a>&lt;'_, T&gt; <a href="#" class="tooltip" data-notable-ty="ValuesMut&lt;&#39;_, T&gt;">ⓘ</a></h4></section></summary><div class="docblock"><p>An iterator visiting all values mutably.</p>
<p>The iteration order is arbitrary, but consistent across platforms for
the same crate version.</p>
<h5 id="examples-17"><a href="#examples-17">Examples</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">let </span><span class="kw-2">mut </span>map = HeaderMap::default();
map.insert(HOST, <span class="string">"hello"</span>.to_string());
map.append(HOST, <span class="string">"goodbye"</span>.to_string());
map.insert(CONTENT_LENGTH, <span class="string">"123"</span>.to_string());
<span class="kw">for </span>value <span class="kw">in </span>map.values_mut() {
value.push_str(<span class="string">"-boop"</span>);
}</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.drain" class="method"><a class="src rightside" href="../../src/http/header/map.rs.html#949">source</a><h4 class="code-header">pub fn <a href="#method.drain" class="fn">drain</a>(&amp;mut self) -&gt; <a class="struct" href="struct.Drain.html" title="struct hyper::header::Drain">Drain</a>&lt;'_, T&gt; <a href="#" class="tooltip" data-notable-ty="Drain&lt;&#39;_, T&gt;">ⓘ</a></h4></section></summary><div class="docblock"><p>Clears the map, returning all entries as an iterator.</p>
<p>The internal memory is kept for reuse.</p>
<p>For each yielded item that has <code>None</code> provided for the <code>HeaderName</code>,
then the associated header name is the same as that of the previously
yielded item. The first yielded item will have <code>HeaderName</code> set.</p>
<h5 id="examples-18"><a href="#examples-18">Examples</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">let </span><span class="kw-2">mut </span>map = HeaderMap::new();
map.insert(HOST, <span class="string">"hello"</span>.parse().unwrap());
map.append(HOST, <span class="string">"goodbye"</span>.parse().unwrap());
map.insert(CONTENT_LENGTH, <span class="string">"123"</span>.parse().unwrap());
<span class="kw">let </span><span class="kw-2">mut </span>drain = map.drain();
<span class="macro">assert_eq!</span>(drain.next(), <span class="prelude-val">Some</span>((<span class="prelude-val">Some</span>(HOST), <span class="string">"hello"</span>.parse().unwrap())));
<span class="macro">assert_eq!</span>(drain.next(), <span class="prelude-val">Some</span>((<span class="prelude-val">None</span>, <span class="string">"goodbye"</span>.parse().unwrap())));
<span class="macro">assert_eq!</span>(drain.next(), <span class="prelude-val">Some</span>((<span class="prelude-val">Some</span>(CONTENT_LENGTH), <span class="string">"123"</span>.parse().unwrap())));
<span class="macro">assert_eq!</span>(drain.next(), <span class="prelude-val">None</span>);</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.entry" class="method"><a class="src rightside" href="../../src/http/header/map.rs.html#1044-1046">source</a><h4 class="code-header">pub fn <a href="#method.entry" class="fn">entry</a>&lt;K&gt;(&amp;mut self, key: K) -&gt; <a class="enum" href="enum.Entry.html" title="enum hyper::header::Entry">Entry</a>&lt;'_, T&gt;<div class="where">where
K: <a class="trait" href="trait.IntoHeaderName.html" title="trait hyper::header::IntoHeaderName">IntoHeaderName</a>,</div></h4></section></summary><div class="docblock"><p>Gets the given key’s corresponding entry in the map for in-place
manipulation.</p>
<h5 id="examples-19"><a href="#examples-19">Examples</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">let </span><span class="kw-2">mut </span>map: HeaderMap&lt;u32&gt; = HeaderMap::default();
<span class="kw">let </span>headers = <span class="kw-2">&amp;</span>[
<span class="string">"content-length"</span>,
<span class="string">"x-hello"</span>,
<span class="string">"Content-Length"</span>,
<span class="string">"x-world"</span>,
];
<span class="kw">for </span><span class="kw-2">&amp;</span>header <span class="kw">in </span>headers {
<span class="kw">let </span>counter = map.entry(header).or_insert(<span class="number">0</span>);
<span class="kw-2">*</span>counter += <span class="number">1</span>;
}
<span class="macro">assert_eq!</span>(map[<span class="string">"content-length"</span>], <span class="number">2</span>);
<span class="macro">assert_eq!</span>(map[<span class="string">"x-hello"</span>], <span class="number">1</span>);</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.try_entry" class="method"><a class="src rightside" href="../../src/http/header/map.rs.html#1060-1062">source</a><h4 class="code-header">pub fn <a href="#method.try_entry" class="fn">try_entry</a>&lt;K&gt;(
&amp;mut self,
key: K
) -&gt; <a class="enum" href="https://doc.rust-lang.org/1.76.0/core/result/enum.Result.html" title="enum core::result::Result">Result</a>&lt;<a class="enum" href="enum.Entry.html" title="enum hyper::header::Entry">Entry</a>&lt;'_, T&gt;, <a class="struct" href="struct.InvalidHeaderName.html" title="struct hyper::header::InvalidHeaderName">InvalidHeaderName</a>&gt;<div class="where">where
K: <a class="trait" href="trait.AsHeaderName.html" title="trait hyper::header::AsHeaderName">AsHeaderName</a>,</div></h4></section></summary><div class="docblock"><p>Gets the given key’s corresponding entry in the map for in-place
manipulation.</p>
<h5 id="errors"><a href="#errors">Errors</a></h5>
<p>This method differs from <code>entry</code> by allowing types that may not be
valid <code>HeaderName</code>s to passed as the key (such as <code>String</code>). If they
do not parse as a valid <code>HeaderName</code>, this returns an
<code>InvalidHeaderName</code> error.</p>
</div></details><details class="toggle method-toggle" open><summary><section id="method.insert" class="method"><a class="src rightside" href="../../src/http/header/map.rs.html#1131-1133">source</a><h4 class="code-header">pub fn <a href="#method.insert" class="fn">insert</a>&lt;K&gt;(&amp;mut self, key: K, val: T) -&gt; <a class="enum" href="https://doc.rust-lang.org/1.76.0/core/option/enum.Option.html" title="enum core::option::Option">Option</a>&lt;T&gt;<div class="where">where
K: <a class="trait" href="trait.IntoHeaderName.html" title="trait hyper::header::IntoHeaderName">IntoHeaderName</a>,</div></h4></section></summary><div class="docblock"><p>Inserts a key-value pair into the map.</p>
<p>If the map did not previously have this key present, then <code>None</code> is
returned.</p>
<p>If the map did have this key present, the new value is associated with
the key and all previous values are removed. <strong>Note</strong> that only a single
one of the previous values is returned. If there are multiple values
that have been previously associated with the key, then the first one is
returned. See <code>insert_mult</code> on <code>OccupiedEntry</code> for an API that returns
all values.</p>
<p>The key is not updated, though; this matters for types that can be <code>==</code>
without being identical.</p>
<h5 id="examples-20"><a href="#examples-20">Examples</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">let </span><span class="kw-2">mut </span>map = HeaderMap::new();
<span class="macro">assert!</span>(map.insert(HOST, <span class="string">"world"</span>.parse().unwrap()).is_none());
<span class="macro">assert!</span>(!map.is_empty());
<span class="kw">let </span><span class="kw-2">mut </span>prev = map.insert(HOST, <span class="string">"earth"</span>.parse().unwrap()).unwrap();
<span class="macro">assert_eq!</span>(<span class="string">"world"</span>, prev);</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.append" class="method"><a class="src rightside" href="../../src/http/header/map.rs.html#1234-1236">source</a><h4 class="code-header">pub fn <a href="#method.append" class="fn">append</a>&lt;K&gt;(&amp;mut self, key: K, value: T) -&gt; <a class="primitive" href="https://doc.rust-lang.org/1.76.0/std/primitive.bool.html">bool</a><div class="where">where
K: <a class="trait" href="trait.IntoHeaderName.html" title="trait hyper::header::IntoHeaderName">IntoHeaderName</a>,</div></h4></section></summary><div class="docblock"><p>Inserts a key-value pair into the map.</p>
<p>If the map did not previously have this key present, then <code>false</code> is
returned.</p>
<p>If the map did have this key present, the new value is pushed to the end
of the list of values currently associated with the key. The key is not
updated, though; this matters for types that can be <code>==</code> without being
identical.</p>
<h5 id="examples-21"><a href="#examples-21">Examples</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">let </span><span class="kw-2">mut </span>map = HeaderMap::new();
<span class="macro">assert!</span>(map.insert(HOST, <span class="string">"world"</span>.parse().unwrap()).is_none());
<span class="macro">assert!</span>(!map.is_empty());
map.append(HOST, <span class="string">"earth"</span>.parse().unwrap());
<span class="kw">let </span>values = map.get_all(<span class="string">"host"</span>);
<span class="kw">let </span><span class="kw-2">mut </span>i = values.iter();
<span class="macro">assert_eq!</span>(<span class="string">"world"</span>, <span class="kw-2">*</span>i.next().unwrap());
<span class="macro">assert_eq!</span>(<span class="string">"earth"</span>, <span class="kw-2">*</span>i.next().unwrap());</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.remove" class="method"><a class="src rightside" href="../../src/http/header/map.rs.html#1353-1355">source</a><h4 class="code-header">pub fn <a href="#method.remove" class="fn">remove</a>&lt;K&gt;(&amp;mut self, key: K) -&gt; <a class="enum" href="https://doc.rust-lang.org/1.76.0/core/option/enum.Option.html" title="enum core::option::Option">Option</a>&lt;T&gt;<div class="where">where
K: <a class="trait" href="trait.AsHeaderName.html" title="trait hyper::header::AsHeaderName">AsHeaderName</a>,</div></h4></section></summary><div class="docblock"><p>Removes a key from the map, returning the value associated with the key.</p>
<p>Returns <code>None</code> if the map does not contain the key. If there are
multiple values associated with the key, then the first one is returned.
See <code>remove_entry_mult</code> on <code>OccupiedEntry</code> for an API that yields all
values.</p>
<h5 id="examples-22"><a href="#examples-22">Examples</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">let </span><span class="kw-2">mut </span>map = HeaderMap::new();
map.insert(HOST, <span class="string">"hello.world"</span>.parse().unwrap());
<span class="kw">let </span>prev = map.remove(HOST).unwrap();
<span class="macro">assert_eq!</span>(<span class="string">"hello.world"</span>, prev);
<span class="macro">assert!</span>(map.remove(HOST).is_none());</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-Clone-for-HeaderMap%3CT%3E" class="impl"><a class="src rightside" href="../../src/http/header/map.rs.html#44">source</a><a href="#impl-Clone-for-HeaderMap%3CT%3E" class="anchor">§</a><h3 class="code-header">impl&lt;T&gt; <a class="trait" href="https://doc.rust-lang.org/1.76.0/core/clone/trait.Clone.html" title="trait core::clone::Clone">Clone</a> for <a class="struct" href="struct.HeaderMap.html" title="struct hyper::header::HeaderMap">HeaderMap</a>&lt;T&gt;<div class="where">where
T: <a class="trait" href="https://doc.rust-lang.org/1.76.0/core/clone/trait.Clone.html" title="trait core::clone::Clone">Clone</a>,</div></h3></section></summary><div class="impl-items"><details class="toggle method-toggle" open><summary><section id="method.clone" class="method trait-impl"><a class="src rightside" href="../../src/http/header/map.rs.html#44">source</a><a href="#method.clone" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.76.0/core/clone/trait.Clone.html#tymethod.clone" class="fn">clone</a>(&amp;self) -&gt; <a class="struct" href="struct.HeaderMap.html" title="struct hyper::header::HeaderMap">HeaderMap</a>&lt;T&gt;</h4></section></summary><div class='docblock'>Returns a copy of the value. <a href="https://doc.rust-lang.org/1.76.0/core/clone/trait.Clone.html#tymethod.clone">Read more</a></div></details><details class="toggle method-toggle" open><summary><section id="method.clone_from" class="method trait-impl"><span class="rightside"><span class="since" title="Stable since Rust version 1.0.0">1.0.0</span> · <a class="src" href="https://doc.rust-lang.org/1.76.0/src/core/clone.rs.html#169">source</a></span><a href="#method.clone_from" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.76.0/core/clone/trait.Clone.html#method.clone_from" class="fn">clone_from</a>(&amp;mut self, source: <a class="primitive" href="https://doc.rust-lang.org/1.76.0/std/primitive.reference.html">&amp;Self</a>)</h4></section></summary><div class='docblock'>Performs copy-assignment from <code>source</code>. <a href="https://doc.rust-lang.org/1.76.0/core/clone/trait.Clone.html#method.clone_from">Read more</a></div></details></div></details><details class="toggle implementors-toggle" open><summary><section id="impl-Debug-for-HeaderMap%3CT%3E" class="impl"><a class="src rightside" href="../../src/http/header/map.rs.html#1978">source</a><a href="#impl-Debug-for-HeaderMap%3CT%3E" class="anchor">§</a><h3 class="code-header">impl&lt;T&gt; <a class="trait" href="https://doc.rust-lang.org/1.76.0/core/fmt/trait.Debug.html" title="trait core::fmt::Debug">Debug</a> for <a class="struct" href="struct.HeaderMap.html" title="struct hyper::header::HeaderMap">HeaderMap</a>&lt;T&gt;<div class="where">where
T: <a class="trait" href="https://doc.rust-lang.org/1.76.0/core/fmt/trait.Debug.html" title="trait core::fmt::Debug">Debug</a>,</div></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/http/header/map.rs.html#1979">source</a><a href="#method.fmt" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.76.0/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.76.0/core/fmt/struct.Formatter.html" title="struct core::fmt::Formatter">Formatter</a>&lt;'_&gt;) -&gt; <a class="enum" href="https://doc.rust-lang.org/1.76.0/core/result/enum.Result.html" title="enum core::result::Result">Result</a>&lt;<a class="primitive" href="https://doc.rust-lang.org/1.76.0/std/primitive.unit.html">()</a>, <a class="struct" href="https://doc.rust-lang.org/1.76.0/core/fmt/struct.Error.html" title="struct core::fmt::Error">Error</a>&gt;</h4></section></summary><div class='docblock'>Formats the value using the given formatter. <a href="https://doc.rust-lang.org/1.76.0/core/fmt/trait.Debug.html#tymethod.fmt">Read more</a></div></details></div></details><details class="toggle implementors-toggle" open><summary><section id="impl-Default-for-HeaderMap%3CT%3E" class="impl"><a class="src rightside" href="../../src/http/header/map.rs.html#1984">source</a><a href="#impl-Default-for-HeaderMap%3CT%3E" class="anchor">§</a><h3 class="code-header">impl&lt;T&gt; <a class="trait" href="https://doc.rust-lang.org/1.76.0/core/default/trait.Default.html" title="trait core::default::Default">Default</a> for <a class="struct" href="struct.HeaderMap.html" title="struct hyper::header::HeaderMap">HeaderMap</a>&lt;T&gt;</h3></section></summary><div class="impl-items"><details class="toggle method-toggle" open><summary><section id="method.default" class="method trait-impl"><a class="src rightside" href="../../src/http/header/map.rs.html#1985">source</a><a href="#method.default" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.76.0/core/default/trait.Default.html#tymethod.default" class="fn">default</a>() -&gt; <a class="struct" href="struct.HeaderMap.html" title="struct hyper::header::HeaderMap">HeaderMap</a>&lt;T&gt;</h4></section></summary><div class='docblock'>Returns the “default value” for a type. <a href="https://doc.rust-lang.org/1.76.0/core/default/trait.Default.html#tymethod.default">Read more</a></div></details></div></details><details class="toggle implementors-toggle" open><summary><section id="impl-Extend%3C(HeaderName,+T)%3E-for-HeaderMap%3CT%3E" class="impl"><a class="src rightside" href="../../src/http/header/map.rs.html#1943">source</a><a href="#impl-Extend%3C(HeaderName,+T)%3E-for-HeaderMap%3CT%3E" class="anchor">§</a><h3 class="code-header">impl&lt;T&gt; <a class="trait" href="https://doc.rust-lang.org/1.76.0/core/iter/traits/collect/trait.Extend.html" title="trait core::iter::traits::collect::Extend">Extend</a>&lt;(<a class="struct" href="struct.HeaderName.html" title="struct hyper::header::HeaderName">HeaderName</a>, T)&gt; for <a class="struct" href="struct.HeaderMap.html" title="struct hyper::header::HeaderMap">HeaderMap</a>&lt;T&gt;</h3></section></summary><div class="impl-items"><details class="toggle method-toggle" open><summary><section id="method.extend" class="method trait-impl"><a class="src rightside" href="../../src/http/header/map.rs.html#1944">source</a><a href="#method.extend" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.76.0/core/iter/traits/collect/trait.Extend.html#tymethod.extend" class="fn">extend</a>&lt;I&gt;(&amp;mut self, iter: I)<div class="where">where
I: <a class="trait" href="https://doc.rust-lang.org/1.76.0/core/iter/traits/collect/trait.IntoIterator.html" title="trait core::iter::traits::collect::IntoIterator">IntoIterator</a>&lt;Item = (<a class="struct" href="struct.HeaderName.html" title="struct hyper::header::HeaderName">HeaderName</a>, T)&gt;,</div></h4></section></summary><div class='docblock'>Extends a collection with the contents of an iterator. <a href="https://doc.rust-lang.org/1.76.0/core/iter/traits/collect/trait.Extend.html#tymethod.extend">Read more</a></div></details><details class="toggle method-toggle" open><summary><section id="method.extend_one" class="method trait-impl"><a class="src rightside" href="https://doc.rust-lang.org/1.76.0/src/core/iter/traits/collect.rs.html#376">source</a><a href="#method.extend_one" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.76.0/core/iter/traits/collect/trait.Extend.html#method.extend_one" class="fn">extend_one</a>(&amp;mut self, item: A)</h4></section></summary><span class="item-info"><div class="stab unstable"><span class="emoji">🔬</span><span>This is a nightly-only experimental API. (<code>extend_one</code>)</span></div></span><div class='docblock'>Extends a collection with exactly one element.</div></details><details class="toggle method-toggle" open><summary><section id="method.extend_reserve" class="method trait-impl"><a class="src rightside" href="https://doc.rust-lang.org/1.76.0/src/core/iter/traits/collect.rs.html#384">source</a><a href="#method.extend_reserve" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.76.0/core/iter/traits/collect/trait.Extend.html#method.extend_reserve" class="fn">extend_reserve</a>(&amp;mut self, additional: <a class="primitive" href="https://doc.rust-lang.org/1.76.0/std/primitive.usize.html">usize</a>)</h4></section></summary><span class="item-info"><div class="stab unstable"><span class="emoji">🔬</span><span>This is a nightly-only experimental API. (<code>extend_one</code>)</span></div></span><div class='docblock'>Reserves capacity in a collection for the given number of additional elements. <a href="https://doc.rust-lang.org/1.76.0/core/iter/traits/collect/trait.Extend.html#method.extend_reserve">Read more</a></div></details></div></details><details class="toggle implementors-toggle" open><summary><section id="impl-Extend%3C(Option%3CHeaderName%3E,+T)%3E-for-HeaderMap%3CT%3E" class="impl"><a class="src rightside" href="../../src/http/header/map.rs.html#1863">source</a><a href="#impl-Extend%3C(Option%3CHeaderName%3E,+T)%3E-for-HeaderMap%3CT%3E" class="anchor">§</a><h3 class="code-header">impl&lt;T&gt; <a class="trait" href="https://doc.rust-lang.org/1.76.0/core/iter/traits/collect/trait.Extend.html" title="trait core::iter::traits::collect::Extend">Extend</a>&lt;(<a class="enum" href="https://doc.rust-lang.org/1.76.0/core/option/enum.Option.html" title="enum core::option::Option">Option</a>&lt;<a class="struct" href="struct.HeaderName.html" title="struct hyper::header::HeaderName">HeaderName</a>&gt;, T)&gt; for <a class="struct" href="struct.HeaderMap.html" title="struct hyper::header::HeaderMap">HeaderMap</a>&lt;T&gt;</h3></section></summary><div class="impl-items"><details class="toggle method-toggle" open><summary><section id="method.extend-1" class="method trait-impl"><a class="src rightside" href="../../src/http/header/map.rs.html#1900">source</a><a href="#method.extend-1" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.76.0/core/iter/traits/collect/trait.Extend.html#tymethod.extend" class="fn">extend</a>&lt;I&gt;(&amp;mut self, iter: I)<div class="where">where
I: <a class="trait" href="https://doc.rust-lang.org/1.76.0/core/iter/traits/collect/trait.IntoIterator.html" title="trait core::iter::traits::collect::IntoIterator">IntoIterator</a>&lt;Item = (<a class="enum" href="https://doc.rust-lang.org/1.76.0/core/option/enum.Option.html" title="enum core::option::Option">Option</a>&lt;<a class="struct" href="struct.HeaderName.html" title="struct hyper::header::HeaderName">HeaderName</a>&gt;, T)&gt;,</div></h4></section></summary><div class="docblock"><p>Extend a <code>HeaderMap</code> with the contents of another <code>HeaderMap</code>.</p>
<p>This function expects the yielded items to follow the same structure as
<code>IntoIter</code>.</p>
<h5 id="panics-1"><a href="#panics-1">Panics</a></h5>
<p>This panics if the first yielded item does not have a <code>HeaderName</code>.</p>
<h5 id="examples-23"><a href="#examples-23">Examples</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">let </span><span class="kw-2">mut </span>map = HeaderMap::new();
map.insert(ACCEPT, <span class="string">"text/plain"</span>.parse().unwrap());
map.insert(HOST, <span class="string">"hello.world"</span>.parse().unwrap());
<span class="kw">let </span><span class="kw-2">mut </span>extra = HeaderMap::new();
extra.insert(HOST, <span class="string">"foo.bar"</span>.parse().unwrap());
extra.insert(COOKIE, <span class="string">"hello"</span>.parse().unwrap());
extra.append(COOKIE, <span class="string">"world"</span>.parse().unwrap());
map.extend(extra);
<span class="macro">assert_eq!</span>(map[<span class="string">"host"</span>], <span class="string">"foo.bar"</span>);
<span class="macro">assert_eq!</span>(map[<span class="string">"accept"</span>], <span class="string">"text/plain"</span>);
<span class="macro">assert_eq!</span>(map[<span class="string">"cookie"</span>], <span class="string">"hello"</span>);
<span class="kw">let </span>v = map.get_all(<span class="string">"host"</span>);
<span class="macro">assert_eq!</span>(<span class="number">1</span>, v.iter().count());
<span class="kw">let </span>v = map.get_all(<span class="string">"cookie"</span>);
<span class="macro">assert_eq!</span>(<span class="number">2</span>, v.iter().count());</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.extend_one-1" class="method trait-impl"><a class="src rightside" href="https://doc.rust-lang.org/1.76.0/src/core/iter/traits/collect.rs.html#376">source</a><a href="#method.extend_one-1" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.76.0/core/iter/traits/collect/trait.Extend.html#method.extend_one" class="fn">extend_one</a>(&amp;mut self, item: A)</h4></section></summary><span class="item-info"><div class="stab unstable"><span class="emoji">🔬</span><span>This is a nightly-only experimental API. (<code>extend_one</code>)</span></div></span><div class='docblock'>Extends a collection with exactly one element.</div></details><details class="toggle method-toggle" open><summary><section id="method.extend_reserve-1" class="method trait-impl"><a class="src rightside" href="https://doc.rust-lang.org/1.76.0/src/core/iter/traits/collect.rs.html#384">source</a><a href="#method.extend_reserve-1" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.76.0/core/iter/traits/collect/trait.Extend.html#method.extend_reserve" class="fn">extend_reserve</a>(&amp;mut self, additional: <a class="primitive" href="https://doc.rust-lang.org/1.76.0/std/primitive.usize.html">usize</a>)</h4></section></summary><span class="item-info"><div class="stab unstable"><span class="emoji">🔬</span><span>This is a nightly-only experimental API. (<code>extend_one</code>)</span></div></span><div class='docblock'>Reserves capacity in a collection for the given number of additional elements. <a href="https://doc.rust-lang.org/1.76.0/core/iter/traits/collect/trait.Extend.html#method.extend_reserve">Read more</a></div></details></div></details><details class="toggle implementors-toggle" open><summary><section id="impl-FromIterator%3C(HeaderName,+T)%3E-for-HeaderMap%3CT%3E" class="impl"><a class="src rightside" href="../../src/http/header/map.rs.html#1816">source</a><a href="#impl-FromIterator%3C(HeaderName,+T)%3E-for-HeaderMap%3CT%3E" class="anchor">§</a><h3 class="code-header">impl&lt;T&gt; <a class="trait" href="https://doc.rust-lang.org/1.76.0/core/iter/traits/collect/trait.FromIterator.html" title="trait core::iter::traits::collect::FromIterator">FromIterator</a>&lt;(<a class="struct" href="struct.HeaderName.html" title="struct hyper::header::HeaderName">HeaderName</a>, T)&gt; for <a class="struct" href="struct.HeaderMap.html" title="struct hyper::header::HeaderMap">HeaderMap</a>&lt;T&gt;</h3></section></summary><div class="impl-items"><details class="toggle method-toggle" open><summary><section id="method.from_iter" class="method trait-impl"><a class="src rightside" href="../../src/http/header/map.rs.html#1817-1819">source</a><a href="#method.from_iter" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.76.0/core/iter/traits/collect/trait.FromIterator.html#tymethod.from_iter" class="fn">from_iter</a>&lt;I&gt;(iter: I) -&gt; <a class="struct" href="struct.HeaderMap.html" title="struct hyper::header::HeaderMap">HeaderMap</a>&lt;T&gt;<div class="where">where
I: <a class="trait" href="https://doc.rust-lang.org/1.76.0/core/iter/traits/collect/trait.IntoIterator.html" title="trait core::iter::traits::collect::IntoIterator">IntoIterator</a>&lt;Item = (<a class="struct" href="struct.HeaderName.html" title="struct hyper::header::HeaderName">HeaderName</a>, T)&gt;,</div></h4></section></summary><div class='docblock'>Creates a value from an iterator. <a href="https://doc.rust-lang.org/1.76.0/core/iter/traits/collect/trait.FromIterator.html#tymethod.from_iter">Read more</a></div></details></div></details><details class="toggle implementors-toggle" open><summary><section id="impl-Index%3CK%3E-for-HeaderMap%3CT%3E" class="impl"><a class="src rightside" href="../../src/http/header/map.rs.html#1990-1992">source</a><a href="#impl-Index%3CK%3E-for-HeaderMap%3CT%3E" class="anchor">§</a><h3 class="code-header">impl&lt;'a, K, T&gt; <a class="trait" href="https://doc.rust-lang.org/1.76.0/core/ops/index/trait.Index.html" title="trait core::ops::index::Index">Index</a>&lt;K&gt; for <a class="struct" href="struct.HeaderMap.html" title="struct hyper::header::HeaderMap">HeaderMap</a>&lt;T&gt;<div class="where">where
K: <a class="trait" href="trait.AsHeaderName.html" title="trait hyper::header::AsHeaderName">AsHeaderName</a>,</div></h3></section></summary><div class="impl-items"><details class="toggle method-toggle" open><summary><section id="method.index" class="method trait-impl"><a class="src rightside" href="../../src/http/header/map.rs.html#1999">source</a><a href="#method.index" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.76.0/core/ops/index/trait.Index.html#tymethod.index" class="fn">index</a>(&amp;self, index: K) -&gt; <a class="primitive" href="https://doc.rust-lang.org/1.76.0/std/primitive.reference.html">&amp;T</a></h4></section></summary><div class="docblock"><h5 id="panics-2"><a href="#panics-2">Panics</a></h5>
<p>Using the index operator will cause a panic if the header you’re querying isn’t set.</p>
</div></details><details class="toggle" open><summary><section id="associatedtype.Output" class="associatedtype trait-impl"><a href="#associatedtype.Output" class="anchor">§</a><h4 class="code-header">type <a href="https://doc.rust-lang.org/1.76.0/core/ops/index/trait.Index.html#associatedtype.Output" class="associatedtype">Output</a> = T</h4></section></summary><div class='docblock'>The returned type after indexing.</div></details></div></details><details class="toggle implementors-toggle" open><summary><section id="impl-IntoIterator-for-%26HeaderMap%3CT%3E" class="impl"><a class="src rightside" href="../../src/http/header/map.rs.html#1736">source</a><a href="#impl-IntoIterator-for-%26HeaderMap%3CT%3E" class="anchor">§</a><h3 class="code-header">impl&lt;'a, T&gt; <a class="trait" href="https://doc.rust-lang.org/1.76.0/core/iter/traits/collect/trait.IntoIterator.html" title="trait core::iter::traits::collect::IntoIterator">IntoIterator</a> for &amp;'a <a class="struct" href="struct.HeaderMap.html" title="struct hyper::header::HeaderMap">HeaderMap</a>&lt;T&gt;</h3></section></summary><div class="impl-items"><details class="toggle" open><summary><section id="associatedtype.Item-1" class="associatedtype trait-impl"><a href="#associatedtype.Item-1" class="anchor">§</a><h4 class="code-header">type <a href="https://doc.rust-lang.org/1.76.0/core/iter/traits/collect/trait.IntoIterator.html#associatedtype.Item" class="associatedtype">Item</a> = (&amp;'a <a class="struct" href="struct.HeaderName.html" title="struct hyper::header::HeaderName">HeaderName</a>, <a class="primitive" href="https://doc.rust-lang.org/1.76.0/std/primitive.reference.html">&amp;'a T</a>)</h4></section></summary><div class='docblock'>The type of the elements being iterated over.</div></details><details class="toggle" open><summary><section id="associatedtype.IntoIter-1" class="associatedtype trait-impl"><a href="#associatedtype.IntoIter-1" class="anchor">§</a><h4 class="code-header">type <a href="https://doc.rust-lang.org/1.76.0/core/iter/traits/collect/trait.IntoIterator.html#associatedtype.IntoIter" class="associatedtype">IntoIter</a> = <a class="struct" href="struct.Iter.html" title="struct hyper::header::Iter">Iter</a>&lt;'a, T&gt;</h4></section></summary><div class='docblock'>Which kind of iterator are we turning this into?</div></details><details class="toggle method-toggle" open><summary><section id="method.into_iter-1" class="method trait-impl"><a class="src rightside" href="../../src/http/header/map.rs.html#1740">source</a><a href="#method.into_iter-1" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.76.0/core/iter/traits/collect/trait.IntoIterator.html#tymethod.into_iter" class="fn">into_iter</a>(self) -&gt; <a class="struct" href="struct.Iter.html" title="struct hyper::header::Iter">Iter</a>&lt;'a, T&gt; <a href="#" class="tooltip" data-notable-ty="Iter&lt;&#39;a, T&gt;">ⓘ</a></h4></section></summary><div class='docblock'>Creates an iterator from a value. <a href="https://doc.rust-lang.org/1.76.0/core/iter/traits/collect/trait.IntoIterator.html#tymethod.into_iter">Read more</a></div></details></div></details><details class="toggle implementors-toggle" open><summary><section id="impl-IntoIterator-for-%26mut+HeaderMap%3CT%3E" class="impl"><a class="src rightside" href="../../src/http/header/map.rs.html#1745">source</a><a href="#impl-IntoIterator-for-%26mut+HeaderMap%3CT%3E" class="anchor">§</a><h3 class="code-header">impl&lt;'a, T&gt; <a class="trait" href="https://doc.rust-lang.org/1.76.0/core/iter/traits/collect/trait.IntoIterator.html" title="trait core::iter::traits::collect::IntoIterator">IntoIterator</a> for &amp;'a mut <a class="struct" href="struct.HeaderMap.html" title="struct hyper::header::HeaderMap">HeaderMap</a>&lt;T&gt;</h3></section></summary><div class="impl-items"><details class="toggle" open><summary><section id="associatedtype.Item-2" class="associatedtype trait-impl"><a href="#associatedtype.Item-2" class="anchor">§</a><h4 class="code-header">type <a href="https://doc.rust-lang.org/1.76.0/core/iter/traits/collect/trait.IntoIterator.html#associatedtype.Item" class="associatedtype">Item</a> = (&amp;'a <a class="struct" href="struct.HeaderName.html" title="struct hyper::header::HeaderName">HeaderName</a>, <a class="primitive" href="https://doc.rust-lang.org/1.76.0/std/primitive.reference.html">&amp;'a mut T</a>)</h4></section></summary><div class='docblock'>The type of the elements being iterated over.</div></details><details class="toggle" open><summary><section id="associatedtype.IntoIter-2" class="associatedtype trait-impl"><a href="#associatedtype.IntoIter-2" class="anchor">§</a><h4 class="code-header">type <a href="https://doc.rust-lang.org/1.76.0/core/iter/traits/collect/trait.IntoIterator.html#associatedtype.IntoIter" class="associatedtype">IntoIter</a> = <a class="struct" href="struct.IterMut.html" title="struct hyper::header::IterMut">IterMut</a>&lt;'a, T&gt;</h4></section></summary><div class='docblock'>Which kind of iterator are we turning this into?</div></details><details class="toggle method-toggle" open><summary><section id="method.into_iter-2" class="method trait-impl"><a class="src rightside" href="../../src/http/header/map.rs.html#1749">source</a><a href="#method.into_iter-2" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.76.0/core/iter/traits/collect/trait.IntoIterator.html#tymethod.into_iter" class="fn">into_iter</a>(self) -&gt; <a class="struct" href="struct.IterMut.html" title="struct hyper::header::IterMut">IterMut</a>&lt;'a, T&gt; <a href="#" class="tooltip" data-notable-ty="IterMut&lt;&#39;a, T&gt;">ⓘ</a></h4></section></summary><div class='docblock'>Creates an iterator from a value. <a href="https://doc.rust-lang.org/1.76.0/core/iter/traits/collect/trait.IntoIterator.html#tymethod.into_iter">Read more</a></div></details></div></details><details class="toggle implementors-toggle" open><summary><section id="impl-IntoIterator-for-HeaderMap%3CT%3E" class="impl"><a class="src rightside" href="../../src/http/header/map.rs.html#1754">source</a><a href="#impl-IntoIterator-for-HeaderMap%3CT%3E" class="anchor">§</a><h3 class="code-header">impl&lt;T&gt; <a class="trait" href="https://doc.rust-lang.org/1.76.0/core/iter/traits/collect/trait.IntoIterator.html" title="trait core::iter::traits::collect::IntoIterator">IntoIterator</a> for <a class="struct" href="struct.HeaderMap.html" title="struct hyper::header::HeaderMap">HeaderMap</a>&lt;T&gt;</h3></section></summary><div class="impl-items"><details class="toggle method-toggle" open><summary><section id="method.into_iter" class="method trait-impl"><a class="src rightside" href="../../src/http/header/map.rs.html#1807">source</a><a href="#method.into_iter" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.76.0/core/iter/traits/collect/trait.IntoIterator.html#tymethod.into_iter" class="fn">into_iter</a>(self) -&gt; <a class="struct" href="struct.IntoIter.html" title="struct hyper::header::IntoIter">IntoIter</a>&lt;T&gt; <a href="#" class="tooltip" data-notable-ty="IntoIter&lt;T&gt;">ⓘ</a></h4></section></summary><div class="docblock"><p>Creates a consuming iterator, that is, one that moves keys and values
out of the map in arbitrary order. The map cannot be used after calling
this.</p>
<p>For each yielded item that has <code>None</code> provided for the <code>HeaderName</code>,
then the associated header name is the same as that of the previously
yielded item. The first yielded item will have <code>HeaderName</code> set.</p>
<h5 id="examples-24"><a href="#examples-24">Examples</a></h5>
<p>Basic usage.</p>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">let </span><span class="kw-2">mut </span>map = HeaderMap::new();
map.insert(header::CONTENT_LENGTH, <span class="string">"123"</span>.parse().unwrap());
map.insert(header::CONTENT_TYPE, <span class="string">"json"</span>.parse().unwrap());
<span class="kw">let </span><span class="kw-2">mut </span>iter = map.into_iter();
<span class="macro">assert_eq!</span>(iter.next(), <span class="prelude-val">Some</span>((<span class="prelude-val">Some</span>(header::CONTENT_LENGTH), <span class="string">"123"</span>.parse().unwrap())));
<span class="macro">assert_eq!</span>(iter.next(), <span class="prelude-val">Some</span>((<span class="prelude-val">Some</span>(header::CONTENT_TYPE), <span class="string">"json"</span>.parse().unwrap())));
<span class="macro">assert!</span>(iter.next().is_none());</code></pre></div>
<p>Multiple values per key.</p>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">let </span><span class="kw-2">mut </span>map = HeaderMap::new();
map.append(header::CONTENT_LENGTH, <span class="string">"123"</span>.parse().unwrap());
map.append(header::CONTENT_LENGTH, <span class="string">"456"</span>.parse().unwrap());
map.append(header::CONTENT_TYPE, <span class="string">"json"</span>.parse().unwrap());
map.append(header::CONTENT_TYPE, <span class="string">"html"</span>.parse().unwrap());
map.append(header::CONTENT_TYPE, <span class="string">"xml"</span>.parse().unwrap());
<span class="kw">let </span><span class="kw-2">mut </span>iter = map.into_iter();
<span class="macro">assert_eq!</span>(iter.next(), <span class="prelude-val">Some</span>((<span class="prelude-val">Some</span>(header::CONTENT_LENGTH), <span class="string">"123"</span>.parse().unwrap())));
<span class="macro">assert_eq!</span>(iter.next(), <span class="prelude-val">Some</span>((<span class="prelude-val">None</span>, <span class="string">"456"</span>.parse().unwrap())));
<span class="macro">assert_eq!</span>(iter.next(), <span class="prelude-val">Some</span>((<span class="prelude-val">Some</span>(header::CONTENT_TYPE), <span class="string">"json"</span>.parse().unwrap())));
<span class="macro">assert_eq!</span>(iter.next(), <span class="prelude-val">Some</span>((<span class="prelude-val">None</span>, <span class="string">"html"</span>.parse().unwrap())));
<span class="macro">assert_eq!</span>(iter.next(), <span class="prelude-val">Some</span>((<span class="prelude-val">None</span>, <span class="string">"xml"</span>.parse().unwrap())));
<span class="macro">assert!</span>(iter.next().is_none());</code></pre></div>
</div></details><details class="toggle" open><summary><section id="associatedtype.Item" class="associatedtype trait-impl"><a href="#associatedtype.Item" class="anchor">§</a><h4 class="code-header">type <a href="https://doc.rust-lang.org/1.76.0/core/iter/traits/collect/trait.IntoIterator.html#associatedtype.Item" class="associatedtype">Item</a> = (<a class="enum" href="https://doc.rust-lang.org/1.76.0/core/option/enum.Option.html" title="enum core::option::Option">Option</a>&lt;<a class="struct" href="struct.HeaderName.html" title="struct hyper::header::HeaderName">HeaderName</a>&gt;, T)</h4></section></summary><div class='docblock'>The type of the elements being iterated over.</div></details><details class="toggle" open><summary><section id="associatedtype.IntoIter" class="associatedtype trait-impl"><a href="#associatedtype.IntoIter" class="anchor">§</a><h4 class="code-header">type <a href="https://doc.rust-lang.org/1.76.0/core/iter/traits/collect/trait.IntoIterator.html#associatedtype.IntoIter" class="associatedtype">IntoIter</a> = <a class="struct" href="struct.IntoIter.html" title="struct hyper::header::IntoIter">IntoIter</a>&lt;T&gt;</h4></section></summary><div class='docblock'>Which kind of iterator are we turning this into?</div></details></div></details><details class="toggle implementors-toggle" open><summary><section id="impl-PartialEq-for-HeaderMap%3CT%3E" class="impl"><a class="src rightside" href="../../src/http/header/map.rs.html#1965">source</a><a href="#impl-PartialEq-for-HeaderMap%3CT%3E" class="anchor">§</a><h3 class="code-header">impl&lt;T&gt; <a class="trait" href="https://doc.rust-lang.org/1.76.0/core/cmp/trait.PartialEq.html" title="trait core::cmp::PartialEq">PartialEq</a> for <a class="struct" href="struct.HeaderMap.html" title="struct hyper::header::HeaderMap">HeaderMap</a>&lt;T&gt;<div class="where">where
T: <a class="trait" href="https://doc.rust-lang.org/1.76.0/core/cmp/trait.PartialEq.html" title="trait core::cmp::PartialEq">PartialEq</a>,</div></h3></section></summary><div class="impl-items"><details class="toggle method-toggle" open><summary><section id="method.eq" class="method trait-impl"><a class="src rightside" href="../../src/http/header/map.rs.html#1966">source</a><a href="#method.eq" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.76.0/core/cmp/trait.PartialEq.html#tymethod.eq" class="fn">eq</a>(&amp;self, other: &amp;<a class="struct" href="struct.HeaderMap.html" title="struct hyper::header::HeaderMap">HeaderMap</a>&lt;T&gt;) -&gt; <a class="primitive" href="https://doc.rust-lang.org/1.76.0/std/primitive.bool.html">bool</a></h4></section></summary><div class='docblock'>This method tests for <code>self</code> and <code>other</code> values to be equal, and is used
by <code>==</code>.</div></details><details class="toggle method-toggle" open><summary><section id="method.ne" class="method trait-impl"><span class="rightside"><span class="since" title="Stable since Rust version 1.0.0">1.0.0</span> · <a class="src" href="https://doc.rust-lang.org/1.76.0/src/core/cmp.rs.html#242">source</a></span><a href="#method.ne" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.76.0/core/cmp/trait.PartialEq.html#method.ne" class="fn">ne</a>(&amp;self, other: <a class="primitive" href="https://doc.rust-lang.org/1.76.0/std/primitive.reference.html">&amp;Rhs</a>) -&gt; <a class="primitive" href="https://doc.rust-lang.org/1.76.0/std/primitive.bool.html">bool</a></h4></section></summary><div class='docblock'>This method tests for <code>!=</code>. The default implementation is almost always
sufficient, and should not be overridden without very good reason.</div></details></div></details><details class="toggle implementors-toggle" open><summary><section id="impl-TryFrom%3C%26HashMap%3CK,+V%3E%3E-for-HeaderMap%3CT%3E" class="impl"><a class="src rightside" href="../../src/http/header/map.rs.html#1842-1848">source</a><a href="#impl-TryFrom%3C%26HashMap%3CK,+V%3E%3E-for-HeaderMap%3CT%3E" class="anchor">§</a><h3 class="code-header">impl&lt;'a, K, V, T&gt; <a class="trait" href="https://doc.rust-lang.org/1.76.0/core/convert/trait.TryFrom.html" title="trait core::convert::TryFrom">TryFrom</a>&lt;&amp;'a <a class="struct" href="https://doc.rust-lang.org/1.76.0/std/collections/hash/map/struct.HashMap.html" title="struct std::collections::hash::map::HashMap">HashMap</a>&lt;K, V&gt;&gt; for <a class="struct" href="struct.HeaderMap.html" title="struct hyper::header::HeaderMap">HeaderMap</a>&lt;T&gt;<div class="where">where
K: <a class="trait" href="https://doc.rust-lang.org/1.76.0/core/cmp/trait.Eq.html" title="trait core::cmp::Eq">Eq</a> + <a class="trait" href="https://doc.rust-lang.org/1.76.0/core/hash/trait.Hash.html" title="trait core::hash::Hash">Hash</a>,
<a class="struct" href="struct.HeaderName.html" title="struct hyper::header::HeaderName">HeaderName</a>: <a class="trait" href="https://doc.rust-lang.org/1.76.0/core/convert/trait.TryFrom.html" title="trait core::convert::TryFrom">TryFrom</a>&lt;<a class="primitive" href="https://doc.rust-lang.org/1.76.0/std/primitive.reference.html">&amp;'a K</a>&gt;,
&lt;<a class="struct" href="struct.HeaderName.html" title="struct hyper::header::HeaderName">HeaderName</a> as <a class="trait" href="https://doc.rust-lang.org/1.76.0/core/convert/trait.TryFrom.html" title="trait core::convert::TryFrom">TryFrom</a>&lt;<a class="primitive" href="https://doc.rust-lang.org/1.76.0/std/primitive.reference.html">&amp;'a K</a>&gt;&gt;::<a class="associatedtype" href="https://doc.rust-lang.org/1.76.0/core/convert/trait.TryFrom.html#associatedtype.Error" title="type core::convert::TryFrom::Error">Error</a>: <a class="trait" href="https://doc.rust-lang.org/1.76.0/core/convert/trait.Into.html" title="trait core::convert::Into">Into</a>&lt;<a class="struct" href="../../http/error/struct.Error.html" title="struct http::error::Error">Error</a>&gt;,
T: <a class="trait" href="https://doc.rust-lang.org/1.76.0/core/convert/trait.TryFrom.html" title="trait core::convert::TryFrom">TryFrom</a>&lt;<a class="primitive" href="https://doc.rust-lang.org/1.76.0/std/primitive.reference.html">&amp;'a V</a>&gt;,
&lt;T as <a class="trait" href="https://doc.rust-lang.org/1.76.0/core/convert/trait.TryFrom.html" title="trait core::convert::TryFrom">TryFrom</a>&lt;<a class="primitive" href="https://doc.rust-lang.org/1.76.0/std/primitive.reference.html">&amp;'a V</a>&gt;&gt;::<a class="associatedtype" href="https://doc.rust-lang.org/1.76.0/core/convert/trait.TryFrom.html#associatedtype.Error" title="type core::convert::TryFrom::Error">Error</a>: <a class="trait" href="https://doc.rust-lang.org/1.76.0/core/convert/trait.Into.html" title="trait core::convert::Into">Into</a>&lt;<a class="struct" href="../../http/error/struct.Error.html" title="struct http::error::Error">Error</a>&gt;,</div></h3></section></summary><div class="docblock"><p>Try to convert a <code>HashMap</code> into a <code>HeaderMap</code>.</p>
<h4 id="examples-25"><a href="#examples-25">Examples</a></h4>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>std::collections::HashMap;
<span class="kw">use </span>std::convert::TryInto;
<span class="kw">use </span>http::HeaderMap;
<span class="kw">let </span><span class="kw-2">mut </span>map = HashMap::new();
map.insert(<span class="string">"X-Custom-Header"</span>.to_string(), <span class="string">"my value"</span>.to_string());
<span class="kw">let </span>headers: HeaderMap = (<span class="kw-2">&amp;</span>map).try_into().expect(<span class="string">"valid headers"</span>);
<span class="macro">assert_eq!</span>(headers[<span class="string">"X-Custom-Header"</span>], <span class="string">"my value"</span>);</code></pre></div>
</div><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.76.0/core/convert/trait.TryFrom.html#associatedtype.Error" class="associatedtype">Error</a> = <a class="struct" href="../../http/error/struct.Error.html" title="struct http::error::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_from" class="method trait-impl"><a class="src rightside" href="../../src/http/header/map.rs.html#1852">source</a><a href="#method.try_from" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.76.0/core/convert/trait.TryFrom.html#tymethod.try_from" class="fn">try_from</a>(
c: &amp;'a <a class="struct" href="https://doc.rust-lang.org/1.76.0/std/collections/hash/map/struct.HashMap.html" title="struct std::collections::hash::map::HashMap">HashMap</a>&lt;K, V&gt;
) -&gt; <a class="enum" href="https://doc.rust-lang.org/1.76.0/core/result/enum.Result.html" title="enum core::result::Result">Result</a>&lt;<a class="struct" href="struct.HeaderMap.html" title="struct hyper::header::HeaderMap">HeaderMap</a>&lt;T&gt;, &lt;<a class="struct" href="struct.HeaderMap.html" title="struct hyper::header::HeaderMap">HeaderMap</a>&lt;T&gt; as <a class="trait" href="https://doc.rust-lang.org/1.76.0/core/convert/trait.TryFrom.html" title="trait core::convert::TryFrom">TryFrom</a>&lt;&amp;'a <a class="struct" href="https://doc.rust-lang.org/1.76.0/std/collections/hash/map/struct.HashMap.html" title="struct std::collections::hash::map::HashMap">HashMap</a>&lt;K, V&gt;&gt;&gt;::<a class="associatedtype" href="https://doc.rust-lang.org/1.76.0/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><section id="impl-Eq-for-HeaderMap%3CT%3E" class="impl"><a class="src rightside" href="../../src/http/header/map.rs.html#1976">source</a><a href="#impl-Eq-for-HeaderMap%3CT%3E" class="anchor">§</a><h3 class="code-header">impl&lt;T&gt; <a class="trait" href="https://doc.rust-lang.org/1.76.0/core/cmp/trait.Eq.html" title="trait core::cmp::Eq">Eq</a> for <a class="struct" href="struct.HeaderMap.html" title="struct hyper::header::HeaderMap">HeaderMap</a>&lt;T&gt;<div class="where">where
T: <a class="trait" href="https://doc.rust-lang.org/1.76.0/core/cmp/trait.Eq.html" title="trait core::cmp::Eq">Eq</a>,</div></h3></section></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-HeaderMap%3CT%3E" class="impl"><a href="#impl-RefUnwindSafe-for-HeaderMap%3CT%3E" class="anchor">§</a><h3 class="code-header">impl&lt;T&gt; <a class="trait" href="https://doc.rust-lang.org/1.76.0/core/panic/unwind_safe/trait.RefUnwindSafe.html" title="trait core::panic::unwind_safe::RefUnwindSafe">RefUnwindSafe</a> for <a class="struct" href="struct.HeaderMap.html" title="struct hyper::header::HeaderMap">HeaderMap</a>&lt;T&gt;<div class="where">where
T: <a class="trait" href="https://doc.rust-lang.org/1.76.0/core/panic/unwind_safe/trait.RefUnwindSafe.html" title="trait core::panic::unwind_safe::RefUnwindSafe">RefUnwindSafe</a>,</div></h3></section><section id="impl-Send-for-HeaderMap%3CT%3E" class="impl"><a href="#impl-Send-for-HeaderMap%3CT%3E" class="anchor">§</a><h3 class="code-header">impl&lt;T&gt; <a class="trait" href="https://doc.rust-lang.org/1.76.0/core/marker/trait.Send.html" title="trait core::marker::Send">Send</a> for <a class="struct" href="struct.HeaderMap.html" title="struct hyper::header::HeaderMap">HeaderMap</a>&lt;T&gt;<div class="where">where
T: <a class="trait" href="https://doc.rust-lang.org/1.76.0/core/marker/trait.Send.html" title="trait core::marker::Send">Send</a>,</div></h3></section><section id="impl-Sync-for-HeaderMap%3CT%3E" class="impl"><a href="#impl-Sync-for-HeaderMap%3CT%3E" class="anchor">§</a><h3 class="code-header">impl&lt;T&gt; <a class="trait" href="https://doc.rust-lang.org/1.76.0/core/marker/trait.Sync.html" title="trait core::marker::Sync">Sync</a> for <a class="struct" href="struct.HeaderMap.html" title="struct hyper::header::HeaderMap">HeaderMap</a>&lt;T&gt;<div class="where">where
T: <a class="trait" href="https://doc.rust-lang.org/1.76.0/core/marker/trait.Sync.html" title="trait core::marker::Sync">Sync</a>,</div></h3></section><section id="impl-Unpin-for-HeaderMap%3CT%3E" class="impl"><a href="#impl-Unpin-for-HeaderMap%3CT%3E" class="anchor">§</a><h3 class="code-header">impl&lt;T&gt; <a class="trait" href="https://doc.rust-lang.org/1.76.0/core/marker/trait.Unpin.html" title="trait core::marker::Unpin">Unpin</a> for <a class="struct" href="struct.HeaderMap.html" title="struct hyper::header::HeaderMap">HeaderMap</a>&lt;T&gt;<div class="where">where
T: <a class="trait" href="https://doc.rust-lang.org/1.76.0/core/marker/trait.Unpin.html" title="trait core::marker::Unpin">Unpin</a>,</div></h3></section><section id="impl-UnwindSafe-for-HeaderMap%3CT%3E" class="impl"><a href="#impl-UnwindSafe-for-HeaderMap%3CT%3E" class="anchor">§</a><h3 class="code-header">impl&lt;T&gt; <a class="trait" href="https://doc.rust-lang.org/1.76.0/core/panic/unwind_safe/trait.UnwindSafe.html" title="trait core::panic::unwind_safe::UnwindSafe">UnwindSafe</a> for <a class="struct" href="struct.HeaderMap.html" title="struct hyper::header::HeaderMap">HeaderMap</a>&lt;T&gt;<div class="where">where
T: <a class="trait" href="https://doc.rust-lang.org/1.76.0/core/panic/unwind_safe/trait.UnwindSafe.html" title="trait core::panic::unwind_safe::UnwindSafe">UnwindSafe</a>,</div></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.76.0/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.76.0/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.76.0/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.76.0/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.76.0/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.76.0/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.76.0/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.76.0/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.76.0/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.76.0/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.76.0/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.76.0/core/borrow/trait.Borrow.html#tymethod.borrow" class="fn">borrow</a>(&amp;self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/1.76.0/std/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.76.0/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.76.0/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.76.0/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.76.0/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.76.0/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.76.0/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.76.0/std/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.76.0/core/borrow/trait.BorrowMut.html#tymethod.borrow_mut">Read more</a></div></details></div></details><details class="toggle implementors-toggle"><summary><section id="impl-Equivalent%3CK%3E-for-Q" class="impl"><a class="src rightside" href="../../src/indexmap/equivalent.rs.html#18-21">source</a><a href="#impl-Equivalent%3CK%3E-for-Q" class="anchor">§</a><h3 class="code-header">impl&lt;Q, K&gt; <a class="trait" href="../../indexmap/equivalent/trait.Equivalent.html" title="trait indexmap::equivalent::Equivalent">Equivalent</a>&lt;K&gt; for Q<div class="where">where
Q: <a class="trait" href="https://doc.rust-lang.org/1.76.0/core/cmp/trait.Eq.html" title="trait core::cmp::Eq">Eq</a> + ?<a class="trait" href="https://doc.rust-lang.org/1.76.0/core/marker/trait.Sized.html" title="trait core::marker::Sized">Sized</a>,
K: <a class="trait" href="https://doc.rust-lang.org/1.76.0/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.76.0/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.equivalent" class="method trait-impl"><a class="src rightside" href="../../src/indexmap/equivalent.rs.html#24">source</a><a href="#method.equivalent" class="anchor">§</a><h4 class="code-header">fn <a href="../../indexmap/equivalent/trait.Equivalent.html#tymethod.equivalent" class="fn">equivalent</a>(&amp;self, key: <a class="primitive" href="https://doc.rust-lang.org/1.76.0/std/primitive.reference.html">&amp;K</a>) -&gt; <a class="primitive" href="https://doc.rust-lang.org/1.76.0/std/primitive.bool.html">bool</a></h4></section></summary><div class='docblock'>Compare self to <code>key</code> and return <code>true</code> if they are equal.</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.76.0/src/core/convert/mod.rs.html#763">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.76.0/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.76.0/src/core/convert/mod.rs.html#766">source</a><a href="#method.from" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.76.0/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-Instrument-for-T" class="impl"><a class="src rightside" href="../../src/tracing/instrument.rs.html#325">source</a><a href="#impl-Instrument-for-T" class="anchor">§</a><h3 class="code-header">impl&lt;T&gt; <a class="trait" href="../../tracing/instrument/trait.Instrument.html" title="trait tracing::instrument::Instrument">Instrument</a> for T</h3></section></summary><div class="impl-items"><details class="toggle method-toggle" open><summary><section id="method.instrument" class="method trait-impl"><a class="src rightside" href="../../src/tracing/instrument.rs.html#86">source</a><a href="#method.instrument" class="anchor">§</a><h4 class="code-header">fn <a href="../../tracing/instrument/trait.Instrument.html#method.instrument" class="fn">instrument</a>(self, span: <a class="struct" href="../../tracing/span/struct.Span.html" title="struct tracing::span::Span">Span</a>) -&gt; <a class="struct" href="../../tracing/instrument/struct.Instrumented.html" title="struct tracing::instrument::Instrumented">Instrumented</a>&lt;Self&gt;</h4></section></summary><div class='docblock'>Instruments this type with the provided <a href="../../tracing/span/struct.Span.html" title="struct tracing::span::Span"><code>Span</code></a>, returning an
<code>Instrumented</code> wrapper. <a href="../../tracing/instrument/trait.Instrument.html#method.instrument">Read more</a></div></details><details class="toggle method-toggle" open><summary><section id="method.in_current_span" class="method trait-impl"><a class="src rightside" href="../../src/tracing/instrument.rs.html#128">source</a><a href="#method.in_current_span" class="anchor">§</a><h4 class="code-header">fn <a href="../../tracing/instrument/trait.Instrument.html#method.in_current_span" class="fn">in_current_span</a>(self) -&gt; <a class="struct" href="../../tracing/instrument/struct.Instrumented.html" title="struct tracing::instrument::Instrumented">Instrumented</a>&lt;Self&gt;</h4></section></summary><div class='docblock'>Instruments this type with the <a href="../../tracing/span/struct.Span.html#method.current" title="associated function tracing::span::Span::current">current</a> <a href="../../tracing/span/struct.Span.html" title="struct tracing::span::Span"><code>Span</code></a>, returning an
<code>Instrumented</code> wrapper. <a href="../../tracing/instrument/trait.Instrument.html#method.in_current_span">Read more</a></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.76.0/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.76.0/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.76.0/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.76.0/src/core/convert/mod.rs.html#756">source</a><a href="#method.into" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.76.0/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.76.0/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-ToOwned-for-T" class="impl"><a class="src rightside" href="https://doc.rust-lang.org/1.76.0/src/alloc/borrow.rs.html#83-85">source</a><a href="#impl-ToOwned-for-T" class="anchor">§</a><h3 class="code-header">impl&lt;T&gt; <a class="trait" href="https://doc.rust-lang.org/1.76.0/alloc/borrow/trait.ToOwned.html" title="trait alloc::borrow::ToOwned">ToOwned</a> for T<div class="where">where
T: <a class="trait" href="https://doc.rust-lang.org/1.76.0/core/clone/trait.Clone.html" title="trait core::clone::Clone">Clone</a>,</div></h3></section></summary><div class="impl-items"><details class="toggle" open><summary><section id="associatedtype.Owned" class="associatedtype trait-impl"><a href="#associatedtype.Owned" class="anchor">§</a><h4 class="code-header">type <a href="https://doc.rust-lang.org/1.76.0/alloc/borrow/trait.ToOwned.html#associatedtype.Owned" class="associatedtype">Owned</a> = T</h4></section></summary><div class='docblock'>The resulting type after obtaining ownership.</div></details><details class="toggle method-toggle" open><summary><section id="method.to_owned" class="method trait-impl"><a class="src rightside" href="https://doc.rust-lang.org/1.76.0/src/alloc/borrow.rs.html#88">source</a><a href="#method.to_owned" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.76.0/alloc/borrow/trait.ToOwned.html#tymethod.to_owned" class="fn">to_owned</a>(&amp;self) -&gt; T</h4></section></summary><div class='docblock'>Creates owned data from borrowed data, usually by cloning. <a href="https://doc.rust-lang.org/1.76.0/alloc/borrow/trait.ToOwned.html#tymethod.to_owned">Read more</a></div></details><details class="toggle method-toggle" open><summary><section id="method.clone_into" class="method trait-impl"><a class="src rightside" href="https://doc.rust-lang.org/1.76.0/src/alloc/borrow.rs.html#92">source</a><a href="#method.clone_into" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.76.0/alloc/borrow/trait.ToOwned.html#method.clone_into" class="fn">clone_into</a>(&amp;self, target: <a class="primitive" href="https://doc.rust-lang.org/1.76.0/std/primitive.reference.html">&amp;mut T</a>)</h4></section></summary><div class='docblock'>Uses borrowed data to replace owned data, usually by cloning. <a href="https://doc.rust-lang.org/1.76.0/alloc/borrow/trait.ToOwned.html#method.clone_into">Read more</a></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.76.0/src/core/convert/mod.rs.html#803-805">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.76.0/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.76.0/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-2" class="associatedtype trait-impl"><a href="#associatedtype.Error-2" class="anchor">§</a><h4 class="code-header">type <a href="https://doc.rust-lang.org/1.76.0/core/convert/trait.TryFrom.html#associatedtype.Error" class="associatedtype">Error</a> = <a class="enum" href="https://doc.rust-lang.org/1.76.0/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-1" class="method trait-impl"><a class="src rightside" href="https://doc.rust-lang.org/1.76.0/src/core/convert/mod.rs.html#810">source</a><a href="#method.try_from-1" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.76.0/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.76.0/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.76.0/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.76.0/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.76.0/src/core/convert/mod.rs.html#788-790">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.76.0/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.76.0/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-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.76.0/core/convert/trait.TryInto.html#associatedtype.Error" class="associatedtype">Error</a> = &lt;U as <a class="trait" href="https://doc.rust-lang.org/1.76.0/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.76.0/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.76.0/src/core/convert/mod.rs.html#795">source</a><a href="#method.try_into" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.76.0/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.76.0/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.76.0/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.76.0/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-WithSubscriber-for-T" class="impl"><a class="src rightside" href="../../src/tracing/instrument.rs.html#393">source</a><a href="#impl-WithSubscriber-for-T" class="anchor">§</a><h3 class="code-header">impl&lt;T&gt; <a class="trait" href="../../tracing/instrument/trait.WithSubscriber.html" title="trait tracing::instrument::WithSubscriber">WithSubscriber</a> for T</h3></section></summary><div class="impl-items"><details class="toggle method-toggle" open><summary><section id="method.with_subscriber" class="method trait-impl"><a class="src rightside" href="../../src/tracing/instrument.rs.html#176-178">source</a><a href="#method.with_subscriber" class="anchor">§</a><h4 class="code-header">fn <a href="../../tracing/instrument/trait.WithSubscriber.html#method.with_subscriber" class="fn">with_subscriber</a>&lt;S&gt;(self, subscriber: S) -&gt; <a class="struct" href="../../tracing/instrument/struct.WithDispatch.html" title="struct tracing::instrument::WithDispatch">WithDispatch</a>&lt;Self&gt;<div class="where">where
S: <a class="trait" href="https://doc.rust-lang.org/1.76.0/core/convert/trait.Into.html" title="trait core::convert::Into">Into</a>&lt;<a class="struct" href="../../tracing_core/dispatcher/struct.Dispatch.html" title="struct tracing_core::dispatcher::Dispatch">Dispatch</a>&gt;,</div></h4></section></summary><div class='docblock'>Attaches the provided <a href="../../tracing_core/subscriber/trait.Subscriber.html" title="trait tracing_core::subscriber::Subscriber"><code>Subscriber</code></a> to this type, returning a
<a href="../../tracing/instrument/struct.WithDispatch.html" title="struct tracing::instrument::WithDispatch"><code>WithDispatch</code></a> wrapper. <a href="../../tracing/instrument/trait.WithSubscriber.html#method.with_subscriber">Read more</a></div></details><details class="toggle method-toggle" open><summary><section id="method.with_current_subscriber" class="method trait-impl"><a class="src rightside" href="../../src/tracing/instrument.rs.html#228">source</a><a href="#method.with_current_subscriber" class="anchor">§</a><h4 class="code-header">fn <a href="../../tracing/instrument/trait.WithSubscriber.html#method.with_current_subscriber" class="fn">with_current_subscriber</a>(self) -&gt; <a class="struct" href="../../tracing/instrument/struct.WithDispatch.html" title="struct tracing::instrument::WithDispatch">WithDispatch</a>&lt;Self&gt;</h4></section></summary><div class='docblock'>Attaches the current <a href="../../tracing/dispatcher/index.html#setting-the-default-subscriber" title="mod tracing::dispatcher">default</a> <a href="../../tracing_core/subscriber/trait.Subscriber.html" title="trait tracing_core::subscriber::Subscriber"><code>Subscriber</code></a> to this type, returning a
<a href="../../tracing/instrument/struct.WithDispatch.html" title="struct tracing::instrument::WithDispatch"><code>WithDispatch</code></a> wrapper. <a href="../../tracing/instrument/trait.WithSubscriber.html#method.with_current_subscriber">Read more</a></div></details></div></details></div><script type="text/json" id="notable-traits-data">{"Drain<'_, T>":"<h3>Notable traits for <code><a class=\"struct\" href=\"struct.Drain.html\" title=\"struct hyper::header::Drain\">Drain</a>&lt;'a, T&gt;</code></h3><pre><code><div class=\"where\">impl&lt;'a, T&gt; <a class=\"trait\" href=\"https://doc.rust-lang.org/1.76.0/core/iter/traits/iterator/trait.Iterator.html\" title=\"trait core::iter::traits::iterator::Iterator\">Iterator</a> for <a class=\"struct\" href=\"struct.Drain.html\" title=\"struct hyper::header::Drain\">Drain</a>&lt;'a, T&gt;</div><div class=\"where\"> type <a href=\"https://doc.rust-lang.org/1.76.0/core/iter/traits/iterator/trait.Iterator.html#associatedtype.Item\" class=\"associatedtype\">Item</a> = (<a class=\"enum\" href=\"https://doc.rust-lang.org/1.76.0/core/option/enum.Option.html\" title=\"enum core::option::Option\">Option</a>&lt;<a class=\"struct\" href=\"struct.HeaderName.html\" title=\"struct hyper::header::HeaderName\">HeaderName</a>&gt;, T);</div>","IntoIter<T>":"<h3>Notable traits for <code><a class=\"struct\" href=\"struct.IntoIter.html\" title=\"struct hyper::header::IntoIter\">IntoIter</a>&lt;T&gt;</code></h3><pre><code><div class=\"where\">impl&lt;T&gt; <a class=\"trait\" href=\"https://doc.rust-lang.org/1.76.0/core/iter/traits/iterator/trait.Iterator.html\" title=\"trait core::iter::traits::iterator::Iterator\">Iterator</a> for <a class=\"struct\" href=\"struct.IntoIter.html\" title=\"struct hyper::header::IntoIter\">IntoIter</a>&lt;T&gt;</div><div class=\"where\"> type <a href=\"https://doc.rust-lang.org/1.76.0/core/iter/traits/iterator/trait.Iterator.html#associatedtype.Item\" class=\"associatedtype\">Item</a> = (<a class=\"enum\" href=\"https://doc.rust-lang.org/1.76.0/core/option/enum.Option.html\" title=\"enum core::option::Option\">Option</a>&lt;<a class=\"struct\" href=\"struct.HeaderName.html\" title=\"struct hyper::header::HeaderName\">HeaderName</a>&gt;, T);</div>","Iter<'_, T>":"<h3>Notable traits for <code><a class=\"struct\" href=\"struct.Iter.html\" title=\"struct hyper::header::Iter\">Iter</a>&lt;'a, T&gt;</code></h3><pre><code><div class=\"where\">impl&lt;'a, T&gt; <a class=\"trait\" href=\"https://doc.rust-lang.org/1.76.0/core/iter/traits/iterator/trait.Iterator.html\" title=\"trait core::iter::traits::iterator::Iterator\">Iterator</a> for <a class=\"struct\" href=\"struct.Iter.html\" title=\"struct hyper::header::Iter\">Iter</a>&lt;'a, T&gt;</div><div class=\"where\"> type <a href=\"https://doc.rust-lang.org/1.76.0/core/iter/traits/iterator/trait.Iterator.html#associatedtype.Item\" class=\"associatedtype\">Item</a> = (&amp;'a <a class=\"struct\" href=\"struct.HeaderName.html\" title=\"struct hyper::header::HeaderName\">HeaderName</a>, <a class=\"primitive\" href=\"https://doc.rust-lang.org/1.76.0/std/primitive.reference.html\">&amp;'a T</a>);</div>","Iter<'a, T>":"<h3>Notable traits for <code><a class=\"struct\" href=\"struct.Iter.html\" title=\"struct hyper::header::Iter\">Iter</a>&lt;'a, T&gt;</code></h3><pre><code><div class=\"where\">impl&lt;'a, T&gt; <a class=\"trait\" href=\"https://doc.rust-lang.org/1.76.0/core/iter/traits/iterator/trait.Iterator.html\" title=\"trait core::iter::traits::iterator::Iterator\">Iterator</a> for <a class=\"struct\" href=\"struct.Iter.html\" title=\"struct hyper::header::Iter\">Iter</a>&lt;'a, T&gt;</div><div class=\"where\"> type <a href=\"https://doc.rust-lang.org/1.76.0/core/iter/traits/iterator/trait.Iterator.html#associatedtype.Item\" class=\"associatedtype\">Item</a> = (&amp;'a <a class=\"struct\" href=\"struct.HeaderName.html\" title=\"struct hyper::header::HeaderName\">HeaderName</a>, <a class=\"primitive\" href=\"https://doc.rust-lang.org/1.76.0/std/primitive.reference.html\">&amp;'a T</a>);</div>","IterMut<'_, T>":"<h3>Notable traits for <code><a class=\"struct\" href=\"struct.IterMut.html\" title=\"struct hyper::header::IterMut\">IterMut</a>&lt;'a, T&gt;</code></h3><pre><code><div class=\"where\">impl&lt;'a, T&gt; <a class=\"trait\" href=\"https://doc.rust-lang.org/1.76.0/core/iter/traits/iterator/trait.Iterator.html\" title=\"trait core::iter::traits::iterator::Iterator\">Iterator</a> for <a class=\"struct\" href=\"struct.IterMut.html\" title=\"struct hyper::header::IterMut\">IterMut</a>&lt;'a, T&gt;</div><div class=\"where\"> type <a href=\"https://doc.rust-lang.org/1.76.0/core/iter/traits/iterator/trait.Iterator.html#associatedtype.Item\" class=\"associatedtype\">Item</a> = (&amp;'a <a class=\"struct\" href=\"struct.HeaderName.html\" title=\"struct hyper::header::HeaderName\">HeaderName</a>, <a class=\"primitive\" href=\"https://doc.rust-lang.org/1.76.0/std/primitive.reference.html\">&amp;'a mut T</a>);</div>","IterMut<'a, T>":"<h3>Notable traits for <code><a class=\"struct\" href=\"struct.IterMut.html\" title=\"struct hyper::header::IterMut\">IterMut</a>&lt;'a, T&gt;</code></h3><pre><code><div class=\"where\">impl&lt;'a, T&gt; <a class=\"trait\" href=\"https://doc.rust-lang.org/1.76.0/core/iter/traits/iterator/trait.Iterator.html\" title=\"trait core::iter::traits::iterator::Iterator\">Iterator</a> for <a class=\"struct\" href=\"struct.IterMut.html\" title=\"struct hyper::header::IterMut\">IterMut</a>&lt;'a, T&gt;</div><div class=\"where\"> type <a href=\"https://doc.rust-lang.org/1.76.0/core/iter/traits/iterator/trait.Iterator.html#associatedtype.Item\" class=\"associatedtype\">Item</a> = (&amp;'a <a class=\"struct\" href=\"struct.HeaderName.html\" title=\"struct hyper::header::HeaderName\">HeaderName</a>, <a class=\"primitive\" href=\"https://doc.rust-lang.org/1.76.0/std/primitive.reference.html\">&amp;'a mut T</a>);</div>","Keys<'_, T>":"<h3>Notable traits for <code><a class=\"struct\" href=\"struct.Keys.html\" title=\"struct hyper::header::Keys\">Keys</a>&lt;'a, T&gt;</code></h3><pre><code><div class=\"where\">impl&lt;'a, T&gt; <a class=\"trait\" href=\"https://doc.rust-lang.org/1.76.0/core/iter/traits/iterator/trait.Iterator.html\" title=\"trait core::iter::traits::iterator::Iterator\">Iterator</a> for <a class=\"struct\" href=\"struct.Keys.html\" title=\"struct hyper::header::Keys\">Keys</a>&lt;'a, T&gt;</div><div class=\"where\"> type <a href=\"https://doc.rust-lang.org/1.76.0/core/iter/traits/iterator/trait.Iterator.html#associatedtype.Item\" class=\"associatedtype\">Item</a> = &amp;'a <a class=\"struct\" href=\"struct.HeaderName.html\" title=\"struct hyper::header::HeaderName\">HeaderName</a>;</div>","Values<'_, T>":"<h3>Notable traits for <code><a class=\"struct\" href=\"struct.Values.html\" title=\"struct hyper::header::Values\">Values</a>&lt;'a, T&gt;</code></h3><pre><code><div class=\"where\">impl&lt;'a, T&gt; <a class=\"trait\" href=\"https://doc.rust-lang.org/1.76.0/core/iter/traits/iterator/trait.Iterator.html\" title=\"trait core::iter::traits::iterator::Iterator\">Iterator</a> for <a class=\"struct\" href=\"struct.Values.html\" title=\"struct hyper::header::Values\">Values</a>&lt;'a, T&gt;</div><div class=\"where\"> type <a href=\"https://doc.rust-lang.org/1.76.0/core/iter/traits/iterator/trait.Iterator.html#associatedtype.Item\" class=\"associatedtype\">Item</a> = <a class=\"primitive\" href=\"https://doc.rust-lang.org/1.76.0/std/primitive.reference.html\">&amp;'a T</a>;</div>","ValuesMut<'_, T>":"<h3>Notable traits for <code><a class=\"struct\" href=\"struct.ValuesMut.html\" title=\"struct hyper::header::ValuesMut\">ValuesMut</a>&lt;'a, T&gt;</code></h3><pre><code><div class=\"where\">impl&lt;'a, T&gt; <a class=\"trait\" href=\"https://doc.rust-lang.org/1.76.0/core/iter/traits/iterator/trait.Iterator.html\" title=\"trait core::iter::traits::iterator::Iterator\">Iterator</a> for <a class=\"struct\" href=\"struct.ValuesMut.html\" title=\"struct hyper::header::ValuesMut\">ValuesMut</a>&lt;'a, T&gt;</div><div class=\"where\"> type <a href=\"https://doc.rust-lang.org/1.76.0/core/iter/traits/iterator/trait.Iterator.html#associatedtype.Item\" class=\"associatedtype\">Item</a> = <a class=\"primitive\" href=\"https://doc.rust-lang.org/1.76.0/std/primitive.reference.html\">&amp;'a mut T</a>;</div>"}</script></section></div></main></body></html>
Reference in New Issue View Git Blame Copy Permalink