Struct lc3_ensemble::ast::Offset

pub struct Offset<OFF, const N: u32>(/* private fields */);

A value representing an offset or an immediate value.

The OFF type represents the backing type of this offset. The signedness of this offset type is dependent on the signedness of the OFF type:

• Offset<i16, _>: signed offset
• Offset<u16, _>: unsigned offset

N indicates the maximum bit size of this offset/immediate value.

For example, Offset<i16, 5> is used to represent ADD/AND’s imm5 operand.

Implementations

impl<OFF: OffsetBacking, const N: u32> Offset<OFF, N>

pub fn new(n: OFF) -> Result<Self, OffsetNewErr>

Creates a new offset value. This must fit within N bits of the representation, otherwise an error is raised.

Panics

This will panic if N is larger than the offset backing (e.g., for backing u16, larger than 16).

pub fn new_trunc(n: OFF) -> Self

Creates a new offset by extending the first N bits of the integer, and discarding the rest.

The extension is considered sign-extended if the offset’s backing is signed, and it is considered zero-extended if the offset’s backing is unsigned.

Panics

This will panic if N is larger than the offset backing (e.g., for backing u16, larger than 16).

pub fn get(&self) -> OFF

Gets the value of the offset.

Trait Implementations

impl<OFF: Binary, const N: u32> Binary for Offset<OFF, N>

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

Formats the value using the given formatter.

impl<OFF: Clone, const N: u32> Clone for Offset<OFF, N>

fn clone(&self) -> Offset<OFF, N>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<OFF: Debug, const N: u32> Debug for Offset<OFF, N>

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

Formats the value using the given formatter.

impl<OFF: Display, const N: u32> Display for Offset<OFF, N>

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

Formats the value using the given formatter.

impl<OFF: Hash, const N: u32> Hash for Offset<OFF, N>

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl<OFF: LowerHex, const N: u32> LowerHex for Offset<OFF, N>

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

Formats the value using the given formatter.

impl<OFF: PartialEq, const N: u32> PartialEq for Offset<OFF, N>

fn eq(&self, other: &Offset<OFF, N>) -> bool

This method tests for self and other values to be equal, and is used by ==.

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

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

impl<const N: u32> TokenParse for Offset<i16, N>

type Intermediate = Either<i16, u16>

An intermediate to hold the match before it is converted to the actual component.

fn match_( m_token: Option<&Token>, span: Span ) -> Result<Self::Intermediate, ParseErr>

Tries to match the next token to the given component, if possible.

fn convert(imed: Self::Intermediate, span: Span) -> Result<Self, ParseErr>

Parses the intermediate into the given component, raising an error if conversion fails.

impl<const N: u32> TokenParse for Offset<u16, N>

type Intermediate = Either<u16, i16>

An intermediate to hold the match before it is converted to the actual component.

fn match_( m_token: Option<&Token>, span: Span ) -> Result<Self::Intermediate, ParseErr>

Tries to match the next token to the given component, if possible.

fn convert(imed: Self::Intermediate, span: Span) -> Result<Self, ParseErr>

Parses the intermediate into the given component, raising an error if conversion fails.

impl<OFF: UpperHex, const N: u32> UpperHex for Offset<OFF, N>

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

Formats the value using the given formatter.

impl<OFF: Copy, const N: u32> Copy for Offset<OFF, N>

impl<OFF: Eq, const N: u32> Eq for Offset<OFF, N>

impl<OFF, const N: u32> StructuralPartialEq for Offset<OFF, N>