MemVarPut Function |  |
Assign a value to a memory variable of a given name.
Namespace: XSharp.RT
Assembly: XSharp.RT (in XSharp.RT.dll) Version: 2.21
Syntax[NeedsAccessToLocalsAttribute(TRUE)] FUNCTION MemVarPut( cVarName AS STRING, uValue AS USUAL ) AS USUAL
[NeedsAccessToLocalsAttribute(true)] public static Usual MemVarPut( string cVarName, Usual uValue )
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: UsualThe 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.
Therefore, MemVarPut(), like VarPut() can be used to create undeclared memory variables.
It should be used instead of a macro.
 Tip |
|---|
| This function allows the direct manipulation of a memory location and should be used with extreme care. |
Remarks| 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:
This example shows that the newly created variable is a MEMVAR:
X#
1LOCAL cHasName AS STRING 2cHasName := "cPrivate" 3// Instead of &cHasName := "new", use this: 4MemVarPut(cHasName, "new") 5? cPrivate // new
X#
1MemVarPut("cVar", "hi") 2? _MEMVAR->cVar // hi
See Also