Struct LocalScope 

pub struct LocalScope { /* private fields */ }

A parameter scope for a Rust port that is invoked as a DIRECT Rust call rather than through dispatch_function_call.

declare_locals only stamps pm->level = locallevel; the unwind is endparamscope’s job, and that runs from doshfunc. A port reached by a plain Rust call (_alternative -> _tags(&…) / _next_label(&…) -> _description(&…)) therefore never gets one, so every name in its declare_locals list stayed shadowed for the rest of the CALLER’s body.

Concretely: _tags declares tmp and _description declares opts, and both names are _files’ own locals holding the results of its zparseopts -a opts '/=tmp' 'g+:-=tmp' … W: … line. After _alternative ran either port, _files saw opts=() / tmp=(), so -W /dev and -g '*(-%b,-/)' were both dropped — mount /dev/<TAB> listed every file in $PWD and PATH=…:<TAB> listed files instead of directories.

Holding one of these for the port’s body reproduces the visible half of what a real shell function gets from endparamscope (Src/params.c:5867-5933, the pm->level > locallevel arm): each declared name is put back exactly as the caller left it.

It restores by NAME rather than by bumping locallevel and calling endparamscope, because a port’s body also writes caller-visible state (_comp_tags, curtag, the expl array named by _description’s $2). A whole-scope unwind takes those with it — _tags then reported “comptags: no tags registered” for every context.

Implementations

impl LocalScope

pub fn declare(names: &[&str], kind: u32) -> Self

Declare names local (see declare_locals) and remember what each one looked like beforehand.

pub fn also(&mut self, names: &[&str], kind: u32)

Add more names to an existing scope — the port equivalent of a second local -a … line.

pub fn also_keeping_value(&mut self, names: &[&str])

local NAME="$NAME" — see declare_locals_keeping_value.

Trait Implementations

impl Drop for LocalScope

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.