Enum AssembleError 

#[non_exhaustive]
pub enum AssembleError {
    Encode(EncodeError),
    BufferOverflow {
        needed: usize,
        remaining: usize,
    },
    PositionOutOfBounds {
        position: usize,
        len: usize,
    },
    WriteOutOfBounds {
        at: usize,
        len: usize,
    },
    ReadOutOfBounds {
        at: usize,
        len: usize,
    },
    RawBytesNotWordAligned {
        len: usize,
    },
    UnboundLocalLabel,
    RelocationOutOfRange {
        kind: BranchRelocKind,
        from: usize,
        to: usize,
        value: i64,
        bits: u8,
    },
    MovPseudoInvalidDestination {
        class: RegClass,
    },
    MovPseudoImmediateOutOfRange {
        class: RegClass,
        value: i64,
    },
}

Emission errors for writing encoded instructions into a caller-provided word buffer.

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.

Encode(EncodeError)

Encoding failed.

BufferOverflow

Output buffer does not have enough free words.

Fields

needed: usize

Required words for this write.

remaining: usize

Remaining free words in the buffer.

PositionOutOfBounds

Position update would move outside current emitted range.

Fields

position: usize

Requested word position.

len: usize

Current emitted length in words.

WriteOutOfBounds

In-place write would exceed current emitted range.

Fields

at: usize

Word index for the write.

len: usize

Current emitted length in words.

ReadOutOfBounds

In-place read would exceed current emitted range.

Fields

at: usize

Word index for the read.

len: usize

Current emitted length in words.

RawBytesNotWordAligned

Raw byte directive payload is not aligned to full instruction words.

Fields

len: usize

Input payload length in bytes.

UnboundLocalLabel

JIT block contains an unresolved local label.

RelocationOutOfRange

Relocation value exceeds the supported signed field width.

Fields

kind: BranchRelocKind

Relocation kind.

from: usize

Source instruction word index.

to: usize

Target instruction word index.

value: i64

Signed relocation value after kind-specific scaling.

bits: u8

Signed field width in bits.

MovPseudoInvalidDestination

MOV pseudo destination is not a general-purpose data register (Wn/Xn).

Fields

class: RegClass

Destination register class provided by the caller.

MovPseudoImmediateOutOfRange

MOV Wn, #imm immediate does not fit 32-bit materialization range.

Fields

class: RegClass

Destination register class (W for this error path).

value: i64

Immediate provided by the caller.

Trait Implementations

impl Clone for AssembleError

fn clone(&self) -> AssembleError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AssembleError

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

Formats the value using the given formatter.

impl Display for AssembleError

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

Formats the value using the given formatter.

impl From<AssembleError> for LinkPatchError

fn from(value: AssembleError) -> Self

Converts to this type from the input type.

impl From<EncodeError> for AssembleError

fn from(value: EncodeError) -> Self

Converts to this type from the input type.

impl PartialEq for AssembleError

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

impl StructuralPartialEq for AssembleError