IRIS知识图谱

默认小数，提供最高级别的精度`-18`位十进制数字。

IEEE浮点数使用二进制表示法进行编码。精度为`53`个二进制位，相当于`15.95`个十进制数字的精度。支持特殊值`INF`(无穷大)和`NaN`(非数字)

推荐使用的形式

使用`^GETPPGINFO`工具以块为单位显示当前进程私有`Global`及其空间分配，`^GETPPGINFO`列出进程私有`Global`的下标或值。可以通过指定进程`ID`来显示特定进程的进程私有`Global`，也可以通过指定`“*”`通配符字符串来显示所有进程的进程私有`Global`。

必须在`%SYS`命名空间中才能调用`^GETPPGINFO`。

将进程私有`Global`导出。

使用`$ZREFERENCE`特殊变量来确定最近使用的全局变量的名称。

使用`$QSUBSCRIPT`函数返回指定全局变量节点的名称。

使用`$QLENGTH`函数返回下标的数量。

多维数组是由一个或多个元素组成的局部变量，每个元素都有唯一的下标。可以混合使用不同种类的下标。

多维数组的下标是正数或负数、字符串及其组合。下标可以包括任何字符，包括`Unicode`字符。数字下标作为规范数字存储和引用。字符串下标作为区分大小写的文字存储和引用。规范数字和包含该规范数的字符串是等价的下标

`SET`将值放入数组中。

`KILL`删除全部或部分数组结构。

`Merge`将数组结构的全部或部分复制到第二个数组结构。

`$ORDER`和`$QUERY`允许迭代数组的内容。

`$DATA`允许测试数组中是否存在节点。

多维数组的整个结构称为树；它从顶部开始，向下生长。词根`array`，在顶部。根及其任何其他下标形式称为节点。下面没有节点的节点称为叶。下面有节点的节点称为父代或祖先。具有父节点的节点称为子节点。父母相同的孩子被称为兄弟姐妹。所有同级在添加到树中时都会自动按数字或字母顺序排序。

多维数组是稀疏的。这意味着上面的示例仅使用七个保留的内存位置，每个定义一个节点。此外，由于不需要声明数组或指定它们的维度，因此还有额外的内存优势：没有提前为它们保留空间；它们在需要之前不使用空间；它们使用的所有空间都是动态分配的。

例程是可调用编写的代码块，它是`ObjectScript`程序。其名称由用于保存它的`.mac`文件的名称确定。

d ^RoutineName

s x = $$^RoutineName

如果直接用变量接收`.mac`文件名称返回值，默认调用`.mac`文件第一个子例程方法，并且该方法不能为标签方法。

子例程是例程内的命名代码块。

通常，子例程以`LABEL`开头，以`QUIT`语句结束，可以接受参数，不返回值。

d Subroutine^Routine

label [ ( param [ = default  ][ , ...] ) ] 
   code
   QUIT

系统提供的函数称为内部函数

自定义的函数称为外部函数

函数是例程中的命名代码块。

通常，函数以`LABEL`开头，以`QUIT`语句结束。可以接受参数，有返回值。

s rval = $$Function()  /* 返回值 */

d Function^Routine   /* 忽略返回值 */

s x = $$Function^RoutineName(params)

label ( [param [ = default  ]] [ , ...] ) 
   code
   QUIT expression

与子例程的区别就是有返回值。

当方法添加关键字`PRIVATE`时，该例程以外的程序调用不到。会报错`<NOLINE>`错误。只能在当前`mac`中使用。默认是公共的，

标签是例程或类方法内的命名代码块。

没有接受参数，无返回值。

d label

d label^Routine

定义的标签如果没有退出命令例如`quit`,`retrun`是可以顺序执行之后的标签，直到遇到退出命令。

`Procedures`过程是一种特殊的ObjectScript例程。

可以设置公共，私有方法属性。

可以接受若干参数。

自动将在其创建的变量设置为作用域中的局部变量。

可以设置是否返回值。

可以引用和设置外部的变量。

子例程始终是公共的，不能返回值。

