Struct LitPool 

pub struct LitPool { /* private fields */ }

Literal pool implementation. One can programmatically push items in this literal pool and retrieve offsets to them in the pool. Then later, the pool will be encoded into the instruction stream and items can be retrieved using the address of the literal pool. and the previously emitted offsets. Values are always at least aligned to their size.

Implementations

impl LitPool

pub fn new() -> Self

Create a new, empty literal pool

pub fn align(&mut self, size: usize, with: u8)

Add extra alignment for the next value in the literal pool

pub fn push_u8(&mut self, value: u8) -> isize

Encode value into the literal pool.

pub fn push_u16(&mut self, value: u16) -> isize

Encode value into the literal pool.

pub fn push_u32(&mut self, value: u32) -> isize

Encode value into the literal pool.

pub fn push_u64(&mut self, value: u64) -> isize

Encode value into the literal pool.

pub fn push_dynamic( &mut self, id: DynamicLabel, size: RelocationSize, relative: bool, ) -> isize

Encode the relative address of a label into the literal pool if relative is true, the encoded value will be the difference between the target and the address of this relocation. Else, it will be the absolute address of the target.

pub fn push_global( &mut self, name: &'static str, size: RelocationSize, relative: bool, ) -> isize

Encode the relative address of a label into the literal pool if relative is true, the encoded value will be the difference between the target and the address of this relocation. Else, it will be the absolute address of the target.

pub fn push_forward( &mut self, name: &'static str, size: RelocationSize, relative: bool, ) -> isize

Encode the relative address of a label into the literal pool if relative is true, the encoded value will be the difference between the target and the address of this relocation. Else, it will be the absolute address of the target.

pub fn push_backward( &mut self, name: &'static str, size: RelocationSize, relative: bool, ) -> isize

Encode the relative address of a label into the literal pool if relative is true, the encoded value will be the difference between the target and the address of this relocation. Else, it will be the absolute address of the target.

pub fn push_absolute_as_relative( &mut self, target: usize, size: RelocationSize, ) -> isize

Encode a relative offset of an absolute address into the literal pool.

pub fn push_relative_as_absolute( &mut self, target: usize, size: RelocationSize, ) -> isize

Encode the absolute address of a relative offset into the literal pool. Note: offset is an usize, to use a negative offset the value can simply be wrapped.

pub fn emit<D: DynasmLabelApi>(self, assembler: &mut D)

Emit this literal pool into the specified assembler

Trait Implementations

impl Clone for LitPool

fn clone(&self) -> LitPool

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for LitPool

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

Formats the value using the given formatter.

impl Default for LitPool

fn default() -> LitPool

Returns the “default value” for a type.