Struct Insn

pub struct Insn<'a> { /* private fields */ }

A single disassembled CPU instruction.

Detail

To learn how to get more instruction details, see InsnDetail.

Implementations

impl Insn<'_>

pub unsafe fn from_raw(insn: *const cs_insn) -> Self

Create an Insn from a raw pointer to a capstone_sys::cs_insn.

This function serves to allow integration with libraries which generate capstone_sys::cs_insn’s internally.

Safety

Note that this function is unsafe, and assumes that you know what you are doing. In particular, it generates a lifetime for the Insn from nothing, and that lifetime is in no-way actually tied to the cs_insn itself. It is the responsibility of the caller to ensure that the resulting Insn lives only as long as the cs_insn. This function assumes that the pointer passed is non-null and a valid cs_insn pointer.

The caller is fully responsible for the backing allocations lifetime, including freeing.

pub fn mnemonic(&self) -> Option<&str>

The mnemonic for the instruction. Unavailable in Diet mode.

pub fn op_str(&self) -> Option<&str>

The operand string associated with the instruction. Unavailable in Diet mode.

pub fn id(&self) -> InsnId

Access instruction id

pub fn len(&self) -> usize

Size of instruction (in bytes)

pub fn address(&self) -> u64

Instruction address

pub fn bytes(&self) -> &[u8]

Byte-level representation of the instruction

Trait Implementations

impl Debug for Insn<'_>

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

Formats the value using the given formatter.

impl Display for Insn<'_>

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

Formats the value using the given formatter.

impl From<&Insn<'_>> for OwnedInsn<'_>

fn from(insn: &Insn<'_>) -> Self

Converts to this type from the input type.