Skip to main content

ManuallyDrop

Struct ManuallyDrop 

Source
pub struct ManuallyDrop<T: TrackDrop>(pub T);
Expand description

Linear-drop obligation wrapper. ManuallyDrop::new(t, regions) consumes the State-side obligation entry for t.key() (via T::consume_obligation) and wraps the value. The wrapper carries only the value — no embedded obligation — and can be silently dropped affinely; the linear-drop guarantee comes from the State-side ledger.

The precondition consume_requires (e.g. `frame_obligations.count(idx)

0for Frame) is the load-bearing safety check: callers must establish an outstanding obligation entry att.key(). Producers like Frame::from_raw, Frame::clone, Frame::from_unused, Frame::from_in_use` mint that entry. The mint + consume pair is net-zero on the ledger — “the borrow ends here.”

§Unsoundness warning

It is unsound to extract the inner T from ManuallyDrop<T> via take/into_inner-style operations without minting a fresh obligation at the extraction site. A ManuallyDrop<T> carries no obligation, so the extracted T would have none either — but T::drop (e.g. Frame::drop) requires an obligation as input, so the extracted value cannot legally be dropped. Any extraction site must mint a fresh entry into the State-side ledger, gated by a soundness justification (typically ref_count >= 1 for MD<Frame>, mirroring Frame::from_raw’s safety condition).

At the time of this redesign no ostd callsite extracts a Frame from a ManuallyDrop<Frame> (only Deref borrows are taken; the one into_inner is on MD<Arc<T>>, not MD<Frame>). Adding such an extraction without the matching mint resurrects the double-counting bug that motivated this redesign.

Tuple Fields§

§0: T

Implementations§

Source§

impl<T: TrackDrop> ManuallyDrop<T>

Source

pub exec fn new(t: T, Tracked(s): Tracked<&mut T::State>) -> res : Self

requires
t.consume_requires(*old(s), t.key()),
ensures
t.consume_ensures(*old(s), *final(s), t.key()),
res.0 == t,

Trait Implementations§

Source§

impl<T: TrackDrop> Deref for ManuallyDrop<T>

Source§

exec fn deref(&self) -> res : &Self::Target

ensures
res == &self.0,
Source§

type Target = T

The resulting type after dereferencing.
Source§

impl<T: TrackDrop> View for ManuallyDrop<T>

Source§

open spec fn view(&self) -> res : Self::V

{ self.0 }
Source§

type V = T

Auto Trait Implementations§

§

impl<T> Freeze for ManuallyDrop<T>
where T: Freeze,

§

impl<T> RefUnwindSafe for ManuallyDrop<T>
where T: RefUnwindSafe,

§

impl<T> Send for ManuallyDrop<T>
where T: Send,

§

impl<T> Sync for ManuallyDrop<T>
where T: Sync,

§

impl<T> Unpin for ManuallyDrop<T>
where T: Unpin,

§

impl<T> UnsafeUnpin for ManuallyDrop<T>
where T: UnsafeUnpin,

§

impl<T> UnwindSafe for ManuallyDrop<T>
where T: UnwindSafe,

Blanket Implementations§

Source§

impl<T> DerefSpec for T
where T: Deref,

Source§

uninterp spec fn deref_spec(&self) -> &<T as Deref>::Target

👎Deprecated: If you can, do not use this module as it adds assumptions about the core of Rust’s deref semantics.
Source§

proof fn deref_spec_eq(&self)

👎Deprecated: If you can, do not use this module as it adds assumptions about the core of Rust’s deref semantics.
Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

§

impl<T, VERUS_SPEC__A> FromSpec<T> for VERUS_SPEC__A
where VERUS_SPEC__A: From<T>,

§

fn obeys_from_spec() -> bool

§

fn from_spec(v: T) -> VERUS_SPEC__A

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

§

impl<T, VERUS_SPEC__A> IntoSpec<T> for VERUS_SPEC__A
where VERUS_SPEC__A: Into<T>,

§

fn obeys_into_spec() -> bool

§

fn into_spec(self) -> T

§

impl<T, U> IntoSpecImpl<U> for T
where U: From<T>,

§

fn obeys_into_spec() -> bool

§

fn into_spec(self) -> U

Source§

impl<P, T> Receiver for P
where P: Deref<Target = T> + ?Sized, T: ?Sized,

Source§

type Target = T

🔬This is a nightly-only experimental API. (arbitrary_self_types)
The target type on which the method may be called.
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
§

impl<T, VERUS_SPEC__A> TryFromSpec<T> for VERUS_SPEC__A
where VERUS_SPEC__A: TryFrom<T>,

§

fn obeys_try_from_spec() -> bool

§

fn try_from_spec( v: T, ) -> Result<VERUS_SPEC__A, <VERUS_SPEC__A as TryFrom<T>>::Error>

Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
§

impl<T, VERUS_SPEC__A> TryIntoSpec<T> for VERUS_SPEC__A
where VERUS_SPEC__A: TryInto<T>,

§

fn obeys_try_into_spec() -> bool

§

fn try_into_spec(self) -> Result<T, <VERUS_SPEC__A as TryInto<T>>::Error>

§

impl<T, U> TryIntoSpecImpl<U> for T
where U: TryFrom<T>,

§

fn obeys_try_into_spec() -> bool

§

fn try_into_spec(self) -> Result<U, <U as TryFrom<T>>::Error>

§

impl<A> SpecEq<&A> for A
where A: ?Sized,

§

impl<A> SpecEq<&mut A> for A
where A: ?Sized,

§

impl<A> SpecEq<A> for A
where A: ?Sized,

§

impl<A> SpecEq<Ghost<A>> for A

§

impl<A> SpecEq<Tracked<A>> for A