rustc_target::abi

Struct TyAndLayout

source
pub struct TyAndLayout<'a, Ty> {
    pub ty: Ty,
    pub layout: Layout<'a>,
}
Expand description

The layout of a type, alongside the type itself. Provides various type traversal APIs (e.g., recursing into fields).

Note that the layout is NOT guaranteed to always be identical to that obtained from layout_of(ty), as we need to produce layouts for which Rust types do not exist, such as enum variants or synthetic fields of enums (i.e., discriminants) and wide pointers.

Fields§

§ty: Ty§layout: Layout<'a>

Implementations§

source§

impl<'a, Ty> TyAndLayout<'a, Ty>

source

pub fn is_aggregate(&self) -> bool

Returns true if this is an aggregate type (including a ScalarPair!)

source

pub fn homogeneous_aggregate<C>( &self, cx: &C, ) -> Result<HomogeneousAggregate, Heterogeneous>
where Ty: TyAbiInterface<'a, C> + Copy,

Returns Homogeneous if this layout is an aggregate containing fields of only a single type (e.g., (u32, u32)). Such aggregates are often special-cased in ABIs.

Note: We generally ignore 1-ZST fields when computing this value (see #56877).

This is public so that it can be used in unit tests, but should generally only be relevant to the ABI details of specific targets.

source§

impl<'a, Ty> TyAndLayout<'a, Ty>

source

pub fn for_variant<C>( self, cx: &C, variant_index: VariantIdx, ) -> TyAndLayout<'a, Ty>
where Ty: TyAbiInterface<'a, C>,

source

pub fn field<C>(self, cx: &C, i: usize) -> TyAndLayout<'a, Ty>
where Ty: TyAbiInterface<'a, C>,

source

pub fn pointee_info_at<C>(self, cx: &C, offset: Size) -> Option<PointeeInfo>
where Ty: TyAbiInterface<'a, C>,

source

pub fn is_single_fp_element<C>(self, cx: &C) -> bool
where Ty: TyAbiInterface<'a, C>, C: HasDataLayout,

source

pub fn is_adt<C>(self) -> bool
where Ty: TyAbiInterface<'a, C>,

source

pub fn is_never<C>(self) -> bool
where Ty: TyAbiInterface<'a, C>,

source

pub fn is_tuple<C>(self) -> bool
where Ty: TyAbiInterface<'a, C>,

source

pub fn is_unit<C>(self) -> bool
where Ty: TyAbiInterface<'a, C>,

source

pub fn is_transparent<C>(self) -> bool
where Ty: TyAbiInterface<'a, C>,

source

pub fn non_1zst_field<C>(&self, cx: &C) -> Option<(usize, TyAndLayout<'a, Ty>)>
where Ty: TyAbiInterface<'a, C> + Copy,

Finds the one field that is not a 1-ZST. Returns None if there are multiple non-1-ZST fields or only 1-ZST-fields.

Methods from Deref<Target = &'a LayoutS<FieldIdx, VariantIdx>>§

source

pub fn is_unsized(&self) -> bool

Returns true if the layout corresponds to an unsized type.

source

pub fn is_sized(&self) -> bool

source

pub fn is_1zst(&self) -> bool

Returns true if the type is sized and a 1-ZST (meaning it has size 0 and alignment 1).

source

pub fn is_zst(&self) -> bool

Returns true if the type is a ZST and not unsized.

Note that this does not imply that the type is irrelevant for layout! It can still have non-trivial alignment constraints. You probably want to use is_1zst instead.

source

pub fn eq_abi(&self, other: &LayoutS<FieldIdx, VariantIdx>) -> bool

Checks if these two Layout are equal enough to be considered “the same for all function call ABIs”. Note however that real ABIs depend on more details that are not reflected in the Layout; the PassMode need to be compared as well. Also note that we assume aggregates are passed via PassMode::Indirect or PassMode::Cast; more strict checks would otherwise be required.

Trait Implementations§

source§

impl<'a, Ty> Clone for TyAndLayout<'a, Ty>
where Ty: Clone,

source§

fn clone(&self) -> TyAndLayout<'a, Ty>

Returns a copy of the value. Read more
source§

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source. Read more
source§

impl<'a, Ty> Debug for TyAndLayout<'a, Ty>
where Ty: Display,

source§

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter. Read more
source§

impl<'a, Ty> Deref for TyAndLayout<'a, Ty>

source§

type Target = &'a LayoutS<FieldIdx, VariantIdx>

The resulting type after dereferencing.
source§

fn deref(&self) -> &&'a LayoutS<FieldIdx, VariantIdx>

Dereferences the value.
source§

impl<'a, Ty> Hash for TyAndLayout<'a, Ty>
where Ty: Hash,

source§

fn hash<__H>(&self, state: &mut __H)
where __H: Hasher,

Feeds this value into the given Hasher. Read more
source§

fn hash_slice<H>(data: &[Self], state: &mut H)
where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher. Read more
source§

impl<'a, Ty, __CTX> HashStable<__CTX> for TyAndLayout<'a, Ty>
where __CTX: HashStableContext, Ty: HashStable<__CTX>,

source§

fn hash_stable( &self, __hcx: &mut __CTX, __hasher: &mut StableHasher<SipHasher128>, )

source§

impl<'a, Ty> PartialEq for TyAndLayout<'a, Ty>
where Ty: PartialEq,

source§

fn eq(&self, other: &TyAndLayout<'a, Ty>) -> bool

Tests for self and other values to be equal, and is used by ==.
source§

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.
source§

impl<'a, Ty> Copy for TyAndLayout<'a, Ty>
where Ty: Copy,

source§

impl<'a, Ty> Eq for TyAndLayout<'a, Ty>
where Ty: Eq,

source§

impl<'a, Ty> StructuralPartialEq for TyAndLayout<'a, Ty>

Auto Trait Implementations§

§

impl<'a, Ty> DynSend for TyAndLayout<'a, Ty>
where Ty: DynSend,

§

impl<'a, Ty> DynSync for TyAndLayout<'a, Ty>
where Ty: DynSync,

§

impl<'a, Ty> Freeze for TyAndLayout<'a, Ty>
where Ty: Freeze,

§

impl<'a, Ty> RefUnwindSafe for TyAndLayout<'a, Ty>
where Ty: RefUnwindSafe,

§

impl<'a, Ty> Send for TyAndLayout<'a, Ty>
where Ty: Send,

§

impl<'a, Ty> Sync for TyAndLayout<'a, Ty>
where Ty: Sync,

§

impl<'a, Ty> Unpin for TyAndLayout<'a, Ty>
where Ty: Unpin,

§

impl<'a, Ty> UnwindSafe for TyAndLayout<'a, Ty>
where Ty: UnwindSafe,

Blanket Implementations§

source§

impl<T> Aligned for T

source§

const ALIGN: Alignment = _

Alignment of Self.
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> CloneToUninit for T
where T: Clone,

source§

unsafe fn clone_to_uninit(&self, dst: *mut T)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dst. Read more
source§

impl<Q, K> Equivalent<K> for Q
where Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,

source§

fn equivalent(&self, key: &K) -> bool

Checks if this value is equivalent to the given key. Read more
source§

impl<Q, K> Equivalent<K> for Q
where Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,

source§

fn equivalent(&self, key: &K) -> bool

Checks if this value is equivalent to the given key. Read more
source§

impl<Q, K> Equivalent<K> for Q
where Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,

source§

fn equivalent(&self, key: &K) -> bool

Compare self to key and return true if they are equal.
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

source§

impl<T> Instrument for T

source§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
source§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
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.

source§

impl<T> IntoEither for T

source§

fn into_either(self, into_left: bool) -> Either<Self, Self>

Converts self into a Left variant of Either<Self, Self> if into_left is true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
source§

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
where F: FnOnce(&Self) -> bool,

Converts self into a Left variant of Either<Self, Self> if into_left(&self) returns true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
source§

impl<T> Pointable for T

source§

const ALIGN: usize = _

The alignment of pointer.
source§

type Init = T

The type for initializers.
source§

unsafe fn init(init: <T as Pointable>::Init) -> usize

Initializes a with the given initializer. Read more
source§

unsafe fn deref<'a>(ptr: usize) -> &'a T

Dereferences the given pointer. Read more
source§

unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T

Mutably dereferences the given pointer. Read more
source§

unsafe fn drop(ptr: usize)

Drops the object pointed to by the given pointer. Read more
source§

impl<T> Same for T

source§

type Output = T

Should always be Self
source§

impl<T> ToOwned for T
where T: Clone,

source§

type Owned = T

The resulting type after obtaining ownership.
source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
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.
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.
source§

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

source§

fn vzip(self) -> V

source§

impl<T> WithSubscriber for T

source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
source§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more
source§

impl<'a, T> Captures<'a> for T
where T: ?Sized,

Layout§

Note: Unable to compute type layout, possibly due to this type having generic parameters. Layout can only be computed for concrete, fully-instantiated types.