Struct Macros 

pub struct Macros(/* private fields */);

An ordered set of macro definitions. Later definitions win.

A set layered over another (see Macros::with) shares it rather than copying it, so each widget of a large display costs only its own macros.

Implementations

impl Macros

pub fn from_element(el: &Element) -> Self

pub fn from_pairs<K: Into<String>, V: Into<String>>( pairs: impl IntoIterator<Item = (K, V)>, ) -> Self

pub fn get(&self, name: &str) -> Option<&str>

pub fn is_empty(&self) -> bool

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

Every definition, in the order Macros::get lets later ones win: a layer’s base first, then its parent (and all below it), then its own.

pub fn with(&self, inner: &Macros) -> Macros

These macros with inner layered on top. Values in inner are first expanded against self, so <P>$(P):SUB</P> works. Only inner’s own definitions are used, not the layers under it: for a whole chain, such as a link’s, use Macros::over.

pub fn with_budget(&self, inner: &Macros, left: &AtomicUsize) -> Macros

Macros::with, where expanding the values takes the size of their text and result from left, which several layers may share. Once it is spent, values are kept as written, not expanded, so nested definitions that each double the last, in many widgets, can’t use memory or time without bound. Only the definitions made in inner itself are used, at most [MAX_LAYER_MACROS] of them, and no more than [MAX_LAYERS] deep.

pub fn over(defaults: &Macros, over: &Macros, left: &AtomicUsize) -> Macros

defaults with over on top of them, sharing both: over is the macros an embedding passes to the display it embeds, and is a whole chain of the embedder’s layers, which are not copied.

pub fn own_bytes(&self) -> usize

The bytes of the definitions in this layer alone.

Trait Implementations

impl Clone for Macros

fn clone(&self) -> Macros

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Macros

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

Formats the value using the given formatter.

impl Default for Macros

fn default() -> Macros

Returns the “default value” for a type.

impl PartialEq for Macros

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Macros