函数始终是公共的，需要显式声明局部变量(否则将覆盖外部变量)，并且必须具有返回值。

例程是`ObjectScript`程序。可以包括一个或多个过程、子例程和函数，以及三者的任意组合。

label([param[=default]][,...]) [[pubvar[,...]]] [access] {
   code 
}

默认情况下，过程是私有的，这意味着只能从同一例程中的其他地方调用。可以创建公共的过程，在过程名称后使用`Public`关键字。可以从其他例程调用公共过程。

声明公共变量。可用于所有过程和方法；即此过程或方法调用的过程和方法以及调用此过程或方法的过程和方法。应该以这种方式定义数量相对较少的变量，以充当应用程序的环境变量。要定义公共变量，请将它们列在过程名称及其参数后面的方括号中。

过程中可以定义标签，其中标签都是该过程的私有标签，并且只能从该过程内访问。

在过程中不允许重复标签，在例程中与过程中允许重复标签。具体地说，在不同的过程中允许重复标签。

过程比以前在子例程和用户定义函数中提供的编码更先进。过程参数在过程内的作用域中自动是局部的。它们不需要`NEW`命令来确保它们不会覆盖其他值，因为它们是过程专用的，此外，公共变量的显式声明允许引用应用程序中的全局变量。

在过程中，局部变量可以是“公共的”或“私有的”。公共列表(`Pubvar`)声明过程中公共变量，过程中的所有其他变量为私有变量。

私有变量在进入过程时未定义，在退出过程时销毁。

公有变量列表为空，则所有变量都是私有的。在这种情况下，方括号是可选的。

实例方法，必须初始化对象才能调用的方法。

ClassMethod Method()
{
 s m = ..%New()
 d m.Method1()
}

Method Method1()
{
 w "实例方法!"
}

类方法（静态方法），可直接调用，不需要初始化对象。

ClassMethod ClassMethod()
{
 w "类方法!"
}

类方法源代码`int`文件实际上可作为例程`Routine`文件。如果类加上关键字`[Not ProcedureBlock]`，则方法为子例程函数，反之为方法为过程。

程序员写的一个完整程序代码。可以包含多个类，方法，例程，过程，某个功能模块的统称。

系统函数由名称前的 `$` 字符前缀和名称后的括号标识。也称为内部函数。

实际参数列表：实际参数列表中局部变量或数组名称前面的句点是必填项。它指定变量是通过引用传递的，而不是通过值传递的。

可以通过在最后一个参数的名称后附加三个点来实现。此参数必须是参数列表中的最后一个参数。

与

或

与

或

非

操作数没有前导数字字符，则认为其值为零。不允许将数字除以零。返回`<Divide>`错误消息.

开方时可能会产生开不尽的意外结果。

可以使用`zpower`函数来代替`**`。

0 ** 0

0 ** n

Num ** 0

1 ** n

-num ** .N

$DOUBLE("INF") ** n

$DOUBLE("NaN")

Num ** nnn

Num ** -nnn

.Num ** -nnn

.Num ** -nnn

小于运算符测试左操作数是否在数值上小于右操作数，并返回其布尔值。

大于运算符测试左操作数是否在数值上大于右操作数，并返回其布尔值。

大于等于运算符测试左操作数是否在数值上大于等于右操作数，并返回其布尔值。

小于等于运算符测试左操作数是否在数值上小于等于右操作数，并返回其布尔值。

等于运算符测试两个操作数的字符串相等。如果两个操作数是具有相同字符序列且没有中间字符的相同字符串，则返回结果`TRUE`(`1`)；否则返回结果`FALSE`(`0`)。

注意事项

通过将`NOT`运算符与等于运算符`=`一起使用来指定不等于运算。并返回其布尔值。

包含运算符测试右操作数中的字符是否在左操作数的字符串中。如果左操作数包含右操作数的字符串，则结果为`TRUE`(`1`)。如果左操作数不包含右操作数的字符串，则结果为`FALSE`(`0`)。如果右操作数为`""`空字符串，则结果为`TRUE`(`1`)。

