Difference between revisions of "NAMESPACE()"

Latest revision as of 04:25, 12 April 2021

Purpose

Function to return the currently active namespace, if any

Syntax

NAMESPACE()

See Also

ARRAY(), CLEAR NAMESPACE, DECLARE, DIMENSION, Dynamically Loadable Modules, LOCAL, NAMESPACE, PARAMETERS, PRIVATE, PUBLIC, REMOVEPROPERTY(), REQUIRE(), SET STRICT, STORE

Description

The NAMESPACE() function returns the name of the currently active namespace, or an empty string if no namespace is active.

Namespaces are declared using the NAMESPACE command, creating a dynamic array which can be referenced by the namespace name. After declaration of a namespace, any PUBLIC variables declared are attached to that namespace, becoming members of the array. This allows the creation of multiple PUBLIC variables with the same name, provided each belongs to a separate namespace.

Issuing NAMESPACE without a <namespace name> deactivates any current namespace.

The CLEAR NAMESPACE command is used to release namespace dynamic arrays.

Individual public variables can be released by removing them as properties of the namespace dynamic array/object using REMOVEPROPERTY().

Example

procedure proc1
namespace namespace1
messagebox("Namespace is " + namespace())
public pub1 = "Public variable declared in proc1"
return
 
procedure proc2
namespace namespace2
messagebox("Namespace is " + namespace())
public pub1 = "Public variable declared in proc2"
return
 
clear memory 
proc1()
proc2()
display memory
? namespace1.pub1
? namespace2.pub1
namespace
messagebox("Namespace is " + namespace())
public pub1 = "Public variable, no namespace active"
? pub1
?
display memory
clear namespace
clear memory
display memory

output

Namespaces:
------------------------
NAMESPACE1 Dynamic array (refcnt 2)
.PUB1       Character 'Public variable declared in proc1'
NAMESPACE2 Dynamic array (refcnt 2)
.PUB1       Character 'Public variable declared in proc2'


Memory Variables:
------------------------

** Total of ** 4 variables defined and 322 bytes used.
Public variable declared in proc1
Public variable declared in proc2
Public variable, no namespace active


Namespaces:
------------------------
NAMESPACE1 Dynamic array (refcnt 2)
.PUB1       Character 'Public variable declared in proc1'
NAMESPACE2 Dynamic array (refcnt 2)
.PUB1       Character 'Public variable declared in proc2'


Memory Variables:
------------------------
public variables:
PUB1       public  Character 'Public variable, no namespace active'

** Total of ** 5 variables defined and 486 bytes used.

Memory Variables:
------------------------

** Total of ** 0 variables defined and 0 bytes used.