第三十九章 Caché 命令大全 ZZWRITE 命令

显示变量或表达式的值。

大纲

ZZWRITE:pc expression,...

参数

• pc -可选-后置条件表达式。
• expression 要显示的变量或表达式，或以逗号分隔的变量和/或表达式列表。以逗号分隔的列表可以包含变量和表达式的任何组合。

描述

ZZWRITE命令计算一个表达式并在当前设备上显示一个值。该表达式可以是文字，局部变量，专用于进程的全局变量，全局变量或特殊变量。ZZWRITE可以计算以逗号分隔的表达式列表。它以指定的顺序显示结果，每行一个表达式。 ZZWRITE将每个表达式的结果显示为％val = value。

没有参数的ZZWRITE是空操作。它不执行任何操作，也不发出错误。

ZZWRITE 与 ZWRITE

像ZWRITE一样，ZZWRITE以人类可读的格式显示非打印字符和编码数据，例如Caché列表，位字符串和 %Status字符串。它不执行控制字符。这两个命令都提供对象引用（oref）值的广泛显示，该对象引用由oref值后跟相同的“常规信息”，“属性值”以及（如果适用）由对象返回的“混乱（swizzled ）引用”和“计算的引用”组成。 ％SYSTEM.OBJ.Dump（）方法。

ZZWRITE使用参数显示与ZWRITE相同的数据值，但有以下差异：

• 变量名称：ZZWRITE将每个表达式或变量的值显示为％val = value。 ZWRITE将本地，进程专用变量和全局变量显示为varname = value，并将文字，表达式和特殊变量显示为value。
• 未定义的变量：ZZWRITE对未定义的变量发出错误。 ZWRITE忽略未定义的变量。
• 下标：ZZWRITE显示指定下标节点的值。 ZWRITE以下标树的顺序显示下标节点和所有定义的子节点。
• 扩展的全局变量引用：ZZWRITE将扩展的全局变量引用的值显示为％val = value（与其他表达式一样），但不表示该值是在另一个命名空间中定义的。 ZWRITE显示扩展的全局引用变量名称，该名称显示包含全局名称空间的名称空间。

参数

pc

可选的后置条件表达式。如果后置条件表达式为true（计算为非零数值），则Caché执行命令。如果后置条件表达式为假（计算为零），则Caché不执行命令。

expression

要求值的表达式或以逗号分隔的表达式列表。表达式可以包含或包含局部变量，进程专用全局变量，全局变量或特殊变量。它不能是私有变量。变量可以下标。表达式按严格的从左到右顺序求值。

可以使用扩展的全局引用来指定未映射到当前名称空间的全局变量。如果指定了不存在的名称空间，则Caché会发出<NAMESPACE> 错误。如果指定了没有权限的名称空间，则Caché会发出 <PROTECT>错误，后跟全局名称和数据库路径，例如：<PROTECT> ^myglobal,c:\intersystems\cache\mgr\.

DHC-APP>SET a=7,b="14",c="+21.0",d="7dwarves"
 
DHC-APP>ZZWRITE a,b,c,d
%val=7
%val=14
%val="+21.0"
%val="7dwarves"
 
DHC-APP> SET a=7,b=14,c=21
 
DHC-APP>ZZWRITE $LISTBUILD(a,b)_$LISTBUILD(c)
%val=$lb(7,14,21)