通过将`NOT`运算符与包含运算符一起使用，如果左操作数不包含右操作数的字符串，则返回`TRUE`，如果左操作数包含右操作数的字符串，则返回`FALSE`。

跟随运算符测试左操作数中的字符的`ASCII`是否在右操作数中的字符`ASCII`之后。

跟随运算符对比每个字符串都从最左边的字符开始。在左操作数中找到与右操作数中相应位置的字符不同的字符或两个操作数中都没有更多的字符比较时结束。

以下情况返回TRUE

以下情况返回FLASE

通过将`NOT`运算符与跟随运算符一起使用来指定非跟随运算。

排序规则

测试左操作数是否右操作数之后排序。

通过将`NOT`运算符与排序运算符一起使用来指定非排序运算。

匹配任何大写或小写字母字符。

`包括ASCII值65到90(A到Z)、97到122(a到z)、170、181、186、192到214、216到246和248到255`。

匹配任何控制字符

`ASCII值0到31和扩展ASCII值127到159`。

匹配任何字符，包括非打印字符、空格字符和控制字符。

匹配任何小写字母字符。

`包括ASCII值97到122(a到z)、170、181、186、223到246和248到255`。

匹配数字字符0到9。

`ASCII 48`到`57`。

匹配任何标点符号。

`包括ASCII值32到47、58到64、91到96、123到126、160到169、171到177、180、182到184、187、191、215和247`。

匹配任何大写字母字符。

`包括ASCII值65到90(A到Z)、192到214和216到222`。

Pattern1Pattern2

在名称间接寻址中，间接寻址计算结果为变量名、行标签或例程名称。在执行该命令之前将变量的内容替换为预期的名称。

当使用间接寻址引用行标签时，间接的值必须是语法上有效的行标签。

名称间接寻址只能访问公共变量。

使用间接地址引用命名变量时，间接地址的值必须是完整的`Glbalo`或局部变量名，包括任何必要的下标。

如果使用间接方式获取或设置对象属性值，会引起错误。不要使用此方式调用，因为会绕过属性访问器方法(`<PropertyName>Get`和`<PropertyName>Set`)。相反，可以使用`$CLASSMETHOD`、`$METHOD`和`$PROPERTY`)函数。

动态替换标签

将间接与模式匹配结合使用是应用程序中使用的模式匹配的便捷方式。在这种情况下，可以将模式存储在单独的变量中，然后在实际模式匹配测试期间间接引用银边。 只需要修改模式匹配变量本身。

在参数间接寻址中，间接寻址计算命令参数。参数间接寻址是名称间接寻址的一部分。

先定义变量字符串，后计算表达式

`IF`将表达式作为参数，并计算该表达式为`true`或`false`。如果为`true`，则执行表达式后面的代码块；如果为`false`，则不执行该代码块。通常用值`1`和`0`表示这些值。

**注：对数值执行条件判断时，如果其计算结果为`0`(零)，则将其计算为`false`，如果计算结果为非零值，则计算为`true`。**

IF expression1,... { code }

一个带有若干条件表达式的`if`子句。

任意数量的`ELSEIF`子句，每个子句都有若干条件表达式。

最多只有一个`ELSE`子句。没有条件表达式。

传统的`IF`命令是面向行的。要执行的命令必须在同一程序行中。不使用花括号，并且行格式是固定的。新的`IF`命令是块结构的；执行的块由在`IF`命令后的花括号内找到的命令组成。 `IF`的新版本不使用`$TEST`特殊变量。

**注意：该面向行的点语法`ELSE`关键字可以缩写为`E`。（不能缩写为面向块的`ELSE`关键字。）`IF`和`ELSE`的新旧形式在语法上是不同的，不应结合使用；因此，点语法`IF`不应与块语法的`ELSE`配对。**

如果在`IF`代码块中使用`GOTO`，注意避免死循环。

如果`IF`代码块未嵌套在循环结构中，或未嵌套在`TRY`或`CATCH`块中，则`QUIT`退出当前方法。

如果`IF`代码块嵌套在循环结构(如`FOR`代码块)中，则`QUIT`退出循环结构块，并继续执行循环结构代码块后面的命令。

