Enum SetArg 

pub enum SetArg {
    Named {
        key: String,
        value: SetValue,
        key_span: SourceSpan,
        value_span: SourceSpan,
    },
    Positional {
        value: SetValue,
        value_span: SourceSpan,
    },
}

One argument inside a directive body: either a key: value pair (the only form #set accepts) or a positional value (a leading string literal allowed on #image(...) / #figure(...)).

This used to be a struct with an empty-string key standing in for “positional,” but that sentinel was a brittle public contract: any consumer that forgot the special-case would silently treat a positional path as a named arg called "". The enum form makes the two shapes explicit so the compiler can enforce exhaustive matches.

Variants

Named

A key: value argument. key_span covers the identifier before the colon; value_span covers the literal.

Fields

key: String

value: SetValue

key_span: SourceSpan

value_span: SourceSpan

Positional

A leading positional value. The parser currently only accepts string literals here (used for #image("path.png")); other literal kinds in a positional slot would surface as a parse error rather than land in this variant.

Fields

value: SetValue

value_span: SourceSpan

Implementations

impl SetArg

pub fn value(&self) -> &SetValue

Borrow the value carried by this argument, regardless of shape.

pub fn value_span(&self) -> &SourceSpan

The span covering the argument’s value literal.

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

The key identifier for Self::Named; None for Self::Positional.

pub fn key_span(&self) -> Option<&SourceSpan>

The span covering the key identifier, for Self::Named. None for Self::Positional.

Trait Implementations

impl Clone for SetArg

fn clone(&self) -> SetArg

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SetArg

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

Formats the value using the given formatter.