Enum CallConv

pub enum CallConv {
    Fast,
    Cold,
    Tail,
    SystemV,
    WindowsFastcall,
    AppleAarch64,
    Probestack,
    Winch,
}

Calling convention identifiers.

Variants

Fast

Best performance, not ABI-stable.

Cold

Smallest caller code size, not ABI-stable.

Tail

Supports tail calls, not ABI-stable except for exception payload registers.

On exception resume, a caller to a tail-convention function assumes that the exception payload values are in the following registers (per platform):

• x86-64: rax, rdx
• aarch64: x0, x1
• riscv64: a0, a1
• pulley{32,64}: x0, x1

SystemV

System V-style convention used on many platforms.

WindowsFastcall

Windows “fastcall” convention, also used for x64 and ARM.

AppleAarch64

Mac aarch64 calling convention, which is a tweaked aarch64 ABI.

Probestack

Specialized convention for the probestack function.

Winch

The winch calling convention, not ABI-stable.

The main difference to SystemV is that the winch calling convention defines no callee-save registers, and restricts the number of return registers to one integer, and one floating point.

Implementations

impl CallConv

pub fn triple_default(triple: &Triple) -> CallConv

Return the default calling convention for the given target triple.

pub fn for_libcall(flags: &Flags, default_call_conv: CallConv) -> CallConv

Returns the calling convention used for libcalls according to the current flags.

pub fn supports_tail_calls(&self) -> bool

Does this calling convention support tail calls?

pub fn supports_exceptions(&self) -> bool

Does this calling convention support exceptions?

pub fn exception_payload_types(&self, pointer_ty: Type) -> &[Type]

What types do the exception payload value(s) have?

Note that this function applies to the callee of a try_call instruction. The calling convention of the callee may differ from the caller, but the exceptional payload types available are defined by the callee calling convention.

Also note that individual backends are responsible for reporting register destinations for exceptional types. Internally Cranelift asserts that the backend supports the exact same number of register destinations as this return value.

Trait Implementations

impl Clone for CallConv

fn clone(&self) -> CallConv

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CallConv

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for CallConv

fn deserialize<__D>( __deserializer: __D, ) -> Result<CallConv, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for CallConv

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

Formats the value using the given formatter.

impl FromStr for CallConv

type Err = ()

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<CallConv, <CallConv as FromStr>::Err>

Parses a string s to return a value of this type.

impl Hash for CallConv

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 PartialEq for CallConv

fn eq(&self, other: &CallConv) -> 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 Serialize for CallConv

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Copy for CallConv

impl Eq for CallConv

impl StructuralPartialEq for CallConv