如果`IF`代码块位于`TRY`块或`CATCH`块内，则`QUIT`将退出`TRY`或`CATCH`块，并继续执行`TRY`或`CATCH`块后面的命令。

ELSE { code }

ELSE 不是单独的命令，而是面向块的 IF 命令的子句。您可以将单个 ELSE 子句指定为 IF 命令的最后一个子句，也可以省略 ELSE 子句

ELSEIF expression,... { code }

ELSEIF 不是单独的命令，而是面向块的 IF 命令的一个子句。

`FOR`是面向块的命令。通常，由一个计数器和一个用大括号括起来的可执行代码块组成。此代码块的执行次数由计数器确定，计数器在每个循环体的顶部进行测试。

FOR var=forparameter { code }

FOR var=forparameter1,forparameter2,... { code }

FOR var=expr

FOR var=start:increment

FOR var=start:increment:end

不带参数的`for`无限执行循环代码块，直到由代码块内的命令退出。重复括号内的命令，直到遇到退出循环的`Quit`、`Return`或`GOTO`命令。

错误也会中断`for`循环。

点语法（不推荐，废弃结构），传统的`FOR`命令是面向行的。它执行的循环由在同一程序行中跟随它的命令组成。不使用花括号，并且行格式是固定的。

如果`expression`的计算结果为`TRUE`，则将执行括号之间的代码块。如果`expression`不为`TRUE`，则不执行括号内的代码块，并执行紧跟大括号的下一个命令。所以只要`expression`的计算结果为`TRUE`，`WHILE`就可以重复执行。

WHILE expression

`DO WHILE`执行代码，然后计算表达式。如果表达式的计算结果为`True`，则`DO WHILE`循环并重新执行代码。如果表达式不为`true`，则不重新执行代码，并执行`Do While`后面的下一个命令。

**注意：`Do While`始终以面向块的形式编写。要执行的代码放在`do`和`While`关键字之间，并用大括号括起来。**

无参数`do`命令执行同一程序中紧随其后的代码块。这段代码的每一行都用句点(`.`)表示。然后，执行该代码块之后的下一个命令。可以嵌套无参数`DO`块。后置条件表达式可以附加到无参数`DO`命令关键字，以指定是应该执行还是跳过紧跟在`DO`命令后面的代码块。

带参数的`do`命令调用在其他地方定义的一个或多个代码块的执行。`do`命令可以指定多个代码块作为逗号分隔的列表执行。

DO:pc doargument,...

在方法或例程内部使用`do`调用子例程或标签，利用了调用例程及其被调用子例程共享相同变量环境。在`do`命令之后，子例程所做的任何变量改变都会自动对原环境代码有效。

`do`命令调用的代码块不能向`do`命令返回值；任何返回值都被忽略。

如果`do`调用附加了后置条件的对象方法，则对象方法参数的最大数量为`253`。

`DO`入口点的最大总参数值为`382`；`DO`方法或使用名称间接寻址方式的`DO`的最大总参数值为`380`。这个总数最多可以包括`254`个实际参数和`128`个条件参数。可以使用`…`语法指定可变数量的参数。

通过从`do`命令的实际参数列表中省略相应的参数，可以不定义任何变量。但是，对于每个省略的实际参数，必须包括一个逗号作为占位符。

如果后置条件表达式附加到参数后，如果后置条件表达式为`TRUE`，则将执行该参数。如果后置条件表达式为`FALSE`，则跳过该参数并继续计算下一个参数或下一个命令。请注意，从左到右处理表达式。

DO ##class(PackageName.ClassName).ClassMethodName()

DO InstanceName.InstanceMethodName()

DO ^CodeToInvoke

`JOB`在后台运行代码。创建的进程独立于当前进程在后台运行。

JOB:pc jobargument,...

`JOB`只能按值传递参数，不能按引用传递参数。不能按多维数组传递参数。这与`do`命令不同，在`do`命令中，可以按值和按引用，按多维数组传递参数。

