Enum ExternAbi

Source
pub enum ExternAbi {
Show 27 variants C { unwind: bool, }, System { unwind: bool, }, Rust, RustCall, RustCold, RustInvalid, Unadjusted, Custom, EfiApi, Aapcs { unwind: bool, }, CmseNonSecureCall, CmseNonSecureEntry, GpuKernel, PtxKernel, AvrInterrupt, AvrNonBlockingInterrupt, Msp430Interrupt, RiscvInterruptM, RiscvInterruptS, X86Interrupt, Cdecl { unwind: bool, }, Stdcall { unwind: bool, }, Fastcall { unwind: bool, }, Thiscall { unwind: bool, }, Vectorcall { unwind: bool, }, SysV64 { unwind: bool, }, Win64 { unwind: bool, },
}
Expand description

ABI we expect to see within extern "{abi}"

Variants§

§

C

presumed C ABI for the platform

Fields

§unwind: bool
§

System

ABI of the “system” interface, e.g. the Win32 API, always “aliasing”

Fields

§unwind: bool
§

Rust

that’s us!

§

RustCall

the mostly-unused unboxed_closures ABI, effectively now an impl detail unless someone puts in the work to make it viable again… but would we need a special ABI?

§

RustCold

For things unlikely to be called, where reducing register pressure in extern "Rust" callers is worth paying extra cost in the callee. Stronger than just #[cold] because fn pointers might be incompatible.

§

RustInvalid

An always-invalid ABI that’s used to test “this ABI is not supported by this platform” in a platform-agnostic way.

§

Unadjusted

Unstable impl detail that directly uses Rust types to describe the ABI to LLVM. Even normally-compatible Rust types can become ABI-incompatible with this ABI!

§

Custom

An ABI that rustc does not know how to call or define. Functions with this ABI can only be created using #[naked] functions or extern "custom" blocks, and can only be called from inline assembly.

§

EfiApi

UEFI ABI, usually an alias of C, but sometimes an arch-specific alias and only valid on platforms that have a UEFI standard

§

Aapcs

Arm Architecture Procedure Call Standard, sometimes ExternAbi::C is an alias for this

Fields

§unwind: bool
§

CmseNonSecureCall

extremely constrained barely-C ABI for TrustZone

§

CmseNonSecureEntry

extremely constrained barely-C ABI for TrustZone

§

GpuKernel

An entry-point function called by the GPU’s host

§

PtxKernel

An entry-point function called by the GPU’s host

§

AvrInterrupt

§

AvrNonBlockingInterrupt

§

Msp430Interrupt

§

RiscvInterruptM

§

RiscvInterruptS

§

X86Interrupt

§

Cdecl

ExternAbi::C but spelled funny because x86

Fields

§unwind: bool
§

Stdcall

gnu-stdcall on “unix” and win-stdcall on “windows”

Fields

§unwind: bool
§

Fastcall

gnu-fastcall on “unix” and win-fastcall on “windows”

Fields

§unwind: bool
§

Thiscall

windows C++ ABI

Fields

§unwind: bool
§

Vectorcall

uses AVX and stuff

Fields

§unwind: bool
§

SysV64

Fields

§unwind: bool
§

Win64

Fields

§unwind: bool

Implementations§

Source§

impl ExternAbi

Source

pub const ALL_VARIANTS: &[Self]

Source

pub const fn as_str(&self) -> &'static str

Source§

impl ExternAbi

Source

pub fn is_rustic_abi(self) -> bool

An ABI “like Rust”

These ABIs are fully controlled by the Rust compiler, which means they

  • support unwinding with -Cpanic=unwind, unlike extern "C"
  • often diverge from the C ABI
  • are subject to change between compiler versions
Source

pub fn supports_varargs(self) -> bool

Source§

impl ExternAbi

Source

pub const FALLBACK: ExternAbi

Default ABI chosen for extern fn declarations without an explicit ABI.

Source

pub fn name(self) -> &'static str

Trait Implementations§

Source§

impl Clone for ExternAbi

Source§

fn clone(&self) -> ExternAbi

Returns a duplicate of the value. Read more
1.0.0 · Source§

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

Performs copy-assignment from source. Read more
Source§

impl Debug for ExternAbi

Source§

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

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

impl<__D: SpanDecoder> Decodable<__D> for ExternAbi

Source§

fn decode(__decoder: &mut __D) -> Self

Source§

