Using Caché Multi-Dimensional Storage - InterSystems ...

Using Multidimensional Storage (Globals)
color = ^Data("Color") ' assign to a local variable
Print ^Data("Color") ' use as an argument to a command
MyMethod(^Data("Color")) ' use as a function argument
Using Caché ObjectScript:
SET color = ^Data("Color") ; assign to a local variable
WRITE ^Data("Color")
; use as a command argument
SET x=$LENGTH(^Data("Color")) ; use as a function parameter
3.4.1 The $GET Function
Within Caché ObjectScript, you can also get the value of a global node using the $GET
function:
SET mydata = $GET(^Data("Color"))
This retrieves the value of the specified node (if it exists) or returns the null string ("") if the
node is undefined. You can use the optional second argument of $GET to return a specified
default value if the node is undefined.
3.4.2 The WRITE, ZWRITE, and ZZDUMP Commands
You can display the contents of a global or a global subnode by using the various Caché
ObjectScript display commands. The WRITE command returns the value of the specified
global or subnode as a string. The ZWRITE command returns the name of the global variable
and its value, and each of its descendant nodes and their values. The ZZDUMP command
returns the value of the specified global or subnode in hexadecimal dump format.
3.5 Traversing Data within a Global
There are a number of ways you can traverse (iterate over) data stored within a global.
3.5.1 The $ORDER (Next / Previous) Function
The Caché ObjectScript $ORDER function (and its Caché Basic equivalent: Traverse)
allows you to sequentially visit each node within a global.
The $ORDER function returns the value of the next subscript at a given level (subscript
number). For example, suppose you have defined the following global:
20 Using Caché Multi-Dimensional Storage