Struct dynasmrt::components::LabelRegistry

pub struct LabelRegistry { /* private fields */ }

A registry of labels. Contains all necessessities for keeping track of dynasm labels. This is useful when implementing your own assembler and can also be used to query assemblers for the offsets of labels.

Implementations

impl LabelRegistry

pub fn new() -> LabelRegistry

Create a new, empty label registry

pub fn with_capacity( locals: usize, globals: usize, dynamics: usize, ) -> LabelRegistry

Create a new, empty label registry with capacity space for each different label type.

pub fn clear(&mut self)

Clears the internal contents of this label registry, while maintaining the backing allocations.

pub fn new_dynamic_label(&mut self) -> DynamicLabel

Create a new dynamic label id

pub fn define_dynamic( &mut self, id: DynamicLabel, offset: AssemblyOffset, ) -> Result<(), DynasmError>

Define a the dynamic label id to be located at offset.

pub fn define_global( &mut self, name: &'static str, offset: AssemblyOffset, ) -> Result<(), DynasmError>

Define a the global label name to be located at offset.

pub fn define_local(&mut self, name: &'static str, offset: AssemblyOffset)

Define a the local label name to be located at offset.

pub fn place_local_reference(&self, name: &'static str) -> Option<StaticLabel>

Turns a local label into a static label, by adding some extra information to it so we know what local label it is even after another has been defined

pub fn resolve_dynamic( &self, id: DynamicLabel, ) -> Result<AssemblyOffset, DynasmError>

Returns the offset at which the dynamic label id was defined, if one was defined.

pub fn resolve_static( &self, label: &StaticLabel, ) -> Result<AssemblyOffset, DynasmError>

Returns the offset at which the global label label was defined, if one was defined.

Trait Implementations

impl Clone for LabelRegistry

fn clone(&self) -> LabelRegistry

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for LabelRegistry

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

Formats the value using the given formatter.

impl Default for LabelRegistry

fn default() -> LabelRegistry

Returns the “default value” for a type.