Struct Stack 

pub struct Stack { /* private fields */ }

Handle to the installer’s stack_t **.

Obtained from Nsis::stack; not constructed directly outside of tests.

Implementations

impl Stack

pub unsafe fn from_raw(top: *mut *mut StackNode, string_size: usize) -> Self

Wraps the stacktop and string_size arguments of a plug-in export.

Safety

top must be the stacktop pointer the installer passed, and string_size its string_size argument. The stack must outlive the returned value.

pub fn string_size(&self) -> usize

The calling installer’s NSIS_MAX_STRLEN, in characters.

pub fn max_len(&self) -> usize

Longest string this installer can hold, excluding the NUL terminator.

pub fn is_empty(&self) -> bool

Whether the stack has no entries. Also true when there is no stack.

pub fn len(&self) -> usize

Number of entries currently on the stack.

Walks the whole list, so prefer is_empty in a loop.

pub fn pop(&mut self) -> Result<String>

Pops the top entry and frees its node, as popstring does.

pub fn peek(&self) -> Result<String>

Reads the top entry without removing it.

pub fn discard(&mut self) -> Result<()>

Pops and discards the top entry.

pub fn pop_int(&mut self) -> Result<isize>

Pops an integer using NSIS’s own conversion.

Unparseable input is 0, not an error — this matches popintptr, and scripts rely on it. Only an empty stack is an error.

pub fn pop_int_or(&mut self) -> Result<isize>

Pops an integer, additionally accepting 2|4|8 forms, as popint_or.

pub fn push(&mut self, s: &str) -> Result<()>

Pushes a string, bounded by the installer’s string_size.

On Error::Truncated the clipped value has still been pushed, exactly as lstrcpyn would leave it. The error exists so the caller can decide whether the truncation matters.

pub fn push_int(&mut self, value: isize) -> Result<()>

Pushes an integer, formatted as pushintptr formats it.

pub fn push_bool(&mut self, value: bool) -> Result<()>

Pushes a boolean as the 0/1 NSIS scripts compare against.