Struct Directive 

pub(crate) struct Directive {
    pub(crate) blocks: BTreeMap<BlockIdentifier, LocatedBlock>,
    pub(crate) equalities: Vec<Equality>,
    pub(crate) entry_point: Option<Address>,
}

The Directive is the abstract syntax representation of the user’s program (i.e. the assembler’s input). A Directive is generated (from a super::manuscript::SourceFile instance) by the assembler once it has deduced the absolute address at which each block will be located.

Symbolic information is included in the equalities table, but also within the blocks of the program itself.

Fields

blocks: BTreeMap<BlockIdentifier, LocatedBlock>

equalities: Vec<Equality>

Equalities (we use the term from the TX-2 Users Handbook). In more modern terminology, these would be assignments. An equality can be re-assigned, and the last value assigned takes effect everywhere in the program.

When evaluated, however, the value of an equality can vary in different places, because it can refer to local tags (which may be dfefined differently inside macro bodies) or (directly or indirectly) to # which is the address of the word currently being assembled.

entry_point: Option<Address>

The address at which execution should begin, as specified by the ☛☛PUNCH meta-command, if one was given. See Users Handbook, section 6-3.4 and super::manuscript::ManuscriptMetaCommand::Punch.

Implementations

impl Directive

pub(crate) fn new( blocks: BTreeMap<BlockIdentifier, LocatedBlock>, equalities: Vec<Equality>, entry_point: Option<Address>, ) -> Self

pub(crate) fn position_rc_block(&mut self) -> Address

Determine the address of the RC-block.

The real TX-2 assembler (“M4”) allowed the program optionally to select a location using the☛☛RC meta command, but this is not yet supported.

pub(crate) fn entry_point(&self) -> Option<Address>

Trait Implementations

impl Clone for Directive

fn clone(&self) -> Directive

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Directive

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

Formats the value using the given formatter.

impl PartialEq for Directive

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for Directive

impl StructuralPartialEq for Directive