不能将对象引用传递给`JOB`进程。 这是因为对调用上下文中存在的对象的引用不能在新的`JOB`上下文中引用。传递`OREF`会导致将空字符串(`""`)传递到`JOB`进程。

启动`JOB`进程后，会为其分配单独的内存分区，并为其分配唯一的`JOB`编号(也称为进程`ID`或`PID`)。`JOB`进程号存储在`$JOB`特殊变量中。

`$ZPARENT`包含`JOB`处理当前进程的进程的`PID`(进程`ID`)，如果当前进程不是通过`JOB`命令创建的，则为`0`。

`$ZCHILD` 包含`JOB`命令创建的最后一个进程的`PID`，无论是否成功。确认`JOB`是否启用成功，必须要判断`$zchild`前后的值与超时。

通过使用`$ZCHILD`，可以通过比较运行`JOB`命令前后的`$ZCHILD`值来确定远程`JOB`的执行状态。如果`BEFORE`和`AFTER`值不同，并且`AFTER`值为非零，则`AFTER` `$ZCHILD`值是新创建的`JOB`的`PID`，表示进程已成功创建。如果`AFTER`值为零，或者`AFTER`值与`BEFORE`值相同，则不会创建`JOB`。

不即使释放`JOB`开启的多进程会造成`license`爆满的情况。

`$ZCHILD`只能告诉`JOB`已创建；它不会告诉`JOB`是否成功运行。确定进程是否运行无错误并运行到完成的最佳方法是在正在运行的代码中提供某种类型的日志记录和错误捕获。`JOB`机制不会以任何方式通知父进程进程错误或进程终止，无论成功与否。

a. 没有空闲分区。

b. 内存不足，无法使用`process-params`指定的特征创建分区。

c. 超过许可的进程数量。

`JOB`之间的通信,按值传递的参数只能在一个方向上进行，并且只能在`JOB`启动时进行。为了使进程相互通信，必须使用双方同意的`Global`。这类变量通常称为临时`Global`，使用临时`Global`目的是允许进程之间交换信息。

进程可以使用`%SYSTEM.Event`类方法在`JOB`之间通信。

设置临时`Global`。

多进程使用

消息队列

转移控制权

GOTO:pc
GOTO:pc goargument,...

无参数

有参数

如果在`For`、`If`、`Do While`或`While`循环中使用`GOTO`，则可以转到所有代码块外部的位置或当前代码块内的位置，或者从嵌套的代码块转到包围它的代码块中的位置。不能从一个代码块转到另一个代码块中的位置，无论是独立的代码块还是嵌套在当前代码块中的代码块。

转到代码块外部的位置将终止循环。转到代码块中的某个位置不会终止循环。从嵌套代码块到封闭代码块的`GOTO`会终止内部(嵌套)循环，但不会终止外部循环。

与`do`命令不同，`goto`无条件地转移控制权。`do`在调用的方法中遇到`QUIT`时，会将控制传递给最近的`DO`之后的命令。

当在`GOTO`转移后遇到退出时，不会将控制权交还给`GOTO`之后的命令。如果前面有一个`DO`，则它将控制权返回给最近一个`DO`之后的命令。如果前面没有`DO`，则直接结束。

`XECUTE`命令执行指定的命令。

`XECUTE`执行`ObjectScript`命令行，每个命令行由一个`xecutearg`指定。这些`xecutearg`按从左到右的顺序执行，每个执行都由可选的后置条件表达式控制。

XECUTE:pc xecutearg,... 
X:pc xecutearg,...

在使用`Xecute`命令之前，可以使用`%Library.Routine`类的`CheckSynTax()`方法对`xecutearg`命令行字符串执行语法检查。

因为`cmdline`是一个字符串，所以不能跨多个代码行断开。可以将单个`cmdline`参数分成多个字符串使用连接运算符连接在一起。

可以将单个`cmdline`参数分为多个单独的逗号分隔的`cmdline`参数。

`cmdline`的最大长度不能超过最大字符串长度。

可以在`cmdline`内、连接的`cmdline`字符串之间或逗号分隔的`cmdline`参数之间嵌入`/*text*/`注释。

