Click or drag to resize

MemVarPutSym Function

Assign a value to a memory variable of a given name.

Namespace:  XSharp.RT
Assembly:  XSharp.RT (in XSharp.RT.dll) Version: 2.10
Syntax
 FUNCTION MemVarPutSym(
	symVar AS SYMBOL,
	uValue AS USUAL
) AS USUAL
View Source

Parameters

symVar
Type: Symbol
The name of the variable you want to assign to.
uValue
Type: Usual
The value to assign to the variable.

Return Value

Type: Usual
The value assigned to <uValue>.
Remarks
If a memory variable called <cVarName> does not exits, a memory variable called <cVarName> is created.  Therefore, MemVarPut(), like VarPut() can be used to create undeclared memory variables.  It should be used instead of a macro.
Tip Tip
This function allows the direct manipulation of a memory location and should be used with extreme care.
Examples
This example uses MemVarPut() to create a memory variable:
X#
LOCAL cHasName AS STRING
cHasName := "cPrivate"
// Instead of &cHasName := "new", use this:
MemVarPut(cHasName, "new")
? cPrivate                                        // new
This example shows that the newly created variable is a MEMVAR:
X#
MemVarPut("cVar", "hi")
? _MEMVAR->cVar                        // hi
See Also