Struct bad64::Instruction

pub struct Instruction { /* fields omitted */ }

A decoded instruction

Implementations

impl Instruction

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

Returns the instruction mnemonic

Example

use bad64::decode;
// nop - "\x1f\x20\x03\xd4"
let decoded = decode(0xd503201f, 0x1000).unwrap();
assert_eq!(decoded.mnem(), "nop");

pub fn address(&self) -> u64

Returns the instruction address

Example

use bad64::decode;
// nop - "\x1f\x20\x03\xd4"
let decoded = decode(0xd503201f, 0x1000).unwrap();
assert_eq!(decoded.address(), 0x1000);

pub fn operation(&self) -> Operation

Returns the instruction operation

Example

use bad64::{decode, Operation};
// nop - "\x1f\x20\x03\xd4"
let decoded = decode(0xd503201f, 0x1000).unwrap();
assert_eq!(decoded.operation(), Operation::NOP);

pub fn operand(&self, n: usize) -> Option<Operand>

Returns an instruction operand

Arguments

• n - returns the nth operand

Example

use bad64::{decode, Imm, Operation, Operand, Reg};
// add x0, x1, #0x41  - "\x20\x04\x01\x91"
let decoded = decode(0x91010420, 0x1000).unwrap();

assert_eq!(decoded.operation(), Operation::ADD);
assert_eq!(decoded.num_operands(), 3);
assert_eq!(decoded.operand(0), Some(Operand::Reg { reg: Reg::X0, shift: None }));
assert_eq!(decoded.operand(1), Some(Operand::Reg { reg: Reg::X1, shift: None }));
assert_eq!(decoded.operand(2), Some(Operand::Imm64 { imm: Imm { neg: false, val: 0x41 }, shift: None }));
assert_eq!(decoded.operand(3), None);

pub fn num_operands(&self) -> usize

Returns the operand count

Example

use bad64::{decode, Operation};
// eor x0, x1, x2  - "\x20\x00\x02\xca"
let decoded = decode(0xca020020, 0x1000).unwrap();

assert_eq!(decoded.num_operands(), 3);

pub fn operands(&self) -> &[Operand]

Returns a slice of Operands

Example

use bad64::{decode, Operand, Reg};

// eor x0, x1, x2  - "\x20\x00\x02\xca"
let decoded = decode(0xca020020, 0x1000).unwrap();

let mut ops = decoded.operands();

assert_eq!(ops.len(), decoded.num_operands());
assert_eq!(ops[0], Operand::Reg { reg: Reg::X0, shift: None });
assert_eq!(ops[1], Operand::Reg { reg: Reg::X1, shift: None });
assert_eq!(ops[2], Operand::Reg { reg: Reg::X2, shift: None });

Trait Implementations

impl Clone for Instruction

fn clone(&self) -> Instruction

Returns a copy of the value.

pub 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 Eq for Instruction

impl Hash for Instruction

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

Feeds this value into the given Hasher.

pub 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: &Self) -> bool

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

#[must_use]pub fn ne(&self, other: &Rhs) -> bool

This method tests for !=.