#[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
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
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
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.
Implementations§
Source§impl AsmError
impl AsmError
Sourcepub fn reason(&self) -> &'static str
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).
Trait Implementations§
impl Eq for AsmError
Source§impl Error for AsmError
impl Error for AsmError
1.30.0 · Source§fn source(&self) -> Option<&(dyn Error + 'static)>
fn source(&self) -> Option<&(dyn Error + 'static)>
1.0.0 · Source§fn description(&self) -> &str
fn description(&self) -> &str
use the Display impl or to_string()