Caché ObjectScript Reference
ZZWRITE
[Back] 
   
Server:docs1
Instance:LATEST
User:UnknownUser
 
-
Go to:
Search:    

Displays the values of variables or expressions.
Synopsis
ZZWRITE:pc expression,...
Arguments
pc Optional — A postconditional expression.
expression A variable or expression to display, or a comma-separated list of variables and/or expressions to display. A comma-separated list can contain any combination of variables and expressions.
Description
The ZZWRITE command evaluates an expression and displays a value on the current device. This expression can be a literal, local variable, process-private global, global variable, or special variable. ZZWRITE can evaluate a comma-separated list of expressions; it displays the results in the order specified, one expression per line. ZZWRITE displays the result of each expression as %val=value.
ZZWRITE without an argument is a no-op. It performs no operation and issues no error.
ZZWRITE and ZWRITE
ZZWRITE, like ZWRITE, displays non-printing characters and encoded data such as Caché lists, bitstrings, and %Status strings in a human-readable format. It does not execute control characters. Both commands provide an extensive display of object reference (oref) values, consisting of the oref value followed by the same “general information”, “attribute values”, and (where appropriate) “swizzled references” and “calculated references” returned by the %SYSTEM.OBJ.Dump() method.
ZZWRITE displays the same data values as ZWRITE with an argument, with the following differences:
For further details on how various data values are displayed, refer to ZWRITE.
For tables comparing ZZWRITE with the WRITE, ZWRITE, and ZZDUMP commands, refer to the Display (Write) Commands features tables in the “Commands” chapter of Using Caché ObjectScript.
Arguments
pc
An optional postconditional expression. Caché executes the command if the postconditional expression is true (evaluates to a nonzero numeric value). Caché does not execute the command if the postconditional expression is false (evaluates to zero). For further details, refer to Command Postconditional Expressions in Using Caché ObjectScript.
expression
An expression to evaluate, or a comma-separated list of expressions. An expression can consist of, or contain local variables, process-private globals, global variables, or special variables. It cannot be a private variable. Variables can be subscripted. Expressions are evaluated in strict left-to-right order.
You can use extended global reference to specify a global variable not mapped to the current namespace. If you specify a nonexistent namespace, Caché issues a <NAMESPACE> error. If you specify a namespace for which you do not have privileges, Caché issues a <PROTECT> error, followed by the global name and database path, such as the following: <PROTECT> ^myglobal,c:\intersystems\cache\mgr\. For further information on subscripted variables and extended global reference, refer to Global Structure in Using Caché Globals.
See Also