rtic/dev/api/futures_util/task/trait.LocalSpawn.html
2024-10-24 05:57:30 +00:00

34 lines
No EOL
13 KiB
HTML
Raw 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="The `LocalSpawn` is similar to `Spawn`, but allows spawning futures that dont implement `Send`."><title>LocalSpawn in futures_util::task - Rust</title><script>if(window.location.protocol!=="file:")document.head.insertAdjacentHTML("beforeend","SourceSerif4-Regular-46f98efaafac5295.ttf.woff2,FiraSans-Regular-018c141bf0843ffd.woff2,FiraSans-Medium-8f9a781e4970d388.woff2,SourceCodePro-Regular-562dcc5011b6de7d.ttf.woff2,SourceCodePro-Semibold-d899c5a5c4aeb14a.ttf.woff2".split(",").map(f=>`<link rel="preload" as="font" type="font/woff2" crossorigin href="../../static.files/${f}">`).join(""))</script><link rel="stylesheet" href="../../static.files/normalize-76eba96aa4d2e634.css"><link rel="stylesheet" href="../../static.files/rustdoc-492a78a4a87dcc01.css"><meta name="rustdoc-vars" data-root-path="../../" data-static-root-path="../../static.files/" data-current-crate="futures_util" data-themes="" data-resource-suffix="" data-rustdoc-version="1.82.0 (f6e511eec 2024-10-15)" data-channel="1.82.0" data-search-js="search-a99f1315e7cc5121.js" data-settings-js="settings-4313503d2e1961c2.js" ><script src="../../static.files/storage-118b08c4c78b968e.js"></script><script defer src="sidebar-items.js"></script><script defer src="../../static.files/main-921df33f47b8780c.js"></script><noscript><link rel="stylesheet" href="../../static.files/noscript-3b12f09e550e0385.css"></noscript><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 trait"><!--[if lte IE 11]><div class="warning">This old browser is unsupported and will most likely display funky things.</div><![endif]--><nav class="mobile-topbar"><button class="sidebar-menu-toggle" title="show sidebar"></button></nav><nav class="sidebar"><div class="sidebar-crate"><h2><a href="../../futures_util/index.html">futures_<wbr>util</a><span class="version">0.3.31</span></h2></div><h2 class="location"><a href="#">Local<wbr>Spawn</a></h2><div class="sidebar-elems"><section><h3><a href="#required-methods">Required Methods</a></h3><ul class="block"><li><a href="#tymethod.spawn_local_obj">spawn_local_obj</a></li></ul><h3><a href="#provided-methods">Provided Methods</a></h3><ul class="block"><li><a href="#method.status_local">status_local</a></li></ul><h3><a href="#foreign-impls">Implementations on Foreign Types</a></h3><ul class="block"><li><a href="#impl-LocalSpawn-for-%26Sp">&#38;Sp</a></li><li><a href="#impl-LocalSpawn-for-%26mut+Sp">&#38;mut Sp</a></li></ul><h3><a href="#implementors">Implementors</a></h3></section><h2><a href="index.html">In futures_<wbr>util::<wbr>task</a></h2></div></nav><div class="sidebar-resizer"></div><main><div class="width-limiter"><rustdoc-search></rustdoc-search><section id="main-content" class="content"><div class="main-heading"><h1>Trait <a href="../index.html">futures_util</a>::<wbr><a href="index.html">task</a>::<wbr><a class="trait" href="#">LocalSpawn</a><button id="copy-path" title="Copy item path to clipboard">Copy item path</button></h1><span class="out-of-band"><a class="src" href="../../src/futures_task/spawn.rs.html#31">source</a> · <button id="toggle-all-docs" title="collapse all docs">[<span>&#x2212;</span>]</button></span></div><pre class="rust item-decl"><code>pub trait LocalSpawn {
// Required method
fn <a href="#tymethod.spawn_local_obj" class="fn">spawn_local_obj</a>(
&amp;self,
future: <a class="struct" href="struct.LocalFutureObj.html" title="struct futures_util::task::LocalFutureObj">LocalFutureObj</a>&lt;'static, <a class="primitive" href="https://doc.rust-lang.org/1.82.0/core/primitive.unit.html">()</a>&gt;,
) -&gt; <a class="enum" href="https://doc.rust-lang.org/1.82.0/core/result/enum.Result.html" title="enum core::result::Result">Result</a>&lt;<a class="primitive" href="https://doc.rust-lang.org/1.82.0/core/primitive.unit.html">()</a>, <a class="struct" href="struct.SpawnError.html" title="struct futures_util::task::SpawnError">SpawnError</a>&gt;;
// Provided method
fn <a href="#method.status_local" class="fn">status_local</a>(&amp;self) -&gt; <a class="enum" href="https://doc.rust-lang.org/1.82.0/core/result/enum.Result.html" title="enum core::result::Result">Result</a>&lt;<a class="primitive" href="https://doc.rust-lang.org/1.82.0/core/primitive.unit.html">()</a>, <a class="struct" href="struct.SpawnError.html" title="struct futures_util::task::SpawnError">SpawnError</a>&gt; { ... }
}</code></pre><details class="toggle top-doc" open><summary class="hideme"><span>Expand description</span></summary><div class="docblock"><p>The <code>LocalSpawn</code> is similar to <a href="trait.Spawn.html" title="trait futures_util::task::Spawn"><code>Spawn</code></a>, but allows spawning futures
that dont implement <code>Send</code>.</p>
</div></details><h2 id="required-methods" class="section-header">Required Methods<a href="#required-methods" class="anchor">§</a></h2><div class="methods"><details class="toggle method-toggle" open><summary><section id="tymethod.spawn_local_obj" class="method"><a class="src rightside" href="../../src/futures_task/spawn.rs.html#40">source</a><h4 class="code-header">fn <a href="#tymethod.spawn_local_obj" class="fn">spawn_local_obj</a>(
&amp;self,
future: <a class="struct" href="struct.LocalFutureObj.html" title="struct futures_util::task::LocalFutureObj">LocalFutureObj</a>&lt;'static, <a class="primitive" href="https://doc.rust-lang.org/1.82.0/core/primitive.unit.html">()</a>&gt;,
) -&gt; <a class="enum" href="https://doc.rust-lang.org/1.82.0/core/result/enum.Result.html" title="enum core::result::Result">Result</a>&lt;<a class="primitive" href="https://doc.rust-lang.org/1.82.0/core/primitive.unit.html">()</a>, <a class="struct" href="struct.SpawnError.html" title="struct futures_util::task::SpawnError">SpawnError</a>&gt;</h4></section></summary><div class="docblock"><p>Spawns a future that will be run to completion.</p>
<h5 id="errors"><a class="doc-anchor" href="#errors">§</a>Errors</h5>
<p>The executor may be unable to spawn tasks. Spawn errors should
represent relatively rare scenarios, such as the executor
having been shut down so that it is no longer able to accept
tasks.</p>
</div></details></div><h2 id="provided-methods" class="section-header">Provided Methods<a href="#provided-methods" class="anchor">§</a></h2><div class="methods"><details class="toggle method-toggle" open><summary><section id="method.status_local" class="method"><a class="src rightside" href="../../src/futures_task/spawn.rs.html#49">source</a><h4 class="code-header">fn <a href="#method.status_local" class="fn">status_local</a>(&amp;self) -&gt; <a class="enum" href="https://doc.rust-lang.org/1.82.0/core/result/enum.Result.html" title="enum core::result::Result">Result</a>&lt;<a class="primitive" href="https://doc.rust-lang.org/1.82.0/core/primitive.unit.html">()</a>, <a class="struct" href="struct.SpawnError.html" title="struct futures_util::task::SpawnError">SpawnError</a>&gt;</h4></section></summary><div class="docblock"><p>Determines whether the executor is able to spawn new tasks.</p>
<p>This method will return <code>Ok</code> when the executor is <em>likely</em>
(but not guaranteed) to accept a subsequent spawn attempt.
Likewise, an <code>Err</code> return means that <code>spawn</code> is likely, but
not guaranteed, to yield an error.</p>
</div></details></div><h2 id="foreign-impls" class="section-header">Implementations on Foreign Types<a href="#foreign-impls" class="anchor">§</a></h2><details class="toggle implementors-toggle"><summary><section id="impl-LocalSpawn-for-%26Sp" class="impl"><a class="src rightside" href="../../src/futures_task/spawn.rs.html#106">source</a><a href="#impl-LocalSpawn-for-%26Sp" class="anchor">§</a><h3 class="code-header">impl&lt;Sp&gt; <a class="trait" href="trait.LocalSpawn.html" title="trait futures_util::task::LocalSpawn">LocalSpawn</a> for <a class="primitive" href="https://doc.rust-lang.org/1.82.0/core/primitive.reference.html">&amp;Sp</a><div class="where">where
Sp: <a class="trait" href="trait.LocalSpawn.html" title="trait futures_util::task::LocalSpawn">LocalSpawn</a> + ?<a class="trait" href="https://doc.rust-lang.org/1.82.0/core/marker/trait.Sized.html" title="trait core::marker::Sized">Sized</a>,</div></h3></section></summary><div class="impl-items"><section id="method.spawn_local_obj" class="method trait-impl"><a class="src rightside" href="../../src/futures_task/spawn.rs.html#107">source</a><a href="#method.spawn_local_obj" class="anchor">§</a><h4 class="code-header">fn <a href="#tymethod.spawn_local_obj" class="fn">spawn_local_obj</a>(
&amp;self,
future: <a class="struct" href="struct.LocalFutureObj.html" title="struct futures_util::task::LocalFutureObj">LocalFutureObj</a>&lt;'static, <a class="primitive" href="https://doc.rust-lang.org/1.82.0/core/primitive.unit.html">()</a>&gt;,
) -&gt; <a class="enum" href="https://doc.rust-lang.org/1.82.0/core/result/enum.Result.html" title="enum core::result::Result">Result</a>&lt;<a class="primitive" href="https://doc.rust-lang.org/1.82.0/core/primitive.unit.html">()</a>, <a class="struct" href="struct.SpawnError.html" title="struct futures_util::task::SpawnError">SpawnError</a>&gt;</h4></section><section id="method.status_local-1" class="method trait-impl"><a class="src rightside" href="../../src/futures_task/spawn.rs.html#111">source</a><a href="#method.status_local-1" class="anchor">§</a><h4 class="code-header">fn <a href="#method.status_local" class="fn">status_local</a>(&amp;self) -&gt; <a class="enum" href="https://doc.rust-lang.org/1.82.0/core/result/enum.Result.html" title="enum core::result::Result">Result</a>&lt;<a class="primitive" href="https://doc.rust-lang.org/1.82.0/core/primitive.unit.html">()</a>, <a class="struct" href="struct.SpawnError.html" title="struct futures_util::task::SpawnError">SpawnError</a>&gt;</h4></section></div></details><details class="toggle implementors-toggle"><summary><section id="impl-LocalSpawn-for-%26mut+Sp" class="impl"><a class="src rightside" href="../../src/futures_task/spawn.rs.html#116">source</a><a href="#impl-LocalSpawn-for-%26mut+Sp" class="anchor">§</a><h3 class="code-header">impl&lt;Sp&gt; <a class="trait" href="trait.LocalSpawn.html" title="trait futures_util::task::LocalSpawn">LocalSpawn</a> for <a class="primitive" href="https://doc.rust-lang.org/1.82.0/core/primitive.reference.html">&amp;mut Sp</a><div class="where">where
Sp: <a class="trait" href="trait.LocalSpawn.html" title="trait futures_util::task::LocalSpawn">LocalSpawn</a> + ?<a class="trait" href="https://doc.rust-lang.org/1.82.0/core/marker/trait.Sized.html" title="trait core::marker::Sized">Sized</a>,</div></h3></section></summary><div class="impl-items"><section id="method.spawn_local_obj-1" class="method trait-impl"><a class="src rightside" href="../../src/futures_task/spawn.rs.html#117">source</a><a href="#method.spawn_local_obj-1" class="anchor">§</a><h4 class="code-header">fn <a href="#tymethod.spawn_local_obj" class="fn">spawn_local_obj</a>(
&amp;self,
future: <a class="struct" href="struct.LocalFutureObj.html" title="struct futures_util::task::LocalFutureObj">LocalFutureObj</a>&lt;'static, <a class="primitive" href="https://doc.rust-lang.org/1.82.0/core/primitive.unit.html">()</a>&gt;,
) -&gt; <a class="enum" href="https://doc.rust-lang.org/1.82.0/core/result/enum.Result.html" title="enum core::result::Result">Result</a>&lt;<a class="primitive" href="https://doc.rust-lang.org/1.82.0/core/primitive.unit.html">()</a>, <a class="struct" href="struct.SpawnError.html" title="struct futures_util::task::SpawnError">SpawnError</a>&gt;</h4></section><section id="method.status_local-2" class="method trait-impl"><a class="src rightside" href="../../src/futures_task/spawn.rs.html#121">source</a><a href="#method.status_local-2" class="anchor">§</a><h4 class="code-header">fn <a href="#method.status_local" class="fn">status_local</a>(&amp;self) -&gt; <a class="enum" href="https://doc.rust-lang.org/1.82.0/core/result/enum.Result.html" title="enum core::result::Result">Result</a>&lt;<a class="primitive" href="https://doc.rust-lang.org/1.82.0/core/primitive.unit.html">()</a>, <a class="struct" href="struct.SpawnError.html" title="struct futures_util::task::SpawnError">SpawnError</a>&gt;</h4></section></div></details><h2 id="implementors" class="section-header">Implementors<a href="#implementors" class="anchor">§</a></h2><div id="implementors-list"></div><script src="../../trait.impl/futures_task/spawn/trait.LocalSpawn.js" async></script></section></div></main></body></html>