Struct MacroDefs 

pub struct MacroDefs { /* private fields */ }

The macPutValue calls a caller wants made, in the order it wants them made in.

C builds its table one macPutValue at a time — macInstallMacros walks the pairs array macParseDefns produced, in file order (macUtil.c:250-275) — and expand then walks the table in that same order (macCore.c:655), so the sequence a .db load’s macLib notices come out in is the sequence the definitions were written in. A HashMap cannot carry that, and sorting its keys by name only looked right because the shapes measured so far happened to be in alphabetical order already.

So the order is carried here instead, and the conversion from a HashMap is the one place the loss is named: those definitions arrive in no order at all, and sorting them by name at least makes the notices reproducible from run to run.

Implementations

impl MacroDefs

pub fn new() -> Self

An empty set of definitions.

pub fn put(&mut self, name: impl Into<String>, value: impl Into<String>)

C macPutValue (macCore.c:262-289): a redefinition replaces the value and keeps the entry where it is, because rawval writes through the entry lookup found rather than appending a second one.

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

The definitions in order.

pub fn len(&self) -> usize

How many names are defined.

pub fn is_empty(&self) -> bool

Whether nothing is defined.

Trait Implementations

impl Clone for MacroDefs

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 MacroDefs

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

Formats the value using the given formatter.

impl Default for MacroDefs

fn default() -> Self

Returns the “default value” for a type.

impl Eq for MacroDefs

impl From<&HashMap<String, String>> for MacroDefs

fn from(macros: &HashMap<String, String>) -> Self

The lossy direction, and the only one: a hash map has no definition order to carry, so the names are sorted to make the notice order at least the same on every run. A caller that knows the order the operator wrote should build a MacroDefs directly.

impl From<&MacroDefs> for MacroDefs

fn from(defs: &MacroDefs) -> Self

Converts to this type from the input type.

impl From<Vec<(String, String)>> for MacroDefs

fn from(pairs: Vec<(String, String)>) -> Self

Converts to this type from the input type.

impl FromIterator<(String, String)> for MacroDefs

fn from_iter<I: IntoIterator<Item = (String, String)>>(iter: I) -> Self

Definition order, last definition of a name winning — C’s, since every one of these is a macPutValue.

impl PartialEq for MacroDefs

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for MacroDefs