Struct ArgAbi

pub(crate) struct ArgAbi<'a, Ty> {
    pub layout: TyAndLayout<'a, Ty>,
    pub mode: PassMode,
}

Information about how to pass an argument to, or return a value from, a function, under some ABI.

Fields

layout: TyAndLayout<'a, Ty>

mode: PassMode

Implementations

impl<'a, Ty> ArgAbi<'a, Ty>

pub fn new( cx: &impl HasDataLayout, layout: TyAndLayout<'a, Ty>, scalar_attrs: impl Fn(&TyAndLayout<'a, Ty>, Scalar, Size) -> ArgAttributes, ) -> ArgAbi<'a, Ty>

This defines the “default ABI” for that type, that is then later adjusted in fn_abi_adjust_for_abi.

pub fn make_direct_deprecated(&mut self)

Pass this argument directly instead. Should NOT be used! Only exists because of past ABI mistakes that will take time to fix (see https://github.com/rust-lang/rust/issues/115666).

pub fn make_indirect(&mut self)

Pass this argument indirectly, by passing a (thin or wide) pointer to the argument instead. This is valid for both sized and unsized arguments.

pub fn make_indirect_from_ignore(&mut self)

Same as make_indirect, but for arguments that are ignored. Only needed for ABIs that pass ZSTs indirectly.

pub fn pass_by_stack_offset(&mut self, byval_align: Option<Align>)

Pass this argument indirectly, by placing it at a fixed stack offset. This corresponds to the byval LLVM argument attribute. This is only valid for sized arguments.

byval_align specifies the alignment of the byval stack slot, which does not need to correspond to the type’s alignment. This will be Some if the target’s ABI specifies that stack slots used for arguments passed by-value have specific alignment requirements which differ from the alignment used in other situations.

If None, the type’s alignment is used.

If the resulting alignment differs from the type’s alignment, the argument will be copied to an alloca with sufficient alignment, either in the caller (if the type’s alignment is lower than the byval alignment) or in the callee (if the type’s alignment is higher than the byval alignment), to ensure that Rust code never sees an underaligned pointer.

pub fn extend_integer_width_to(&mut self, bits: u64)

pub fn cast_to<T>(&mut self, target: T)

where T: Into<CastTarget>,

pub fn cast_to_and_pad_i32<T>(&mut self, target: T, pad_i32: bool)

where T: Into<CastTarget>,

pub fn is_indirect(&self) -> bool

pub fn is_sized_indirect(&self) -> bool

pub fn is_unsized_indirect(&self) -> bool

pub fn is_ignore(&self) -> bool

pub fn eq_abi(&self, other: &ArgAbi<'a, Ty>) -> bool

where Ty: PartialEq,

Checks if these two ArgAbi are equal enough to be considered “the same for all function call ABIs”.

Trait Implementations

impl<'ll, 'tcx> ArgAbiExt<'ll, 'tcx> for ArgAbi<'tcx, Ty<'tcx>>

fn memory_ty(&self, cx: &CodegenCx<'ll, 'tcx>) -> &'ll Type

Gets the LLVM type for a place of the original Rust type of this argument/return, i.e., the result of type_of::type_of.

fn store( &self, bx: &mut Builder<'_, 'll, 'tcx>, val: &'ll Value, dst: PlaceRef<'tcx, &'ll Value>, )

Stores a direct/indirect value described by this ArgAbi into a place for the original Rust type of this argument/return. Can be used for both storing formal arguments into Rust variables or results of call/invoke instructions into their destinations.

fn store_fn_arg( &self, bx: &mut Builder<'_, 'll, 'tcx>, idx: &mut usize, dst: PlaceRef<'tcx, &'ll Value>, )

impl<'a, Ty> Clone for ArgAbi<'a, Ty>

where Ty: Clone,

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

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<'a, Ty> Debug for ArgAbi<'a, Ty>

where Ty: Display,

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

Formats the value using the given formatter.

impl<'a, Ty> Hash for ArgAbi<'a, Ty>

where Ty: Hash,

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

where __H: Hasher,

Feeds this value into the given Hasher.

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

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl<'a, Ty, __CTX> HashStable<__CTX> for ArgAbi<'a, Ty>

where __CTX: HashStableContext, Ty: HashStable<__CTX>,

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

impl<'a, Ty> PartialEq for ArgAbi<'a, Ty>

where Ty: PartialEq,

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

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

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

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

impl<'a, Ty> Eq for ArgAbi<'a, Ty>

where Ty: Eq,

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

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.