Enum AotError 

#[non_exhaustive]
pub enum AotError {
    Codegen(CodegenError),
    Link(LinkError),
}

The reason an ahead-of-time compile could not be completed.

A compile runs two stages — lower each function to object code, then link the objects into an image — and either stage can fail. The two variants keep the origin of a failure visible instead of flattening both into one opaque message, and each carries the underlying error so the exact cause can be inspected or reported without guesswork.

AotError implements Display and core::error::Error, with source set to the wrapped error, and converts from both underlying errors so ? propagates them directly. The enum is #[non_exhaustive]: a later stage that reports a new kind of failure is an additive change, so a match on it must keep a wildcard arm.

Examples

A malformed function is rejected during lowering, before any linking happens:

use aot_lang::{compile, AotError};
use ir_lang::{Builder, Type};

// Declares an int return but never returns a value.
let func = Builder::new("bad", &[], Type::Int).finish();

assert!(matches!(compile(&func), Err(AotError::Codegen(_))));

Inspect the source through the Error trait:

use aot_lang::compile;
use core::error::Error;
use ir_lang::{Builder, Type};

let func = Builder::new("bad", &[], Type::Int).finish();
let err = compile(&func).unwrap_err();
assert!(err.source().is_some());

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Codegen(CodegenError)

A function could not be lowered to object code. The wrapped CodegenError names the offending block or value; the usual cause is IR that does not pass Function::validate.

Link(LinkError)

The objects could not be linked into an image. The wrapped LinkError points at the symbol, section, or relocation involved — most often a duplicate function name or an undefined entry point.

Trait Implementations

impl Clone for AotError

fn clone(&self) -> AotError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AotError

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for AotError

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for AotError

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

Formats the value using the given formatter.

impl Error for AotError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<CodegenError> for AotError

fn from(err: CodegenError) -> Self

Converts to this type from the input type.

impl From<LinkError> for AotError

fn from(err: LinkError) -> Self

Converts to this type from the input type.

impl PartialEq for AotError

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

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for AotError