Variables

DELVAR

Definition

Deletes a variable with the specified NAME and frees up its memory.

Prototype	VOID DELVAR(STR NAME)
Returns	VOID
Parameters	NAME: The variable name (without & or &VAR: prefix)

Example

/* create variable */
SET &TEST_VAR1 = "TEST";

/* delete variable */
CALL DELVAR("TEST_VAR1");

For information why this can have advantages to UNSET, read details in SETVAR.

SETVAR

Definition

Assigns a VALUE to a variable of the specified NAME and creates that variable, if it didn't exist beforehand.

Prototype	VOID SETVAR(STR NAME, STR VALUE) VOID SETVAR(STR NAME, NUM VALUE) VOID SETVAR(STR NAME, BOOL VALUE) VOID SETVAR(STR NAME, LST VALUE) VOID SETVAR(STR NAME, OBJ VALUE)
Returns	VOID
Parameters	NAME: The variable name (without & or &VAR: prefix) VALUE: The value that's assigned to the variable

Example

/* create variable */
CALL SETVAR("TEST_VAR1", "VALUE1");

/* reassign a value to the variable */
CALL SETVAR("TEST_VAR1", "VALUE2");

/* delete variable */
UNSET &TEST_VAR1;

A huge advantage of using this function compared to SET and UNSET is, that variable names can stem from other variables. But this should be used cautiously since this can lead to confusion within the PRX code.

/* create prefix variable */
SET &PREFIX_VAR = "TST";

/* create concatenated variable */
CALL SETVAR(&PREFIX_VAR!!"VALUE"); /* ---> TSTVALUE */

/* delete concatenated variable */
CALL DELVAR(&PREFIX_VAR!!"VALUE");