Enum nameref_resolution 

pub enum nameref_resolution {
    NotRef,
    Placeholder(String),
    Target {
        name: String,
        subscript: Option<String>,
        pm: Option<Param>,
        level: i32,
    },
    SelfRef,
    OutOfScope,
}

Result of walking a nameref chain by name. Rust-side carrier for what C’s resolve_nameref_rec (Src/params.c:6332) communicates via the returned Param pointer: the chain may end at the final non-ref target, at a placeholder ref (empty refname), at a subscripted ref (pm->width ends the chain per c:6339), at a dangling name (target never defined), or in a loop.

Variants

NotRef

name is not a nameref (or doesn’t exist / is an unset ref).

Placeholder(String)

Chain ends at a nameref whose refname is empty/None — the C keep_lastref shape (c:6354). Field = that ref’s name.

Target

Final non-ref target. pm is a clone of the resolved binding (None when the target name was never defined — C returns NULL at c:6347 when gethashnode2 misses). level is the resolved binding’s scope level (for old-chain writes).

Fields

name: String

final target name

subscript: Option<String>

subscript from a name[sub] refname (ends the chain, c:6339)

pm: Option<Param>

clone of the resolved binding (possibly a hidden old-chain node)

level: i32

scope level of the resolved binding (only when pm is Some)

SelfRef

Loop detected — zerr("...: invalid self reference") already emitted (c:6341-6343).

OutOfScope

The refname EXISTS in the table but the upscope walk excluded every binding (c:6347-6349: loadparamnode(upscope(...)) returned NULL with gethashnode2 non-NULL, so the keep_lastref else-arm is SKIPPED). Reads see unset; assignment FAILS (createparam c:1108-1118 refuses the existing ref).