Struct Program 

pub struct Program { /* private fields */ }

Machine code with the offset of each function, the relocations against external symbols, and the call-site records.

Examples

use backend_lang::mir::Function;
use backend_lang::x86_64::{op, Emitter, SYSV};

let mut f = Function::new("f", &SYSV);
let b = f.block()?;
f.push(b, op::RET, &[])?;
let mut e = Emitter::new();
e.function(&f)?;
let program = e.finish()?;
assert_eq!(program.symbol("f"), Some(0));
// push rbp; mov rbp, rsp; pop rbp; ret
assert_eq!(program.bytes(), [0x55, 0x48, 0x89, 0xE5, 0x5D, 0xC3]);

Implementations

impl Program

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

The machine code.

Examples

use backend_lang::x86_64::Emitter;

assert!(Emitter::new().finish()?.bytes().is_empty());

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

The machine code, by value.

Examples

use backend_lang::x86_64::Emitter;

assert!(Emitter::new().finish()?.into_bytes().is_empty());

pub fn symbol(&self, name: &str) -> Option<usize>

The offset of the function named name.

Examples

use backend_lang::x86_64::Emitter;

assert_eq!(Emitter::new().finish()?.symbol("missing"), None);

pub fn symbols(&self) -> impl Iterator<Item = (&str, usize)>

Every function and its offset, in name order.

Examples

use backend_lang::x86_64::Emitter;

assert_eq!(Emitter::new().finish()?.symbols().count(), 0);

pub fn functions(&self) -> &[EmittedFunction]

Every function, in emission order, with its size, frame, and call-site records.

Examples

use backend_lang::x86_64::Emitter;

assert!(Emitter::new().finish()?.functions().is_empty());

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

The relocations against external symbols, in code order.

Examples

See Reloc.

Trait Implementations

impl Clone for Program

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Program

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

Formats the value using the given formatter.

impl Eq for Program

impl PartialEq for Program

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for Program