Struct Ins

pub struct Ins {
    pub code: u32,
    pub op: Opcode,
}

A PowerPC instruction.

Fields

code: u32

op: Opcode

Implementations

impl Ins

pub fn new(code: u32, extensions: Extensions) -> Self

Create a new instruction from its raw code.

pub fn parse_simplified(self, out: &mut ParsedIns)

Parse the instruction into a simplified mnemonic, if any match.

pub fn simplified(self) -> ParsedIns

Returns the simplified form of the instruction, if any match.

pub fn parse_basic(self, out: &mut ParsedIns)

Parse the instruction into its basic form.

pub fn basic(self) -> ParsedIns

Returns the basic form of the instruction.

pub fn parse_defs(self, out: &mut Arguments)

Emits all registers defined by the instruction into the given argument list.

pub fn defs(self) -> Arguments

Returns all registers defined by the instruction.

pub fn parse_uses(self, out: &mut Arguments)

Emits all registers used by the instruction into the given argument list.

pub fn uses(self) -> Arguments

Returns all registers used by the instruction.

pub fn branch_offset(&self) -> Option<i32>

Returns the relative branch offset of the instruction, if any.

pub fn branch_dest(&self, addr: u32) -> Option<u32>

Returns the absolute branch destination of the instruction, if any.

pub fn is_branch(&self) -> bool

Whether the instruction is any kind of branch.

pub fn is_direct_branch(&self) -> bool

Whether the instruction is a direct branch.

pub fn is_unconditional_branch(&self) -> bool

Whether the instruction is an unconditional branch.

pub fn is_conditional_branch(&self) -> bool

Whether the instruction is a conditional branch.

pub fn is_blr(&self) -> bool

Whether the instruction is a branch with link. (blr)

impl Ins

pub const fn field_simm(&self) -> i16

simm: Signed Immediate

pub const fn field_uimm(&self) -> u16

uimm: Unsigned Immediate

pub const fn field_offset(&self) -> i16

offset: Branch Offset

pub const fn field_bo(&self) -> u8

BO: Branch Options

pub const fn field_bi(&self) -> u8

BI: Branch Condition Register Bit

pub const fn field_bd(&self) -> i16

BD: Branch Destination (14-bit)

pub const fn field_li(&self) -> i32

LI: Branch Destination (24-bit)

pub const fn field_sh(&self) -> u8

SH: Shift Amount

pub const fn field_mb(&self) -> u8

MB: Mask Begin

pub const fn field_me(&self) -> u8

ME: Mask End

pub const fn field_rs(&self) -> u8

rS: Source Register

pub const fn field_rd(&self) -> u8

rD: Destination Register

pub const fn field_ra(&self) -> u8

rA: Register A

pub const fn field_rb(&self) -> u8

rB: Register B

pub const fn field_sr(&self) -> u8

sr: Segment Register

pub const fn field_spr(&self) -> u16

spr: Special Purpose Register

pub const fn field_frs(&self) -> u8

frS: Source Floating-Point Register

pub const fn field_frd(&self) -> u8

frD: Destination Floating-Point Register

pub const fn field_fra(&self) -> u8

frA: Floating-Point Register A

pub const fn field_frb(&self) -> u8

frB: Floating-Point Register B

pub const fn field_frc(&self) -> u8

frC: Floating-Point Register C

pub const fn field_crbd(&self) -> u8

crbD: Condition Register Bit Destination

pub const fn field_crba(&self) -> u8

crbA: Condition Register Bit A

pub const fn field_crbb(&self) -> u8

crbB: Condition Register Bit B

pub const fn field_crfd(&self) -> u8

crfD: Condition Register Field Destination

pub const fn field_crfs(&self) -> u8

crfS: Condition Register Field Source

pub const fn field_crm(&self) -> u8

crm: Condition Register Mask

pub const fn field_nb(&self) -> u8

NB

pub const fn field_tbr(&self) -> u16

tbr: Time Base

pub const fn field_mtfsf_fm(&self) -> u8

mtfsf_FM: Field Mask for mtfsf

pub const fn field_mtfsf_imm(&self) -> u8