`cmdline`可以计算为空字符串(`""`)。在这种情况下，不执行任何操作，并继续执行下一个`xecutearg`或下一条命令。

`Xecute`命令调用标签与方法。类方法中如果调用标签则类方法要加上关键字`[ Not ProcedureBlock ]`，否则`<NOLINE>`错误。

如果在`[ Not ProcedureBlock ]`的关键字类里，直接用`Xecute`赋值变量，则变量默认为全局变量。不需要引用传递出来。

如果`XECUTE`命令包含`DO`命令，则执行`DO`参数中指定的方法。当方法结束时时，会将控制返回到紧跟在`do`参数之后的命令。

`Xecute`命令，使用`for`循环。如果`XECUTE`参数包含`FOR`命令，则`FOR`的作用域是该参数的其余部分。当`XECUTE`参数中最外层的`for`终止时，`XECUTE`参数也将终止。

`XECUTE`支持在`XECUTE`参数中使用`XECUTE`命令。但是，应该谨慎使用`XECUTE`的嵌套调用。

在`XECUTE`内调用的代码的执行时间可能比在程序主体中遇到的相同代码的执行时间慢。这是因为每次处理`XECUTE`时，都会编译用`XECUTE`命令指定的源代码或包含在引用的全局变量中的源代码。

`XECUTE`命令不能用于定义标签。如果定义标签或例程。请使用`%Routine`类。

`Continue`命令在`For`、`While`或`Do While`命令之后的代码块内使用。`Continue`作用是跳过循环体中剩余的语句并到循环末尾而强行执行下一次循环。

CONTINUE:pc

Continue命令只在块级语法有效。

`Continue`不接受任何参数。

`QUIT` 命令终止当前上下文的执行，退出到封闭的上下文。在方法中调用时，`Quit`将返回调用方法，如果没有调用方法，则终止该程序。当从`FOR`、`DO WHILE`或`WHILE`控制流结构、`TRY`或`CATCH`块或传统`DO`结构（点语法）内调用时，`QUIT`会退出该结构并继续执行该结构之外的下一个命令。

QUIT:pc expression

Q n

`quit`在传统`DO`结构内调用时，`for`循环点语法与块语法`quit`相当于`continue`命令。

`QUIT`可用于退出旧语法的`DO`结构（无参数`DO`，后跟代码行，每行代码前加一个句点）。使用无参数`DO`结构代码块后面的命令继续执行。这种无参数的`DO`语法被认为已过时，不应用于新的编码。

带参数的`QUIT`不能用于从`FOR`，`DO WHILE`或`WHILE`命令循环中退出。带参数的`QUIT`也不能用于从`TRY`块或`CATCH`块中退出。

如果`IF`代码块未嵌套在循环结构内，则`QUIT`终止当前程序。

当遇到带有参数的标签时，将执行隐式`QUIT`。

在每个例程标签的末尾执行一个隐式`QUIT`，也可以显式指定`Quit`以提高程序的可读性。

`Retrun`命令用于终止方法的执行。在大多数情况下，与`QUIT`命令用法相同。在`FOR`、`DO WHILE`、`WHILE`循环命令与`TRY`-`CATCH`块中使用时，`RETURN`和`QUIT`有所不同。

RETURN:pc expression

retrun n

`Retrun`在版本`2010`没有此命令，之后的版本才有。

`Retrun`命令在传统的`For`循环点语法中与`Quit`功能一样。

`continue`退出本次循环。

`quit`退出循环。

`retrun`退出结束当前运行方法。

块语法`ret`可直接退出返回值。

点语法则需要用循环外变量去接收，在去判断返回值。

`set`命令为变量赋值。可以为单个变量赋值，也可以同时为多个变量赋值。

如果指定的变量不存在，则`SET`会创建该变量并赋值。如果存在指定的变量，则`SET`将用指定的值替换先前的值。由于`SET`按从左到右的顺序执行，因此可以为一个变量赋值，然后将该变量赋值给另一个变量。

SET variable = expression

SET variable1 = expression1, variable2 = expression2, variable3 = expression3

SET (variable1, variable2, variable3) = expression

