Struct fuel_asm::Instruction

pub struct Instruction { /* private fields */ }

A version of Opcode that can used without unnecessary branching

Implementations

impl Instruction

pub const LEN: usize

Size of an opcode in bytes

pub const fn new(instruction: u32) -> Self

Extracts fields from a raw instruction

pub const fn op(&self) -> u8

Opcode

pub const fn ra(&self) -> RegisterId

Register A

pub const fn rb(&self) -> RegisterId

Register B

pub const fn rc(&self) -> RegisterId

Register C

pub const fn rd(&self) -> RegisterId

Register D

pub const fn imm06(&self) -> Immediate06

Immediate with 6 bits

pub const fn imm12(&self) -> Immediate12

Immediate with 12 bits

pub const fn imm18(&self) -> Immediate18

Immediate with 18 bits

pub const fn imm24(&self) -> Immediate24

Immediate with 24 bits

pub unsafe fn from_slice_unchecked(buf: &[u8]) -> Self

Create a Instruction from a slice of bytes

Safety

The caller must ensure that the slice is has at least Self::LEN bytes.

pub fn to_bytes(self) -> [u8; 4]

Convert the opcode to bytes representation

pub const fn parse_word(word: Word) -> (Instruction, Instruction)

Splits a Word into two Instruction that can be used to construct crate::Opcode

pub const fn into_inner(
    self
) -> (OpcodeRepr, RegisterId, RegisterId, RegisterId, RegisterId, Word)

Convert the instruction into its internal representation

(repr, $ra, $rb, $rc, $rd, immediate)

impl Instruction

pub fn from_bytes(bytes: &[u8]) -> Result<Self>

Create a Instruction from a slice of bytes

This function will fail if the length of the bytes is smaller than Instruction::LEN.

pub fn from_bytes_iter<I>(bytes: I) -> Vec<Self> where
    I: IntoIterator<Item = u8>, 

Create a set of Instruction from an iterator of bytes

If not padded to Self::LEN, will consume the unaligned bytes but won’t try to parse an instruction from them.

Trait Implementations

impl Clone for Instruction

fn clone(&self) -> Instruction

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Instruction

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

Formats the value using the given formatter.

impl Default for Instruction

fn default() -> Instruction

Returns the “default value” for a type.

impl From<[u8; 4]> for Instruction

fn from(instruction: [u8; 4]) -> Self

Performs the conversion.

impl From<Instruction> for u32

fn from(parsed: Instruction) -> u32

Performs the conversion.

impl From<Instruction> for Opcode

fn from(parsed: Instruction) -> Self

Performs the conversion.

impl From<InstructionResult> for Instruction

fn from(r: InstructionResult) -> Self

Performs the conversion.

impl From<Opcode> for Instruction

fn from(op: Opcode) -> Self

Performs the conversion.

impl From<u32> for Instruction

fn from(instruction: u32) -> Self

Performs the conversion.

impl FromIterator<Instruction> for Vec<u8>

fn from_iter<T>(iter: T) -> Self where
    T: IntoIterator<Item = Instruction>, 

Creates a value from an iterator.

impl FromIterator<Instruction> for Vec<Opcode>

fn from_iter<T>(iter: T) -> Self where
    T: IntoIterator<Item = Instruction>, 

Creates a value from an iterator.

impl Hash for Instruction

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

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H) where
    H: Hasher, 

Feeds a slice of this type into the given Hasher.

impl PartialEq<Instruction> for Instruction

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

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=.

impl Copy for Instruction

impl Eq for Instruction

impl StructuralEq for Instruction

impl StructuralPartialEq for Instruction