blob: 3794cf9514e18decc41e7841b41abfd82ba03fd6 [file] [log] [blame]
<!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="Initializes new HTTP/2 streams on a connection by sending a request."><meta name="keywords" content="rust, rustlang, rust-lang, SendRequest"><title>SendRequest in h2::client - Rust</title><link rel="preload" as="font" type="font/woff2" crossorigin href="../../SourceSerif4-Regular.ttf.woff2"><link rel="preload" as="font" type="font/woff2" crossorigin href="../../FiraSans-Regular.woff2"><link rel="preload" as="font" type="font/woff2" crossorigin href="../../FiraSans-Medium.woff2"><link rel="preload" as="font" type="font/woff2" crossorigin href="../../SourceCodePro-Regular.ttf.woff2"><link rel="preload" as="font" type="font/woff2" crossorigin href="../../SourceSerif4-Bold.ttf.woff2"><link rel="preload" as="font" type="font/woff2" crossorigin href="../../SourceCodePro-Semibold.ttf.woff2"><link rel="stylesheet" href="../../normalize.css"><link rel="stylesheet" href="../../rustdoc.css" id="mainThemeStyle"><link rel="stylesheet" href="../../ayu.css" disabled><link rel="stylesheet" href="../../dark.css" disabled><link rel="stylesheet" href="../../light.css" id="themeStyle"><script id="default-settings" ></script><script src="../../storage.js"></script><script defer src="sidebar-items.js"></script><script defer src="../../main.js"></script><noscript><link rel="stylesheet" href="../../noscript.css"></noscript><link rel="alternate icon" type="image/png" href="../../favicon-16x16.png"><link rel="alternate icon" type="image/png" href="../../favicon-32x32.png"><link rel="icon" type="image/svg+xml" href="../../favicon.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><a class="sidebar-logo" href="../../h2/index.html"><div class="logo-container"><img class="rust-logo" src="../../rust-logo.svg" alt="logo"></div></a><h2></h2></nav><nav class="sidebar"><a class="sidebar-logo" href="../../h2/index.html"><div class="logo-container"><img class="rust-logo" src="../../rust-logo.svg" alt="logo"></div></a><h2 class="location"><a href="#">SendRequest</a></h2><div class="sidebar-elems"><section><h3><a href="#implementations">Methods</a></h3><ul class="block"><li><a href="#method.is_extended_connect_protocol_enabled">is_extended_connect_protocol_enabled</a></li><li><a href="#method.poll_ready">poll_ready</a></li><li><a href="#method.ready">ready</a></li><li><a href="#method.send_request">send_request</a></li></ul><h3><a href="#trait-implementations">Trait Implementations</a></h3><ul class="block"><li><a href="#impl-Clone-for-SendRequest%3CB%3E">Clone</a></li><li><a href="#impl-Debug-for-SendRequest%3CB%3E">Debug</a></li></ul><h3><a href="#synthetic-implementations">Auto Trait Implementations</a></h3><ul class="block"><li><a href="#impl-RefUnwindSafe-for-SendRequest%3CB%3E">RefUnwindSafe</a></li><li><a href="#impl-Send-for-SendRequest%3CB%3E">Send</a></li><li><a href="#impl-Sync-for-SendRequest%3CB%3E">Sync</a></li><li><a href="#impl-Unpin-for-SendRequest%3CB%3E">Unpin</a></li><li><a href="#impl-UnwindSafe-for-SendRequest%3CB%3E">UnwindSafe</a></li></ul><h3><a href="#blanket-implementations">Blanket Implementations</a></h3><ul class="block"><li><a href="#impl-Any-for-SendRequest%3CB%3E">Any</a></li><li><a href="#impl-Borrow%3CT%3E-for-SendRequest%3CB%3E">Borrow&lt;T&gt;</a></li><li><a href="#impl-BorrowMut%3CT%3E-for-SendRequest%3CB%3E">BorrowMut&lt;T&gt;</a></li><li><a href="#impl-From%3CT%3E-for-SendRequest%3CB%3E">From&lt;T&gt;</a></li><li><a href="#impl-Instrument-for-SendRequest%3CB%3E">Instrument</a></li><li><a href="#impl-Into%3CU%3E-for-SendRequest%3CB%3E">Into&lt;U&gt;</a></li><li><a href="#impl-ToOwned-for-SendRequest%3CB%3E">ToOwned</a></li><li><a href="#impl-TryFrom%3CU%3E-for-SendRequest%3CB%3E">TryFrom&lt;U&gt;</a></li><li><a href="#impl-TryInto%3CU%3E-for-SendRequest%3CB%3E">TryInto&lt;U&gt;</a></li><li><a href="#impl-WithSubscriber-for-SendRequest%3CB%3E">WithSubscriber</a></li></ul></section><h2><a href="index.html">In h2::client</a></h2></div></nav><main><div class="width-limiter"><nav class="sub"><form class="search-form"><div class="search-container"><span></span><input class="search-input" name="search" autocomplete="off" spellcheck="false" placeholder="Click or press ‘S’ to search, ‘?’ for more options…" type="search"><div id="help-button" title="help" tabindex="-1"><a href="../../help.html">?</a></div><div id="settings-menu" tabindex="-1"><a href="../../settings.html" title="settings"><img width="22" height="22" alt="Change settings" src="../../wheel.svg"></a></div></div></form></nav><section id="main-content" class="content"><div class="main-heading"><h1 class="fqn">Struct <a href="../index.html">h2</a>::<wbr><a href="index.html">client</a>::<wbr><a class="struct" href="#">SendRequest</a><button id="copy-path" onclick="copy_path(this)" title="Copy item path to clipboard"><img src="../../clipboard.svg" width="19" height="18" alt="Copy item path"></button></h1><span class="out-of-band"><a class="srclink" href="../../src/h2/client.rs.html#176-179">source</a> · <a id="toggle-all-docs" href="javascript:void(0)" title="collapse all docs">[<span class="inner">&#x2212;</span>]</a></span></div><div class="item-decl"><pre class="rust struct"><code>pub struct SendRequest&lt;B:&nbsp;<a class="trait" href="../../bytes/buf/buf_impl/trait.Buf.html" title="trait bytes::buf::buf_impl::Buf">Buf</a>&gt; { /* private fields */ }</code></pre></div><details class="rustdoc-toggle top-doc" open><summary class="hideme"><span>Expand description</span></summary><div class="docblock"><p>Initializes new HTTP/2 streams on a connection by sending a request.</p>
<p>This type does no work itself. Instead, it is a handle to the inner
connection state held by <a href="struct.Connection.html"><code>Connection</code></a>. If the associated connection
instance is dropped, all <code>SendRequest</code> functions will return <a href="../struct.Error.html"><code>Error</code></a>.</p>
<p><a href="struct.SendRequest.html" title="SendRequest"><code>SendRequest</code></a> instances are able to move to and operate on separate tasks
/ threads than their associated <a href="struct.Connection.html"><code>Connection</code></a> instance. Internally, there
is a buffer used to stage requests before they get written to the
connection. There is no guarantee that requests get written to the
connection in FIFO order as HTTP/2 prioritization logic can play a role.</p>
<p><a href="struct.SendRequest.html" title="SendRequest"><code>SendRequest</code></a> implements <a href="https://doc.rust-lang.org/std/clone/trait.Clone.html"><code>Clone</code></a>, enabling the creation of many
instances that are backed by a single connection.</p>
<p>See <a href="index.html">module</a> level documentation for more details.</p>
</div></details><h2 id="implementations" class="small-section-header">Implementations<a href="#implementations" class="anchor"></a></h2><div id="implementations-list"><details class="rustdoc-toggle implementors-toggle" open><summary><section id="impl-SendRequest%3CB%3E" class="impl has-srclink"><a class="srclink rightside" href="../../src/h2/client.rs.html#346-541">source</a><a href="#impl-SendRequest%3CB%3E" class="anchor"></a><h3 class="code-header">impl&lt;B&gt; <a class="struct" href="struct.SendRequest.html" title="struct h2::client::SendRequest">SendRequest</a>&lt;B&gt;<span class="where fmt-newline">where<br>&nbsp;&nbsp;&nbsp;&nbsp;B: <a class="trait" href="../../bytes/buf/buf_impl/trait.Buf.html" title="trait bytes::buf::buf_impl::Buf">Buf</a>,</span></h3></section></summary><div class="impl-items"><details class="rustdoc-toggle method-toggle" open><summary><section id="method.poll_ready" class="method has-srclink"><a class="srclink rightside" href="../../src/h2/client.rs.html#360-364">source</a><h4 class="code-header">pub fn <a href="#method.poll_ready" class="fnname">poll_ready</a>(&amp;mut self, cx: &amp;mut Context&lt;'_&gt;) -&gt; Poll&lt;Result&lt;(), <a class="struct" href="../struct.Error.html" title="struct h2::Error">Error</a>&gt;&gt;</h4></section></summary><div class="docblock"><p>Returns <code>Ready</code> when the connection can initialize a new HTTP/2
stream.</p>
<p>This function must return <code>Ready</code> before <code>send_request</code> is called. When
<code>Poll::Pending</code> is returned, the task will be notified once the readiness
state changes.</p>
<p>See <a href="index.html">module</a> level docs for more details.</p>
</div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.ready" class="method has-srclink"><a class="srclink rightside" href="../../src/h2/client.rs.html#394-396">source</a><h4 class="code-header">pub fn <a href="#method.ready" class="fnname">ready</a>(self) -&gt; <a class="struct" href="struct.ReadySendRequest.html" title="struct h2::client::ReadySendRequest">ReadySendRequest</a>&lt;B&gt;<span class="notable-traits"><span class="notable-traits-tooltip"><span class="notable-traits-tooltiptext"><span class="docblock"><span class="notable">Notable traits for <a class="struct" href="struct.ReadySendRequest.html" title="struct h2::client::ReadySendRequest">ReadySendRequest</a>&lt;B&gt;</span><code class="content"><span class="where fmt-newline">impl&lt;B&gt; Future for <a class="struct" href="struct.ReadySendRequest.html" title="struct h2::client::ReadySendRequest">ReadySendRequest</a>&lt;B&gt;<span class="where fmt-newline">where<br>&nbsp;&nbsp;&nbsp;&nbsp;B: <a class="trait" href="../../bytes/buf/buf_impl/trait.Buf.html" title="trait bytes::buf::buf_impl::Buf">Buf</a>,</span></span><span class="where fmt-newline"> type <a class="associatedtype">Output</a> = Result&lt;<a class="struct" href="struct.SendRequest.html" title="struct h2::client::SendRequest">SendRequest</a>&lt;B&gt;, <a class="struct" href="../struct.Error.html" title="struct h2::Error">Error</a>&gt;;</span></code></span></span></span></span></h4></section></summary><div class="docblock"><p>Consumes <code>self</code>, returning a future that returns <code>self</code> back once it is
ready to send a request.</p>
<p>This function should be called before calling <code>send_request</code>.</p>
<p>This is a functional combinator for <a href="#method.poll_ready"><code>poll_ready</code></a>. The returned future
will call <code>SendStream::poll_ready</code> until <code>Ready</code>, then returns <code>self</code> to
the caller.</p>
<h5 id="examples"><a href="#examples">Examples</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="comment">// First, wait until the `send_request` handle is ready to send a new
// request
</span><span class="kw">let </span><span class="kw-2">mut </span>send_request = send_request.ready().<span class="kw">await</span>.unwrap();
<span class="comment">// Use `send_request` here.</span></code></pre></div>
<p>See <a href="index.html">module</a> level docs for more details.</p>
</div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.send_request" class="method has-srclink"><a class="srclink rightside" href="../../src/h2/client.rs.html#505-527">source</a><h4 class="code-header">pub fn <a href="#method.send_request" class="fnname">send_request</a>(<br>&nbsp;&nbsp;&nbsp;&nbsp;&amp;mut self,<br>&nbsp;&nbsp;&nbsp;&nbsp;request: <a class="struct" href="../../http/request/struct.Request.html" title="struct http::request::Request">Request</a>&lt;()&gt;,<br>&nbsp;&nbsp;&nbsp;&nbsp;end_of_stream: bool<br>) -&gt; Result&lt;(<a class="struct" href="struct.ResponseFuture.html" title="struct h2::client::ResponseFuture">ResponseFuture</a>, <a class="struct" href="../struct.SendStream.html" title="struct h2::SendStream">SendStream</a>&lt;B&gt;), <a class="struct" href="../struct.Error.html" title="struct h2::Error">Error</a>&gt;</h4></section></summary><div class="docblock"><p>Sends a HTTP/2 request to the server.</p>
<p><code>send_request</code> initializes a new HTTP/2 stream on the associated
connection, then sends the given request using this new stream. Only the
request head is sent.</p>
<p>On success, a <a href="struct.ResponseFuture.html"><code>ResponseFuture</code></a> instance and <a href="../struct.SendStream.html"><code>SendStream</code></a> instance
are returned. The <a href="struct.ResponseFuture.html"><code>ResponseFuture</code></a> instance is used to get the
server’s response and the <a href="../struct.SendStream.html"><code>SendStream</code></a> instance is used to send a
request body or trailers to the server over the same HTTP/2 stream.</p>
<p>To send a request body or trailers, set <code>end_of_stream</code> to <code>false</code>.
Then, use the returned <a href="../struct.SendStream.html"><code>SendStream</code></a> instance to stream request body
chunks or send trailers. If <code>end_of_stream</code> is <strong>not</strong> set to <code>false</code>
then attempting to call <a href="../struct.SendStream.html#method.send_data"><code>SendStream::send_data</code></a> or
<a href="../struct.SendStream.html#method.send_trailers"><code>SendStream::send_trailers</code></a> will result in an error.</p>
<p>If no request body or trailers are to be sent, set <code>end_of_stream</code> to
<code>true</code> and drop the returned <a href="../struct.SendStream.html"><code>SendStream</code></a> instance.</p>
<h5 id="a-note-on-http-versions"><a href="#a-note-on-http-versions">A note on HTTP versions</a></h5>
<p>The provided <code>Request</code> will be encoded differently depending on the
value of its version field. If the version is set to 2.0, then the
request is encoded as per the specification recommends.</p>
<p>If the version is set to a lower value, then the request is encoded to
preserve the characteristics of HTTP 1.1 and lower. Specifically, host
headers are permitted and the <code>:authority</code> pseudo header is not
included.</p>
<p>The caller should always set the request’s version field to 2.0 unless
specifically transmitting an HTTP 1.1 request over 2.0.</p>
<h5 id="examples-1"><a href="#examples-1">Examples</a></h5>
<p>Sending a request with no body</p>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="comment">// First, wait until the `send_request` handle is ready to send a new
// request
</span><span class="kw">let </span><span class="kw-2">mut </span>send_request = send_request.ready().<span class="kw">await</span>.unwrap();
<span class="comment">// Prepare the HTTP request to send to the server.
</span><span class="kw">let </span>request = Request::get(<span class="string">&quot;https://www.example.com/&quot;</span>)
.body(())
.unwrap();
<span class="comment">// Send the request to the server. Since we are not sending a
// body or trailers, we can drop the `SendStream` instance.
</span><span class="kw">let </span>(response, <span class="kw">_</span>) = send_request.send_request(request, <span class="bool-val">true</span>).unwrap();
<span class="kw">let </span>response = response.<span class="kw">await</span>.unwrap();
<span class="comment">// Process the response</span></code></pre></div>
<p>Sending a request with a body and trailers</p>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="comment">// First, wait until the `send_request` handle is ready to send a new
// request
</span><span class="kw">let </span><span class="kw-2">mut </span>send_request = send_request.ready().<span class="kw">await</span>.unwrap();
<span class="comment">// Prepare the HTTP request to send to the server.
</span><span class="kw">let </span>request = Request::get(<span class="string">&quot;https://www.example.com/&quot;</span>)
.body(())
.unwrap();
<span class="comment">// Send the request to the server. If we are not sending a
// body or trailers, we can drop the `SendStream` instance.
</span><span class="kw">let </span>(response, <span class="kw-2">mut </span>send_stream) = send_request
.send_request(request, <span class="bool-val">false</span>).unwrap();
<span class="comment">// At this point, one option would be to wait for send capacity.
// Doing so would allow us to not hold data in memory that
// cannot be sent. However, this is not a requirement, so this
// example will skip that step. See `SendStream` documentation
// for more details.
</span>send_stream.send_data(<span class="string">b&quot;hello&quot;</span>, <span class="bool-val">false</span>).unwrap();
send_stream.send_data(<span class="string">b&quot;world&quot;</span>, <span class="bool-val">false</span>).unwrap();
<span class="comment">// Send the trailers.
</span><span class="kw">let </span><span class="kw-2">mut </span>trailers = HeaderMap::new();
trailers.insert(
header::HeaderName::from_bytes(<span class="string">b&quot;my-trailer&quot;</span>).unwrap(),
header::HeaderValue::from_bytes(<span class="string">b&quot;hello&quot;</span>).unwrap());
send_stream.send_trailers(trailers).unwrap();
<span class="kw">let </span>response = response.<span class="kw">await</span>.unwrap();
<span class="comment">// Process the response</span></code></pre></div>
</div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.is_extended_connect_protocol_enabled" class="method has-srclink"><a class="srclink rightside" href="../../src/h2/client.rs.html#538-540">source</a><h4 class="code-header">pub fn <a href="#method.is_extended_connect_protocol_enabled" class="fnname">is_extended_connect_protocol_enabled</a>(&amp;self) -&gt; bool</h4></section></summary><div class="docblock"><p>Returns whether the <a href="https://datatracker.ietf.org/doc/html/rfc8441#section-4">extended CONNECT protocol</a> is enabled or not.</p>
<p>This setting is configured by the server peer by sending the
<a href="https://datatracker.ietf.org/doc/html/rfc8441#section-3"><code>SETTINGS_ENABLE_CONNECT_PROTOCOL</code> parameter</a> in a <code>SETTINGS</code> frame.
This method returns the currently acknowledged value received from the
remote.</p>
</div></details></div></details></div><h2 id="trait-implementations" class="small-section-header">Trait Implementations<a href="#trait-implementations" class="anchor"></a></h2><div id="trait-implementations-list"><details class="rustdoc-toggle implementors-toggle" open><summary><section id="impl-Clone-for-SendRequest%3CB%3E" class="impl has-srclink"><a class="srclink rightside" href="../../src/h2/client.rs.html#552-562">source</a><a href="#impl-Clone-for-SendRequest%3CB%3E" class="anchor"></a><h3 class="code-header">impl&lt;B&gt; Clone for <a class="struct" href="struct.SendRequest.html" title="struct h2::client::SendRequest">SendRequest</a>&lt;B&gt;<span class="where fmt-newline">where<br>&nbsp;&nbsp;&nbsp;&nbsp;B: <a class="trait" href="../../bytes/buf/buf_impl/trait.Buf.html" title="trait bytes::buf::buf_impl::Buf">Buf</a>,</span></h3></section></summary><div class="impl-items"><details class="rustdoc-toggle method-toggle" open><summary><section id="method.clone" class="method trait-impl has-srclink"><a class="srclink rightside" href="../../src/h2/client.rs.html#556-561">source</a><a href="#method.clone" class="anchor"></a><h4 class="code-header">fn <a class="fnname">clone</a>(&amp;self) -&gt; Self</h4></section></summary><div class='docblock'>Returns a copy of the value. <a>Read more</a></div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.clone_from" class="method trait-impl has-srclink"><span class="since rightside" title="Stable since Rust version 1.0.0">1.0.0</span><a href="#method.clone_from" class="anchor"></a><h4 class="code-header">const fn <a class="fnname">clone_from</a>(&amp;mut self, source: &amp;Self)</h4></section></summary><div class='docblock'>Performs copy-assignment from <code>source</code>. <a>Read more</a></div></details></div></details><details class="rustdoc-toggle implementors-toggle" open><summary><section id="impl-Debug-for-SendRequest%3CB%3E" class="impl has-srclink"><a class="srclink rightside" href="../../src/h2/client.rs.html#543-550">source</a><a href="#impl-Debug-for-SendRequest%3CB%3E" class="anchor"></a><h3 class="code-header">impl&lt;B&gt; Debug for <a class="struct" href="struct.SendRequest.html" title="struct h2::client::SendRequest">SendRequest</a>&lt;B&gt;<span class="where fmt-newline">where<br>&nbsp;&nbsp;&nbsp;&nbsp;B: <a class="trait" href="../../bytes/buf/buf_impl/trait.Buf.html" title="trait bytes::buf::buf_impl::Buf">Buf</a>,</span></h3></section></summary><div class="impl-items"><details class="rustdoc-toggle method-toggle" open><summary><section id="method.fmt" class="method trait-impl has-srclink"><a class="srclink rightside" href="../../src/h2/client.rs.html#547-549">source</a><a href="#method.fmt" class="anchor"></a><h4 class="code-header">fn <a class="fnname">fmt</a>(&amp;self, fmt: &amp;mut Formatter&lt;'_&gt;) -&gt; Result</h4></section></summary><div class='docblock'>Formats the value using the given formatter. <a>Read more</a></div></details></div></details></div><h2 id="synthetic-implementations" class="small-section-header">Auto Trait Implementations<a href="#synthetic-implementations" class="anchor"></a></h2><div id="synthetic-implementations-list"><section id="impl-RefUnwindSafe-for-SendRequest%3CB%3E" class="impl has-srclink"><a href="#impl-RefUnwindSafe-for-SendRequest%3CB%3E" class="anchor"></a><h3 class="code-header">impl&lt;B&gt; RefUnwindSafe for <a class="struct" href="struct.SendRequest.html" title="struct h2::client::SendRequest">SendRequest</a>&lt;B&gt;</h3></section><section id="impl-Send-for-SendRequest%3CB%3E" class="impl has-srclink"><a href="#impl-Send-for-SendRequest%3CB%3E" class="anchor"></a><h3 class="code-header">impl&lt;B&gt; Send for <a class="struct" href="struct.SendRequest.html" title="struct h2::client::SendRequest">SendRequest</a>&lt;B&gt;<span class="where fmt-newline">where<br>&nbsp;&nbsp;&nbsp;&nbsp;B: Send,</span></h3></section><section id="impl-Sync-for-SendRequest%3CB%3E" class="impl has-srclink"><a href="#impl-Sync-for-SendRequest%3CB%3E" class="anchor"></a><h3 class="code-header">impl&lt;B&gt; Sync for <a class="struct" href="struct.SendRequest.html" title="struct h2::client::SendRequest">SendRequest</a>&lt;B&gt;<span class="where fmt-newline">where<br>&nbsp;&nbsp;&nbsp;&nbsp;B: Send,</span></h3></section><section id="impl-Unpin-for-SendRequest%3CB%3E" class="impl has-srclink"><a href="#impl-Unpin-for-SendRequest%3CB%3E" class="anchor"></a><h3 class="code-header">impl&lt;B&gt; Unpin for <a class="struct" href="struct.SendRequest.html" title="struct h2::client::SendRequest">SendRequest</a>&lt;B&gt;</h3></section><section id="impl-UnwindSafe-for-SendRequest%3CB%3E" class="impl has-srclink"><a href="#impl-UnwindSafe-for-SendRequest%3CB%3E" class="anchor"></a><h3 class="code-header">impl&lt;B&gt; UnwindSafe for <a class="struct" href="struct.SendRequest.html" title="struct h2::client::SendRequest">SendRequest</a>&lt;B&gt;</h3></section></div><h2 id="blanket-implementations" class="small-section-header">Blanket Implementations<a href="#blanket-implementations" class="anchor"></a></h2><div id="blanket-implementations-list"><details class="rustdoc-toggle implementors-toggle"><summary><section id="impl-Any-for-SendRequest%3CB%3E" class="impl has-srclink"><a href="#impl-Any-for-SendRequest%3CB%3E" class="anchor"></a><h3 class="code-header">impl&lt;T&gt; Any for T<span class="where fmt-newline">where<br>&nbsp;&nbsp;&nbsp;&nbsp;T: 'static + ?Sized,</span></h3></section></summary><div class="impl-items"><details class="rustdoc-toggle method-toggle" open><summary><section id="method.type_id" class="method trait-impl has-srclink"><a href="#method.type_id" class="anchor"></a><h4 class="code-header">fn <a class="fnname">type_id</a>(&amp;self) -&gt; TypeId</h4></section></summary><div class='docblock'>Gets the <code>TypeId</code> of <code>self</code>. <a>Read more</a></div></details></div></details><details class="rustdoc-toggle implementors-toggle"><summary><section id="impl-Borrow%3CT%3E-for-SendRequest%3CB%3E" class="impl has-srclink"><a href="#impl-Borrow%3CT%3E-for-SendRequest%3CB%3E" class="anchor"></a><h3 class="code-header">impl&lt;T&gt; Borrow&lt;T&gt; for T<span class="where fmt-newline">where<br>&nbsp;&nbsp;&nbsp;&nbsp;T: ?Sized,</span></h3></section></summary><div class="impl-items"><details class="rustdoc-toggle method-toggle" open><summary><section id="method.borrow" class="method trait-impl has-srclink"><span class="since rightside" title="const unstable">const: <a href="https://github.com/rust-lang/rust/issues/91522" title="Tracking issue for const_borrow">unstable</a></span><a href="#method.borrow" class="anchor"></a><h4 class="code-header">fn <a class="fnname">borrow</a>(&amp;self) -&gt; &amp;T</h4></section></summary><div class='docblock'>Immutably borrows from an owned value. <a>Read more</a></div></details></div></details><details class="rustdoc-toggle implementors-toggle"><summary><section id="impl-BorrowMut%3CT%3E-for-SendRequest%3CB%3E" class="impl has-srclink"><a href="#impl-BorrowMut%3CT%3E-for-SendRequest%3CB%3E" class="anchor"></a><h3 class="code-header">impl&lt;T&gt; BorrowMut&lt;T&gt; for T<span class="where fmt-newline">where<br>&nbsp;&nbsp;&nbsp;&nbsp;T: ?Sized,</span></h3></section></summary><div class="impl-items"><details class="rustdoc-toggle method-toggle" open><summary><section id="method.borrow_mut" class="method trait-impl has-srclink"><span class="since rightside" title="const unstable">const: <a href="https://github.com/rust-lang/rust/issues/91522" title="Tracking issue for const_borrow">unstable</a></span><a href="#method.borrow_mut" class="anchor"></a><h4 class="code-header">fn <a class="fnname">borrow_mut</a>(&amp;mut self) -&gt; &amp;mut T</h4></section></summary><div class='docblock'>Mutably borrows from an owned value. <a>Read more</a></div></details></div></details><details class="rustdoc-toggle implementors-toggle"><summary><section id="impl-From%3CT%3E-for-SendRequest%3CB%3E" class="impl has-srclink"><a href="#impl-From%3CT%3E-for-SendRequest%3CB%3E" class="anchor"></a><h3 class="code-header">impl&lt;T&gt; From&lt;T&gt; for T</h3></section></summary><div class="impl-items"><details class="rustdoc-toggle method-toggle" open><summary><section id="method.from" class="method trait-impl has-srclink"><span class="since rightside" title="const unstable">const: <a href="https://github.com/rust-lang/rust/issues/88674" title="Tracking issue for const_convert">unstable</a></span><a href="#method.from" class="anchor"></a><h4 class="code-header">fn <a class="fnname">from</a>(t: T) -&gt; T</h4></section></summary><div class="docblock"><p>Returns the argument unchanged.</p>
</div></details></div></details><details class="rustdoc-toggle implementors-toggle"><summary><section id="impl-Instrument-for-SendRequest%3CB%3E" class="impl has-srclink"><a class="srclink rightside" href="../../src/tracing/instrument.rs.html#276">source</a><a href="#impl-Instrument-for-SendRequest%3CB%3E" 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="rustdoc-toggle method-toggle" open><summary><section id="method.instrument" class="method trait-impl has-srclink"><a class="srclink rightside" href="../../src/tracing/instrument.rs.html#82">source</a><a href="#method.instrument" class="anchor"></a><h4 class="code-header">fn <a href="../../tracing/instrument/trait.Instrument.html#method.instrument" class="fnname">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="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="rustdoc-toggle method-toggle" open><summary><section id="method.in_current_span" class="method trait-impl has-srclink"><a class="srclink rightside" href="../../src/tracing/instrument.rs.html#121">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="fnname">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">current</a> <a href="../../tracing/span/struct.Span.html"><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="rustdoc-toggle implementors-toggle"><summary><section id="impl-Into%3CU%3E-for-SendRequest%3CB%3E" class="impl has-srclink"><a href="#impl-Into%3CU%3E-for-SendRequest%3CB%3E" class="anchor"></a><h3 class="code-header">impl&lt;T, U&gt; Into&lt;U&gt; for T<span class="where fmt-newline">where<br>&nbsp;&nbsp;&nbsp;&nbsp;U: From&lt;T&gt;,</span></h3></section></summary><div class="impl-items"><details class="rustdoc-toggle method-toggle" open><summary><section id="method.into" class="method trait-impl has-srclink"><span class="since rightside" title="const unstable">const: <a href="https://github.com/rust-lang/rust/issues/88674" title="Tracking issue for const_convert">unstable</a></span><a href="#method.into" class="anchor"></a><h4 class="code-header">fn <a class="fnname">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>[From]&lt;T&gt; for U</code> chooses to do.</p>
</div></details></div></details><details class="rustdoc-toggle implementors-toggle"><summary><section id="impl-ToOwned-for-SendRequest%3CB%3E" class="impl has-srclink"><a href="#impl-ToOwned-for-SendRequest%3CB%3E" class="anchor"></a><h3 class="code-header">impl&lt;T&gt; ToOwned for T<span class="where fmt-newline">where<br>&nbsp;&nbsp;&nbsp;&nbsp;T: Clone,</span></h3></section></summary><div class="impl-items"><details class="rustdoc-toggle" open><summary><section id="associatedtype.Owned" class="associatedtype trait-impl has-srclink"><a href="#associatedtype.Owned" class="anchor"></a><h4 class="code-header">type <a class="associatedtype">Owned</a> = T</h4></section></summary><div class='docblock'>The resulting type after obtaining ownership.</div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.to_owned" class="method trait-impl has-srclink"><a href="#method.to_owned" class="anchor"></a><h4 class="code-header">fn <a class="fnname">to_owned</a>(&amp;self) -&gt; T</h4></section></summary><div class='docblock'>Creates owned data from borrowed data, usually by cloning. <a>Read more</a></div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.clone_into" class="method trait-impl has-srclink"><a href="#method.clone_into" class="anchor"></a><h4 class="code-header">fn <a class="fnname">clone_into</a>(&amp;self, target: &amp;mut T)</h4></section></summary><div class='docblock'>Uses borrowed data to replace owned data, usually by cloning. <a>Read more</a></div></details></div></details><details class="rustdoc-toggle implementors-toggle"><summary><section id="impl-TryFrom%3CU%3E-for-SendRequest%3CB%3E" class="impl has-srclink"><a href="#impl-TryFrom%3CU%3E-for-SendRequest%3CB%3E" class="anchor"></a><h3 class="code-header">impl&lt;T, U&gt; TryFrom&lt;U&gt; for T<span class="where fmt-newline">where<br>&nbsp;&nbsp;&nbsp;&nbsp;U: Into&lt;T&gt;,</span></h3></section></summary><div class="impl-items"><details class="rustdoc-toggle" open><summary><section id="associatedtype.Error-1" class="associatedtype trait-impl has-srclink"><a href="#associatedtype.Error-1" class="anchor"></a><h4 class="code-header">type <a class="associatedtype">Error</a> = Infallible</h4></section></summary><div class='docblock'>The type returned in the event of a conversion error.</div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.try_from" class="method trait-impl has-srclink"><span class="since rightside" title="const unstable">const: <a href="https://github.com/rust-lang/rust/issues/88674" title="Tracking issue for const_convert">unstable</a></span><a href="#method.try_from" class="anchor"></a><h4 class="code-header">fn <a class="fnname">try_from</a>(value: U) -&gt; Result&lt;T, &lt;T as TryFrom&lt;U&gt;&gt;::Error&gt;</h4></section></summary><div class='docblock'>Performs the conversion.</div></details></div></details><details class="rustdoc-toggle implementors-toggle"><summary><section id="impl-TryInto%3CU%3E-for-SendRequest%3CB%3E" class="impl has-srclink"><a href="#impl-TryInto%3CU%3E-for-SendRequest%3CB%3E" class="anchor"></a><h3 class="code-header">impl&lt;T, U&gt; TryInto&lt;U&gt; for T<span class="where fmt-newline">where<br>&nbsp;&nbsp;&nbsp;&nbsp;U: TryFrom&lt;T&gt;,</span></h3></section></summary><div class="impl-items"><details class="rustdoc-toggle" open><summary><section id="associatedtype.Error" class="associatedtype trait-impl has-srclink"><a href="#associatedtype.Error" class="anchor"></a><h4 class="code-header">type <a class="associatedtype">Error</a> = &lt;U as TryFrom&lt;T&gt;&gt;::Error</h4></section></summary><div class='docblock'>The type returned in the event of a conversion error.</div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.try_into" class="method trait-impl has-srclink"><span class="since rightside" title="const unstable">const: <a href="https://github.com/rust-lang/rust/issues/88674" title="Tracking issue for const_convert">unstable</a></span><a href="#method.try_into" class="anchor"></a><h4 class="code-header">fn <a class="fnname">try_into</a>(self) -&gt; Result&lt;U, &lt;U as TryFrom&lt;T&gt;&gt;::Error&gt;</h4></section></summary><div class='docblock'>Performs the conversion.</div></details></div></details><details class="rustdoc-toggle implementors-toggle"><summary><section id="impl-WithSubscriber-for-SendRequest%3CB%3E" class="impl has-srclink"><a class="srclink rightside" href="../../src/tracing/instrument.rs.html#334">source</a><a href="#impl-WithSubscriber-for-SendRequest%3CB%3E" 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="rustdoc-toggle method-toggle" open><summary><section id="method.with_subscriber" class="method trait-impl has-srclink"><a class="srclink rightside" href="../../src/tracing/instrument.rs.html#169-171">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="fnname">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;<span class="where fmt-newline">where<br>&nbsp;&nbsp;&nbsp;&nbsp;S: Into&lt;<a class="struct" href="../../tracing_core/dispatcher/struct.Dispatch.html" title="struct tracing_core::dispatcher::Dispatch">Dispatch</a>&gt;,</span></h4></section></summary><div class='docblock'>Attaches the provided <a href="../../tracing_core/subscriber/trait.Subscriber.html"><code>Subscriber</code></a> to this type, returning a
<a href="../../tracing/instrument/struct.WithDispatch.html" title="WithDispatch"><code>WithDispatch</code></a> wrapper. <a href="../../tracing/instrument/trait.WithSubscriber.html#method.with_subscriber">Read more</a></div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.with_current_subscriber" class="method trait-impl has-srclink"><a class="srclink rightside" href="../../src/tracing/instrument.rs.html#221">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="fnname">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">default</a> <a href="../../tracing_core/subscriber/trait.Subscriber.html"><code>Subscriber</code></a> to this type, returning a
<a href="../../tracing/instrument/struct.WithDispatch.html" title="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></section></div></main><div id="rustdoc-vars" data-root-path="../../" data-current-crate="h2" data-themes="ayu,dark,light" data-resource-suffix="" data-rustdoc-version="1.66.0-nightly (5c8bff74b 2022-10-21)" ></div></body></html>