docs.intersystems.com
Home  /  Application Development: Core Topics  /  ObjectScript Reference  /  ObjectScript Commands  /  ZZWRITE


ObjectScript Reference
ZZWRITE
[Back] 
InterSystems: The power behind what matters   
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 InterSystems IRIS 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 ObjectScript.
Arguments
pc
An optional postconditional expression. InterSystems IRIS executes the command if the postconditional expression is true (evaluates to a nonzero numeric value). InterSystems IRIS does not execute the command if the postconditional expression is false (evaluates to zero). For further details, refer to Command Postconditional Expressions in Using 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, InterSystems IRIS issues a <NAMESPACE> error. If you specify a namespace for which you do not have privileges, InterSystems IRIS issues a <PROTECT> error, followed by the global name and database path, such as the following: <PROTECT> ^myglobal,c:\intersystems\iris\mgr\. For further information on subscripted variables and extended global reference, refer to Global Structure in Using Globals.
See Also