`kill`命令从内存中删除变量，也可用于从磁盘中删除`Global`。

KILL expression

KILL x

KILL x,y,z

KILL (x)

删除多维数组，进程`Global`，`Global`节点时，会自动删除该节点的所有从属节点，以及该节点。

`Kill`参数用括号包括的形式会删除除指定变量之外的所有局部变量。但是不能指定进程私有全局变量、全局变量或特殊变量，多维数组。

不带参数的`kill`命令将删除所有局部变量。但不会删除进程私有`Gloabl`、`Gloabl`或系统特殊变量。

按值传递变量 - 在被调用的方法的上下文之外`kill`变量是无效的，`kill`变量仅在当前方法的上下文中有效果，当退出方法时自动恢复保存的值。

引用传递变量 - 执行`kill`变量，也会`kill`相应的实际变量。返回到调用方法时，实际变量将不会恢复。

**注：当遇到使用参数传递(无论是通过值传递还是通过引用传递)的方法时，会隐式地为形参列表中的每个变量执行一个`new`命令。当退出方法时，会隐式地为形参列表中的每个变量执行`kill`命令。在按引用传递变量的情况下，在执行`kill`之前更新相应的实际变量。**

`ZKILL`命令删除指定数组节点的值，而不会杀死该节点的后代。

与`kill`相反

`NEW`命令创建一个新的局部变量上下文。`NEW`命令在旧上下文中保留现有的局部变量值，然后启动一个新的上下文，在新上下文中没有为局部变量赋值，变量为未定义状态。

`NEW`最常在`do`命令调用的方法中使用。一般在方法开头使用初始化变量。

NEW

NEW x

NEW x, y, z

NEW (y)

NEW (y, z)

Globals - 全局变量

Process-Private Globals - 进程私有全局变量

Local variable subscripts - 多维数组

系统特殊变量

在类方法中，默认都是私有变量不能`NEW`。如果要使用`NEW`命令需要在类添加关键字`Not ProcedureBlock`。

`NEW`括号包裹的参数形式，最多可以指定`255`个变量作为逗号分隔的列表。 超过此数字发出`<SYNTAX>`错误。

当方法中，使用`new`命令如果超过`31`次也就是`31`级别，会引起`<MAXSCOPE>`错误。

将`Global`或多维数组节点并到目标变量。

`MERGE`命令将数据源复制到目标变量，并将数据源的所有后代复制到目标的后代。`MERGE`命令不修改数据源。

`MERGE` 简化了将变量的子树复制到另一个变量的过程。这两个变量都可以是带下标的局部变量、进程私有`Global`或`Global`。子树是指定变量的后代的所有变量。

`Merge`为当前的节点复制技术提供了命令替代方案：带有`$ORDER`引用的`SET`命令。

显示输出到当前设备。

WRITE:pc writeargument,...

无参数WRITE

`ZWRITE` 命令列出变量的名称及其值。在当前设备上以规范顺序以 `varname=value` 格式列出这些变量及其后代，每行一个变量。

ZWRITE:pc expression,...

不带表达式参数的`ZWRITE`在功能上与不带参数的WRITE相同。

在`Terminal`中不带参数的`ZWRITE`以`ASCII`名称顺序列出所有已定义的局部变量。

`ZWRITE`将数字字符串显示为规范数字。 `ZWRITE`显示一个数字字符串，其中包含规范形式的数字作为不带引号的规范数字。`ZWRITE`将非规范形式的数字字符串显示为带引号的字符串。

`ZWRITE`忽略未定义的变量。不会发出错误。如果在以逗号分隔的变量列表中指定一个或多个未定义变量，则`ZWRITE`会忽略未定义变量并返回已定义变量。如果为`WRITE`，`ZZDUMP`或`ZZWRITE`指定了未定义的变量，则会发出`<UNDEFINED>`错误。

如果变量具有已定义的子节点，则`ZWRITE`会按照下标顺序为每个子节点写一条单独的`varname = value`行。当指定根节点时，即使未定义根节点，`ZWRITE`也会显示其所有子节点。

