Struct Variables 

pub struct Variables { /* private fields */ }

Handle to the installer’s variables array.

Implementations

impl Variables

pub unsafe fn from_raw(base: *mut Tchar, string_size: usize) -> Self

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

Safety

base must be the variables pointer the installer passed, pointing at VAR_COUNT × string_size characters, and must outlive the result.

pub fn string_size(&self) -> usize

The calling installer’s NSIS_MAX_STRLEN, in characters.

pub fn get(&self, var: Var) -> String

Reads a variable.

Returns an empty string when the installer passed no variables array, because there is nothing sensible to read and $0 is empty by default.

pub fn set(&mut self, var: Var, value: &str) -> Result<()>

Writes a variable, bounded by the installer’s string_size.

setuservariable uses an unbounded lstrcpy here, which overflows the slot for a long enough value; this bounds the copy and reports Error::Truncated instead.

pub fn get_int(&self, var: Var) -> isize

Reads a variable using NSIS’s own integer conversion.

pub fn set_int(&mut self, var: Var, value: isize) -> Result<()>

Writes an integer to a variable, formatted as pushintptr formats it.