Struct AssemblyResult 

pub struct AssemblyResult { /* private fields */ }

The result of a successful assembly operation.

Implementations

impl AssemblyResult

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

Get the assembled bytes.

Examples

use asm_rs::{Assembler, Arch};

let mut asm = Assembler::new(Arch::X86_64);
asm.emit("nop")?;
let result = asm.finish()?;
assert_eq!(result.bytes(), &[0x90]);

pub fn into_bytes(self) -> Vec<u8>

Consume and return the bytes.

Examples

use asm_rs::{Assembler, Arch};

let mut asm = Assembler::new(Arch::X86_64);
asm.emit("ret")?;
let bytes = asm.finish()?.into_bytes();
assert_eq!(bytes, vec![0xC3]);

pub fn len(&self) -> usize

Get the byte count.

Examples

use asm_rs::{Assembler, Arch};

let mut asm = Assembler::new(Arch::X86_64);
asm.emit("nop\nret")?;
let result = asm.finish()?;
assert_eq!(result.len(), 2); // nop(1) + ret(1)

pub fn is_empty(&self) -> bool

Whether the result is empty.

Examples

use asm_rs::{Assembler, Arch};

let result = Assembler::new(Arch::X86_64).finish()?;
assert!(result.is_empty());

pub fn labels(&self) -> &[(String, u64)]

Get label addresses (name, absolute address).

Examples

use asm_rs::{Assembler, Arch};

let mut asm = Assembler::new(Arch::X86_64);
asm.emit("start: nop\nend: ret")?;
let result = asm.finish()?;
let labels = result.labels();
assert!(labels.iter().any(|(name, _)| name == "start"));
assert!(labels.iter().any(|(name, _)| name == "end"));

pub fn label_address(&self, name: &str) -> Option<u64>

Look up a label address by name.

Examples

use asm_rs::{Assembler, Arch};

let mut asm = Assembler::new(Arch::X86_64);
asm.emit("start: nop\nnop\nend: ret")?;
let result = asm.finish()?;
assert_eq!(result.label_address("start"), Some(0));
assert_eq!(result.label_address("end"), Some(2));
assert_eq!(result.label_address("missing"), None);

pub fn relocations(&self) -> &[AppliedRelocation]

Get the applied relocations — where label references were patched.

Examples

use asm_rs::{Assembler, Arch};

let mut asm = Assembler::new(Arch::X86_64);
asm.emit("target: jmp target")?;
let result = asm.finish()?;
let relocs = result.relocations();
assert!(!relocs.is_empty());
assert_eq!(relocs[0].label, "target");

pub fn base_address(&self) -> u64

Get the base address used during assembly.

Examples

use asm_rs::{Assembler, Arch};

let mut asm = Assembler::new(Arch::X86_64);
asm.base_address(0x1000);
asm.emit("nop")?;
let result = asm.finish()?;
assert_eq!(result.base_address(), 0x1000);

pub fn listing(&self) -> String

Produce a human-readable listing of address, hex bytes.

Labels are shown on their own line with their resolved address. Machine code is shown in rows of up to 8 bytes each.

Example output

00000000                  entry:
00000000  55              push rbp
00000001  4889E5          mov rbp, rsp

Trait Implementations

impl Clone for AssemblyResult

fn clone(&self) -> AssemblyResult

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AssemblyResult

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

Formats the value using the given formatter.