mtfsf_IMM: Immediate for mtfsfi

pub const fn field_spr_sprg(&self) -> u8

spr_SPRG: SPRG index for m[tf]sprg

pub const fn field_spr_bat(&self) -> u8

spr_BAT: IBAT/DBAT index for m[tf][id]bat[ul]

pub const fn field_to(&self) -> u8

TO: Bitset for tw and twi

pub const fn field_l(&self) -> u8

L: Bitset for cmp, cmpi, cmpl, cmpli

pub const fn field_sync_l(&self) -> u8

sync_L: L field for sync

pub const fn field_ds(&self) -> i16

ds: Load/Store Double Word Offset (for 64-bit instructions)

pub const fn field_sh64(&self) -> u8

SH64: Shift Amount (for 64-bit instructions)

pub const fn field_mb64(&self) -> u8

MB64: Mask Begin (for 64-bit instructions)

pub const fn field_me64(&self) -> u8

ME64: Mask End (for 64-bit instructions)

pub const fn field_mtmsrd_l(&self) -> u8

mtmsrd_L: L field for mtmsrd

pub const fn field_ps_offset(&self) -> i16

ps_offset: Paired Single Offset

pub const fn field_ps_i(&self) -> u8

ps_I

pub const fn field_ps_ix(&self) -> u8

ps_IX

pub const fn field_ps_w(&self) -> u8

ps_W

pub const fn field_ps_wx(&self) -> u8

ps_WX

pub const fn field_vsimm(&self) -> i8

vsimm: Vector Signed Immediate

pub const fn field_vuimm(&self) -> u8

vuimm: Vector Unsigned Immediate

pub const fn field_vs(&self) -> u8

vS: Vector Source Register

pub const fn field_vd(&self) -> u8

vD: Vector Destination Register

pub const fn field_va(&self) -> u8

vA: Vector Register A

pub const fn field_vb(&self) -> u8

vB: Vector Register B

pub const fn field_vc(&self) -> u8

vC: Vector Register C

pub const fn field_ds_a(&self) -> u8

ds_A: All field for ds instructions

pub const fn field_strm(&self) -> u8

STRM: Stream ID

pub const fn field_shb(&self) -> u8

SHB

pub const fn field_vds128(&self) -> u8

VDS128: VMX128 Source/Dest Register

pub const fn field_va128(&self) -> u8

VA128: VMX128 Register A

pub const fn field_vb128(&self) -> u8

VB128: VMX128 Register B

pub const fn field_vc128(&self) -> u8

VC128: VMX128 Register C

pub const fn field_perm(&self) -> u8

PERM: VMX128 Permutation

pub const fn field_d3dtype(&self) -> u8

D3DType: the packed data type

pub const fn field_vmask(&self) -> u8

VMASK: the pack mask

pub const fn field_zimm(&self) -> u8

Zimm: amount to rotate/shift left

pub const fn field_oe(&self) -> bool

OE: Field used by XO-form instructions to enable setting OV and SO in the XER.

pub const fn field_rc(&self) -> bool

Rc: Record Bit

pub const fn field_lk(&self) -> bool

LK: Link Bit

pub const fn field_aa(&self) -> bool

AA: Absolute Address Bit

pub const fn field_bp(&self) -> bool

BP: Predict branch to be taken

pub const fn field_bnp(&self) -> bool

BNP: Predict branch not to be taken (fall through)

pub const fn field_bp_nd(&self) -> bool

BP_ND: Predict branch to be taken (implicit dest for LR/CTR)

pub const fn field_t(&self) -> bool

T: Transient bit

pub const fn field_rcav(&self) -> bool

RcAV: Record Bit (AltiVec)

pub const fn field_rc128(&self) -> bool

Rc128: Record Bit (VMX128)

Trait Implementations

impl Clone for Ins

fn clone(&self) -> Ins

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Ins

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

Formats the value using the given formatter.

impl Default for Ins

fn default() -> Ins

Returns the “default value” for a type.

impl Hash for Ins

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, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for Ins

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

impl Eq for Ins

impl StructuralPartialEq for Ins