impl Display for ExternAbi

Source§

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

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

impl<__E: SpanEncoder> Encodable<__E> for ExternAbi

Source§

fn encode(&self, __encoder: &mut __E)

Source§

impl FromStr for ExternAbi

Source§

type Err = AbiFromStrErr

The associated error which can be returned from parsing.
Source§

fn from_str(s: &str) -> Result<ExternAbi, Self::Err>

Parses a string s to return a value of this type. Read more
Source§

impl Hash for ExternAbi

Source§

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

Feeds this value into the given Hasher. Read more
1.3.0 · 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<C> HashStable<C> for ExternAbi

Source§

fn hash_stable(&self, _: &mut C, hasher: &mut StableHasher)

Source§

impl Ord for ExternAbi

Source§

fn cmp(&self, rhs: &Self) -> Ordering

This method returns an Ordering between self and other. Read more
1.21.0 · Source§

fn max(self, other: Self) -> Self
where Self: Sized,

Compares and returns the maximum of two values. Read more
1.21.0 · Source§

fn min(self, other: Self) -> Self
where Self: Sized,

Compares and returns the minimum of two values. Read more
1.50.0 · Source§

fn clamp(self, min: Self, max: Self) -> Self
where Self: Sized,

Restrict a value to a certain interval. Read more
Source§

impl PartialEq for ExternAbi

Source§

fn eq(&self, rhs: &Self) -> bool

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

const 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 PartialOrd for ExternAbi

Source§

fn partial_cmp(&self, rhs: &Self) -> Option<Ordering>

This method returns an ordering between self and other values if one exists. Read more
1.0.0 · Source§

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

Tests less than (for self and other) and is used by the < operator. Read more
1.0.0 · Source§

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

Tests less than or equal to (for self and other) and is used by the <= operator. Read more
1.0.0 · Source§

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

Tests greater than (for self and other) and is used by the > operator. Read more
1.0.0 · Source§

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

Tests greater than or equal to (for self and other) and is used by the >= operator. Read more
Source§

impl StableOrd for ExternAbi

Source§

const CAN_USE_UNSTABLE_SORT: bool = true

Source§

const THIS_IMPLEMENTATION_HAS_BEEN_TRIPLE_CHECKED: () = ()

Marker to ensure that implementors have carefully considered whether their Ord implementation obeys this trait’s contract.
Source§

impl Copy for ExternAbi

Source§

impl Eq for ExternAbi

Auto Trait Implementations§

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, dest: *mut u8)

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

impl<Q, K> Comparable<K> for Q
where Q: Ord + ?Sized, K: Borrow<Q> + ?Sized,

Source§

fn compare(&self, key: &K) -> Ordering

Compare self to key and return their ordering.
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> StableCompare for T
where T: StableOrd,

Source§

const CAN_USE_UNSTABLE_SORT: bool = T::CAN_USE_UNSTABLE_SORT

Source§

fn stable_cmp(&self, other: &T) -> Ordering

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> ToString for T
where T: Display + ?Sized,

Source§

fn to_string(&self) -> String

Converts the given value to a String. 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

Layout§

Note: Most layout information is completely unstable and may even differ between compilations. The only exception is types with certain repr(...) attributes. Please see the Rust Reference's “Type Layout” chapter for details on type layout guarantees.

Size: 2 bytes

Size for each variant:

  • C: 1 byte
  • System: 1 byte
  • Rust: 0 bytes
  • RustCall: 0 bytes
  • RustCold: 0 bytes
  • RustInvalid: 0 bytes
  • Unadjusted: 0 bytes
  • Custom: 0 bytes
  • EfiApi: 0 bytes
  • Aapcs: 1 byte
  • CmseNonSecureCall: 0 bytes
  • CmseNonSecureEntry: 0 bytes
  • GpuKernel: 0 bytes
  • PtxKernel: 0 bytes
  • AvrInterrupt: 0 bytes
  • AvrNonBlockingInterrupt: 0 bytes
  • Msp430Interrupt: 0 bytes
  • RiscvInterruptM: 0 bytes
  • RiscvInterruptS: 0 bytes
  • X86Interrupt: 0 bytes
  • Cdecl: 1 byte
  • Stdcall: 1 byte
  • Fastcall: 1 byte
  • Thiscall: 1 byte
  • Vectorcall: 1 byte
  • SysV64: 1 byte
  • Win64: 1 byte