A variable name is a string between 1 and
long that satisfies the rules for PSPP identifiers
(see Tokens). Variable names are
mixed-case and treated case-insensitively.
Only one commonly useful function relates to variable names:
Returns var's variable name as a C string.
A few other functions are much more rarely used. Some of these functions are used internally by the dictionary implementation:
Changes the name of var to new_name, which must be a “plausible” name as defined below.
This function cannot be applied to a variable that is part of a dictionary. Use
dict_rename_varinstead (see Dictionary Renaming Variables).
Tests name for validity or “plausibility.” Returns true if the name is acceptable, false otherwise. If the name is not acceptable and issue_error is true, also issues an error message explaining the violation.
A valid name is one that fully satisfies all of the requirements for variable names (see Tokens). A “plausible” name is simply a string whose length is in the valid range and that is not a reserved word. PSPP accepts plausible but invalid names as variable names in some contexts where the character encoding scheme is ambiguous, as when reading variable names from system files.
Returns the dictionary class of var's name (see Dictionary Class).