Struct faucon_asm::disassembler::Disassembler

pub struct Disassembler<W> { /* fields omitted */ }

A disassembler that pretty-prints assembly instruction mnemonics with their raw bytes and memory addresses.

Implementations

impl<W> Disassembler<W>

pub fn new(output: W) -> Self

Creates a new Disassembler that will write the disassembled code to the given output.

pub fn with_base(self, base: u32) -> Self

Sets the starting address to disassemble from to the given base.

impl Disassembler<Stdout>

pub fn stdout() -> Self

Creates a new disassembler that will print out the disassembled code to stdout.

impl<W: Write> Disassembler<W>

pub fn disassemble_stream<R: Read>(&mut self, stream: &mut R) -> Result<()>

Disassembles a stream of bytes.

This method will not return an error if an unknown or invalid instruction is encountered, but instead just prints [aborted] (invalid instruction) to the output stream.

It will also ignore any errors that occurred while reading from stream.

pub fn disassemble(
    &mut self,
    insns: impl IntoIterator<Item = Instruction>
) -> Result<()>

Disassembles a list of instructions and writes them to the output of this Disassembler.

This method will not reset the inner pc, so if you call it multiple times, the addresses will still increase.

Panics

If the Instruction objects yielded by the iterator do not have their raw byte representations assigned to them via Instruction::raw_bytes, this method will panic.