Click or drag to resize

Functions.MemVarPut Method

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

Namespace:  XSharp.RT
Assembly:  XSharp.RT (in XSharp.RT.dll) Version: 2.2
Syntax
 FUNCTION MemVarPut(
	cVarName AS STRING,
	uValue AS USUAL
) AS USUAL
View Source

Parameters

cVarName
Type: String
The name of the variable you want to create.
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.
Remarks
Tip Tip
Dynamic memory variables (PUBLIC, PRIVATE, PARAMETERS) are supported in the X# language and runtime for compatibility only.
In most cases the type can and should be replaced with lexically scoped variables, such as LOCALs and GLOBALs.
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