Enum Value 

pub enum Value<'a> {
    Literal(Cow<'a, str>),
    Number(i64),
    Concat(Box<[Self]>),
    Variable(Cow<'a, str>),
}

A value in a BibTeX field

Memory Optimization

Concatenation parts are stored out of line so the common literal, number, and variable variants stay compact.

Variants

Literal(Cow<'a, str>)

String literal

Number(i64)

Number literal

Concat(Box<[Self]>)

Concatenated values (boxed to reduce enum size)

Variable(Cow<'a, str>)

Variable reference

Implementations

impl Value<'_>

pub fn as_str(&self) -> Option<&str>

Get the value as a string (if it’s a simple literal)

pub fn expand(&self, strings: &AHashMap<&str, Value<'_>>) -> String

Expand variables and concatenations to get final string

pub fn to_plain_string(&self) -> String

Project this value to ordinary text without adding unresolved-variable markers.

Literals and numbers become their text form, variables become their variable name, and concatenations are joined recursively. This allocates when the value is not already a simple borrowed literal.

pub fn to_lossy_string(&self) -> String

Project this value to display text, marking unresolved variables as {name}.

pub fn from_plain_string<'a>(text: impl Into<Cow<'a, str>>) -> Value<'a>

Create a literal value from ordinary text.

pub fn to_bibtex_source(&self) -> String

Serialize this value as a BibTeX value fragment.

This is a normalized source projection. Use source-preserving parsing when callers need the exact original spelling or delimiters.

pub fn to_unicode_plain_string(&self) -> String

Project this value to ordinary text and convert common LaTeX sequences to Unicode.

pub fn into_owned(self) -> Value<'static>

Convert to owned version

Trait Implementations

impl<'a> Clone for Value<'a>

fn clone(&self) -> Value<'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for Value<'a>

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

Formats the value using the given formatter.

impl Default for Value<'_>

fn default() -> Self

Returns the “default value” for a type.

impl Display for Value<'_>

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

Formats the value using the given formatter.

impl<'a> PartialEq for Value<'a>

fn eq(&self, other: &Value<'a>) -> 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<'a> StructuralPartialEq for Value<'a>