`ZWRITE`显示所有字符。包含使用`$CHAR`函数显示不可打印字符，将每个不可打印字符表示为串联的`$c(n)`值。但不执行非打印控制字符。

如果表达式是多维属性，则`ZWRITE`将不显示该属性的后代。要使用`ZWRITE`显示整个多维属性，请将其`merge`到局部变量中并显示该数组或者`ZWRITE`对象。

可以为`ZWRITE`指定列表结构(`%List`)作为变量或表达式。 `ZWRITE`将列表结构显示为`$lb(element1，element2)`。

`ZWRITE`显示`Global`及其所有后代节点的内容。

`ZWRITE`显示`JSON`动态数组和`JSON`动态对象作为对象引用。引用的对象类为`%Library.DynamicArray`和`%Library.DynamicObject`。

可以将`ZWRITE`的位串指定为变量或表达式。如果`ZWRITE`参数是位串（使用`$BIT`函数创建），则`ZWRITE`将二进制串的十进制表示形式显示为`$ZWCHAR（$zwc）`两字节字符。

`ZWRITE`显示对象`oref`。如果指定了对象引用，则显示`ZWRITE variable=<OBJECT REFERENCE>[oref]`或 `<OBJECT REFERENCE>[oref]` 还显示对象属性的“常规信息`general information`”，“属性值`attribute values`”和“混合引用`swizzled references`”和“计算引用`calculated references`”，每行一个属性。

`general information` - 通用信息，包含引用次数，类型。

`attribute values` - 可以直接用点语法使用属性。

`swizzled references` - 为其他引用对象，如果不为空可以用点语法使用该对象。如果该对象里面有其他属性，可以使用连续点语法使用属性。

`calculated references` 表示该字段为由其他字段或方法计算而来。

`ZZDUMP`以十六进制转储格式显示表达式。在查看包含控制字符的字符串时很有用。

ZZDUMP:pc expression,...

`ZZDUMP` 显示单个变量长度超过`16`换行，第二个转储行（`0010:`)的位置为十六进制，第三个转储行（`0020:`)，以此类推。

`ZZDUMP`返回字符串变量的十六进制转储。请注意，每个逗号分隔的表达式都被视为`ZZDUMP`的单独调用。对于空字符串变量，不会返回十六进制转储。

`ZZDUMP`表达式中的有一个字符是宽字符（`Unicode`），则该表达式中的所有字符都表示为宽字符。

`ZZWRITE `命令计算一个表达式并在当前设备上显示一个值。该表达式可以是文字、局部变量、进程私有`Global`、`Global`或特殊变量。

ZZWRITE:pc expression,...

没有参数的`ZZWRITE`是空操作。它不执行任何操作，也不发出错误`。ZZWRITE`可以计算以逗号分隔的表达式列表。它以指定的顺序显示结果，每行一个表达式。 `ZZWRITE`将每个表达式的结果显示为`%val = value`。

`ZZWRITE`也可以显示对象`oref`具体信息与`##class(%SYSTEM.OBJ).Dump()`显示相同。

未定义的变量：`ZZWRITE`对未定义的变量发出`<UNDEFINED>`错误。 `ZWRITE`忽略未定义的变量。

下标：`ZZWRITE`显示指定下标节点的值。 `ZWRITE`以下标树的顺序显示下标节点和所有定义的子节点。

变量名称：`ZZWRITE`将每个表达式或变量的值显示为`%val = value`。 `ZWRITE`将局部变量，进程私有`Global`和`Global`显示为`varname = value`，并将文字值，表达式和特殊变量显示为`value`。

无参数 `WRITE`显示每个定义的局部变量的名称和值，每行一个变量。列出公有变量和私有变量。不列出`Global`、进程私有`Global`或特殊变量。按排序顺序列出变量。以下标树顺序列出下标变量。

无参数 `ZWRITE`在功能上与无参数`WRITE`相同。

无参数 `ZZDUMP`是生成`<SYNTAX>`错误的无效命令。

无参数 `ZZWRITE`是返回空字符串的无操作。

见，输出命令百讲表格