Skip to main content

AsmError

Enum AsmError 

Source
#[non_exhaustive]
pub enum AsmError { Operand { at: usize, msg: String, }, Unsupported { at: usize, mnemonic: &'static str, target: Target, }, Layout { at: usize, msg: String, }, }
Expand description

Error returned by Asm::finish when an encoded branch, ldr literal, or adr falls outside what its Thumb encoding can represent, or when a label was referenced but never bound.

§Using this with anyhow

AsmError is Send + Sync + 'static and implements std::error::Error, which is exactly the bound on anyhow’s own blanket impl<E: Error + Send + Sync + 'static> From<E> for anyhow::Error. A bare ? on an Asm::finish() inside a function returning anyhow::Result<_> therefore already compiles — no .map_err(anyhow::Error::from), no wrapper type, nothing to opt into.

That is also why this crate has no anyhow feature and cannot grow one: a hand-written impl From<AsmError> for anyhow::Error would overlap anyhow’s blanket impl and be rejected for coherence. The feature is not withheld, it is unrepresentable — and unnecessary. The same holds for InstallMismatch.

Variants (Non-exhaustive)§

This enum is marked as 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.
§

Operand

An operand the requested encoding cannot hold: a low-register field with a high register in it, an immediate outside the encoding’s range, a blx with pc as its argument, and so on. Reported at Asm::finish with the byte position of the emitter that failed.

Fields

§at: usize

Byte position in the code buffer where the emitter tried to write.

§msg: String

Human-readable diagnostic naming the operand and the limit.

§

Unsupported

The encoding an emitter produces is not defined on the assembler’s isa::Target. Introduced in 0.14.0 alongside Asm::with_target; the only in-crate emitter that raises it today is sdiv/udiv under Target::V7A or Target::V7AR, plus raw16 and raw32 over bytes their target’s decoder does not accept.

Fields

§at: usize

Byte position in the code buffer where the refused emit happened.

§mnemonic: &'static str

Static mnemonic the emitter identifies as, e.g. "sdiv".

§target: Target

The target the assembler was built for.

§

Layout

A layout-time failure: an unbound or never-reserved label, a branch whose displacement is out of range for its encoding, a literal-pool entry too far away for ldr pc-relative’s 8-bit immediate, or an adr whose blob sits before it. These are the diagnostics Asm::finish can only report after every emitter has run — the mistake is not a bad operand, it is a missing (or geometrically impossible) call the caller has to add or move.

Fields

§at: usize

Byte position of the emitter whose fix-up could not be resolved (for branches / adr / ldr literals). Zero for never-reserved-label diagnostics that have no code position.

§msg: String

Human-readable diagnostic naming what went wrong.

Implementations§

Source§

impl AsmError

Source

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

A stable, machine-readable reason: "operand", "unsupported", or "layout". Consumers branch on this to distinguish “the operand is wrong” (fixable at the emitter’s arguments) from “the encoding is not legal on this target” (fixable by changing the target or the emitter) from “the layout does not close” (fixable at the caller’s label / branch / pool geometry).

Source

pub fn at(&self) -> usize

Byte position in the code buffer this error refers to. Zero for never-reserved-label diagnostics that have no code position.

Trait Implementations§

Source§

impl Clone for AsmError

Source§

fn clone(&self) -> Self

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

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

Performs copy-assignment from source. Read more
Source§

impl Debug for AsmError

Source§

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

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

impl Display for AsmError

Source§

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

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

impl Eq for AsmError

Source§

impl Error for AsmError

1.30.0 · Source§

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

Returns the lower-level source of this error, if any. Read more
1.0.0 · Source§

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

1.0.0 · Source§

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

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

Source§

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. Read more
Source§

impl PartialEq for AsmError

Source§

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

Equality operator ==. Read more
1.0.0 (const: unstable) · Source§

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

Inequality operator !=. Read more
Source§

impl StructuralPartialEq for AsmError

Auto Trait Implementations§

Blanket Implementations§

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<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

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> 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 = !

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, !>

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.