You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
<divclass='docblock'><p>Thread-safe reference-counting pointers.</p><p>See the <ahref="struct.Arc.html"><code>Arc<T></code></a> documentation for more details.</p></div><h2id='structs' class='section-header'><ahref="#structs">Structs</a></h2>
<preclass='rust struct'>pub struct Weak<T: ?<aclass="trait" href="../../core/marker/trait.Sized.html" title="trait core::marker::Sized">Sized</a>> { /* fields omitted */ }</pre><divclass='docblock'><p>A weak version of <ahref="struct.Arc.html"><code>Arc</code></a>.</p><p><code>Weak</code> pointers do not count towards determining if the inner value should be dropped.</p><p>The typical way to obtain a <code>Weak</code> pointer is to call <ahref="struct.Arc.html#method.downgrade"><code>Arc::downgrade</code></a>.</p><p>See the <ahref="struct.Arc.html"><code>Arc</code></a> documentation for more details.</p></div><h2id='methods'>Methods</h2><h3class='impl'><spanclass='in-band'><code>impl<T> <aclass="struct" href="../../alloc/arc/struct.Weak.html" title="struct alloc::arc::Weak">Weak</a><T></code></span><spanclass='out-of-band'><divclass='ghost'></div><aclass='srclink' href='../../src/alloc/arc.rs.html#768-798' title='goto source code'>[src]</a></span></h3>
62
53
<divclass='impl-items'><h4id='method.new' class="method"><spanid='new.v' class='invisible'><code>fn <ahref='#method.new' class='fnname'>new</a>() -> <aclass="struct" href="../../alloc/arc/struct.Weak.html" title="struct alloc::arc::Weak">Weak</a><T></code><divclass='since' title='Stable since Rust version 1.10.0'>1.10.0</div></span></h4>
63
-
<divclass='docblock'><p>Constructs a new <code>Weak<T></code>, without an accompanying instance of <code>T</code>.</p>
64
-
65
-
<p>This allocates memory for <code>T</code>, but does not initialize it. Calling
66
-
<ahref="struct.Weak.html#method.upgrade"><code>upgrade</code></a> on the return value always gives
<divclass='docblock'><p>Constructs a new <code>Weak<T></code>, without an accompanying instance of <code>T</code>.</p><p>This allocates memory for <code>T</code>, but does not initialize it. Calling <ahref="struct.Weak.html#method.upgrade"><code>upgrade</code></a> on the return value always gives <ahref="../../std/option/enum.Option.html"><code>None</code></a>.</p><h1id="examples" class="section-header"><ahref="#examples">Examples</a></h1>
<divclass='docblock'><p>Upgrades the <code>Weak</code> pointer to an <ahref="struct.Arc.html"><code>Arc</code></a>, if possible.</p><p>Returns <ahref="../../std/option/enum.Option.html"><code>None</code></a> if the strong count has reached zero and the inner value was destroyed.</p><h1id="examples-1" class="section-header"><ahref="#examples-1">Examples</a></h1>
<divclass='docblock'><p>Formats the value using the given formatter.</p></div></div><h3class='impl'><spanclass='in-band'><code>impl<T: ?<aclass="trait" href="../../core/marker/trait.Sized.html" title="trait core::marker::Sized">Sized</a>> <aclass="trait" href="../../core/clone/trait.Clone.html" title="trait core::clone::Clone">Clone</a> for <aclass="struct" href="../../alloc/arc/struct.Weak.html" title="struct alloc::arc::Weak">Weak</a><T></code></span><spanclass='out-of-band'><divclass='ghost'></div><aclass='srclink' href='../../src/alloc/arc.rs.html#867-899' title='goto source code'>[src]</a></span></h3>
<divclass='docblock'><p>Makes a clone of the <code>Weak</code> pointer.</p><p>This creates another pointer to the same inner value, increasing the weak reference count.</p><h1id="examples-2" class="section-header"><ahref="#examples-2">Examples</a></h1>
<divclass='docblock'><p>Constructs a new <code>Weak<T></code>, without an accompanying instance of <code>T</code>.</p><p>This allocates memory for <code>T</code>, but does not initialize it. Calling <ahref="struct.Weak.html#method.upgrade"><code>upgrade</code></a> on the return value always gives <ahref="../../std/option/enum.Option.html"><code>None</code></a>.</p><h1id="examples-3" class="section-header"><ahref="#examples-3">Examples</a></h1>
<divclass='docblock'><p>Drops the <code>Weak</code> pointer.</p><p>This will decrement the weak reference count.</p><h1id="examples-4" class="section-header"><ahref="#examples-4">Examples</a></h1>
<preclass='rust const'>pub const HEAP: <aclass="struct" href="../../alloc/boxed/struct.ExchangeHeapSingleton.html" title="struct alloc::boxed::ExchangeHeapSingleton">ExchangeHeapSingleton</a><code> = </code><code>ExchangeHeapSingleton{_force_singleton: (),}</code></pre><divclass='stability'><divclass='stab unstable'><details><summary><spanclass=microscope>🔬</span> This is a nightly-only experimental API. (<code>box_heap </code><ahref="https://github.com/rust-lang/rust/issues/27779">#27779</a>)</summary><p>may be renamed; uncertain about custom allocator design</p>
53
-
</details></div></div><divclass='docblock'><p>A value that represents the heap. This is the default place that the <code>box</code>
54
-
keyword allocates into when no place is supplied.</p>
55
-
56
-
<p>The following two examples are equivalent:</p>
57
-
52
+
<preclass='rust const'>pub const HEAP: <aclass="struct" href="../../alloc/boxed/struct.ExchangeHeapSingleton.html" title="struct alloc::boxed::ExchangeHeapSingleton">ExchangeHeapSingleton</a><code> = </code><code>ExchangeHeapSingleton{_force_singleton: (),}</code></pre><divclass='stability'><divclass='stab unstable'><details><summary><spanclass=microscope>🔬</span> This is a nightly-only experimental API. (<code>box_heap </code><ahref="https://github.com/rust-lang/rust/issues/27779">#27779</a>)</summary><p>may be renamed; uncertain about custom allocator design</p></details></div></div><divclass='docblock'><p>A value that represents the heap. This is the default place that the <code>box</code> keyword allocates into when no place is supplied.</p><p>The following two examples are equivalent:</p>
0 commit comments