第四十一章 XML 映射参数摘要

第四十章 其他特殊主题 - 处理导入时意外的元素和属性

处理导入时意外的元素和属性

由于源 XML 文档可能包含意外的元素和属性，因此支持 XML 的类提供两个参数来指定导入此类文档时如何反应。例如，考虑以下类定义：

Class GXML.TestImportParms.Person Extends (%Persistent,%XML.Adaptor) 
{

Property Name As %Name [ Required ];
Property DOB As %Date(FORMAT = 5, MAXVAL = "+$h") [ Required ];
}

另请考虑以下 XML 文档：

<?xml version="1.0" encoding="UTF-8"?

第三十九章 其他特殊主题 - 映射 IRIS ID 以供导出

当在顶层映射 IRIS 对象（而不是作为另一个对象的属性）时，其内部 ID、OID 和全局唯一 ID 不能用作对象属性，因此不会映射这些 ID。但是，在某些情况下，可能希望使用对象 ID 作为唯一标识符。然后，例如，可以在更新存储的对象之前将传入（已更改）的对象与相应的存储对象进行匹配。

IRIS XML 支持提供了多个帮助程序类，可用于将 IRIS 对象标识符投影到 XML 文档： %XML.Id 中（对于内部 ID）、%XML.Oid（对于 ``）和 %XML.GUID（用于全局唯一 ID）。

要使用这些类，请向支持 XML 的类添加一个特殊属性，该属性的用途是包含要导出的 ID。该属性的类型必须为 %XML.Id、%XML.Oid或 %XML.GUID。确保该属性已映射，并将其标记为瞬态，以便它不包含在该类的 SQL 映射中。

当导出到 XML 时，将支持 XML 的类的对象带入内存。当对象位于内存中时，添加的特殊属性将从 IRIS 内部存储中检索请求的 ID 并包含该值（以便您可以导出它）。

例如，考虑以下类：

Class MyApp4.Obj.Person4 Extends (%Persistent,%Populate,%XML.Adaptor) 
{

Property IdForExport As %XML.

第三十八章 其他特殊主题

类和属性参数

• XMLNAME
• XMLSEQUENCE
• XMLUNSWIZZLE
• XMLPREFIX
• XMLIGNOREINVALIDTAG
• XMLIGNOREINVALIDATTRIBUTE

控制元素的关闭

在 XML 中，仅包含属性的元素可以用以下任一方式表示：

<tag attribute="value" attribute="value" attribute="value"></tag>
<tag attribute="value" attribute="value" attribute="value"/>

IRIS 认为这些形式是等效的。当使用 %XML.Writer 导出对象时，可以控制关闭形式，但不能通过修改 XML 投影本身来控制。

处理具有多个同名标签的文档

XML 中的给定元素可以包含多个具有相同名称的元素；这些元素通过它们的顺序彼此区分。例如，以下是一个合法的 XML 文档：

<?xml version="1.0" encoding="UTF-8"?

第三十七章 XML 模式的高级选项 - 超类如何表示为类型

超类如何表示为类型

如果需要 XML 架构来显示特定的类型层次结构，则需要了解映射如何解释 IRIS 类层次结构。

类层次结构代表了有意义的数据组织等。该层次结构尽可能地反映在相应的 XML 类型定义中。

例如，假设有以下类：

• 名为 Base 的类，定义了三个公共属性（Property1、Property2 和 Property3）。
• 名为 Addition1 的类，它扩展 Baseand 并定义一个附加公共属性 (Addition1)。
• 名为 Addition2 的类，它扩展 Addition1 并定义一个附加公共属性 (Addition2)。

Addition2 的架构应包含什么？它必须代表所有五个属性。另外，因为这些类都是用户定义的，所以 Addition2 的架构应该显示类层次结构的详细信息；相反，如果 Base 从 IRIS 类库扩展一个类，而 IRIS 类库又从该库扩展其他类，那么这些细节就不那么有趣了。

第三十六章 XML 模式的高级选项 - 创建子类型的替换组

创建子类型的替换组

XML 模式规范还允许定义替换组，这可以是创建选择的替代方法。语法有些不同。

第三十五章 XML 模式的高级选项 - 创建子类型的选择列表

创建子类型的选择列表

根据 XML Schema 规范，复杂类型可以由类型（特别是相关类型）的选择列表组成。假设我们希望架构允许使用 , , or 元素，而不是 元素。要定义这样的架构，我们会将 Person 属性的 XMLTYPECONSTRAINT 属性参数设置为等于“CHOICE”，如下所示：

Class UsingSubclasses.Example2 Extends (%Persistent, %XML.Adaptor)
{
Property Person As UsingSubclasses.Person(XMLTYPECONSTRAINT = "CHOICE");
}

默认情况下，选择列表由 Person 类的所有子类组成。

第三十四章 XML 模式的高级选项

类和属性参数

• XMLTYPECONSTRAINT

• XMLINCLUDEINLIST

• XMLINHERITANCE

自动创建子类的类型

当为一个类定义 XML 投影时，它的所有子类都会自动映射到单独的类型，所有这些类型都使用超类作为基类型。这意味着无论何时使用超类型，都可以使用其中一种子类型。还可以使用子类型在 XML 模式中定义选择列表或替换组。

请注意，可以为抽象类定义 XML 映射；该类在任何派生类模式中都显示为基类型，尽管它是抽象的，无法实例化。

考虑一个例子。我们从一个简单的 Person 类开始：

Class UsingSubclasses.Person Extends (%Persistent, %XML.Adaptor)
{
Property Name As %String [Required];
Property DOB As %Date(FORMAT = 5, MAXVAL = "+$h") [Required];
}

假设我们有两个直接基于 Person 类的类。首先是 Patient 类：

Class UsingSubclasses.Patient Extends UsingSubclasses.

第三十三章 控制到 XML 模式的映射 - 其他支持 XML 的类到 XML 类型的映射

其他支持 XML 的类到 XML 类型的映射

对于支持 XML 的类或基于支持 XML 的类的属性，XML 类型按如下方式确定： 如果该类具有 XMLTYPE 参数的值，则该值将用作类型名称。否则，短类名将被视为 XML 类型名。

例如，考虑以下类定义：

Class GXML.PersonWithAddress Extends (%Persistent, %XML.Adaptor) 
{
Parameter XMLTYPE = "PersonType";

Property Name As %Name;

Property DOB As %Date(FORMAT = 5, MAXVAL = "+$h");

Property HomeAddress As GXML.Address;

}

对于此类的实例，XML 类型是 PersonType，它取自 XMLTYPE 参数。

假设 GXML.Address 类不包含 XMLTYPE 参数。在本例中，对于 元素，XML 类型是 Address，它是短类名。

指定类型的命名空间

XML 类型分配给命名空间，如下所示：

1. 如果相应的类定义定义了 XSDTYPE 类参数，则该类型位于以下 W3 命名空间中：

http://www.w3.

第三十二章 控制到 XML 模式的映射 - %ListOfObjects

本部分显示了从支持 XML 的类生成的 XML架构的一部分，该类包含定义为 %ListOfObjects 的属性。例如，考虑以下属性定义：

Property PropName As list Of %Integer(XMLITEMNAME = "MyXmlItemName");

如果此属性位于名为 Test.DemoObjList1 的启用 XML 的类中，则该类的 XML 架构包含以下内容：

<schema xmlns="http://www.w3.org/2001/XMLSchema" xmlns:s="http://www.w3.

第三十一章 控制到 XML 模式的映射 - %ListOfDataTypes

%ListOfDataTypes

本部分显示从支持 XML 的类生成的 XML 架构的一部分，该类包含中定义为%ListOfDataTypes 的属性。例如，考虑以下属性定义：

Property PropName As %ListOfDataTypes(XMLITEMNAME = "MyXmlItemName");

如果此属性位于名为 Test.DemoList 的启用 XML 的类中，则该类的 XML 架构包含以下内容：

<schema xmlns="http://www.w3.org/2001/XMLSchema" xmlns:s="http://www.w3.

第三十章 控制到 XML 模式的映射 - Array of Classname

Array of Classname

本部分显示了从启用 XML 的类生成的XML 架构的一部分，此时该类包含定义为类名数组的属性。例如，考虑以下属性定义：

Property PropName As array Of %Integer(XMLITEMNAME = "MyXmlItemName", XMLKEYNAME = "MyXmlKeyName");

如果此属性位于名为 Test.DemoArray1 的启用 XML 的类中，则该类的 XML 架构包含以下内容：

<schema xmlns="http://www.w3.org/2001/XMLSchema" xmlns:s="http://www.w3.

浅谈一下个人基于IRIS后端业务开发框架的理解

现状

由于国内使用基于M语言IRIS平台几乎都在医疗行业。医疗系统又非常的庞大和复杂。前期由于快速占领市场，系统数量越来越多，到了临界点后就产生了质变，所以前期基于功能的线性开发注重效率，所以导致大量的产品业务代码有如下集中情况：

• 系统交互乱如麻，各系统的交互关系变成了网状。
• 系统规模庞大，内部耦合严重，牵一发而动全身，后续修改和扩展困难，开发效率低。
• 关键功能逻辑复杂，容易出现问题，出现问题后很难排查和修复，开发成本高。
• 功能越来越多，导致系统复杂度指数级上升。
• 重复造轮子，相似的功能不断重复开发。

如上图所示，这仅仅是展示了五个模块之前的交互，在此基础上继续增加模块则复杂度成指数级上升，并且如果每个模块之间如果没有做好接口管理，维护起来也是地狱级别。

如何解决这个问题，一般会分为两派：优化派与架构派。

优化派的思想是将现有的系统优化。例如重构某个方法，优化某个SQL。优化派的优势是针对系统改动较小，可以保持系统的稳定性，可以快速实施，缺点是治标不治本，随着需求越来越多，增加的代码量越多，后期还是会撑不住。

架构派的核心思想是调整系统架构，将原来的大系统拆分为多个互相配合的小系统，例如药库系统拆分为，采购模块，订单模块，查询模块，分析模块等。架构派的优势是一次调整可以支撑比较长期的业务发展，缺点是动作较大，耗时较长，稳定性需要项目考验。

[toc]

第三十三章 Objects - OREFs

OREFs

对象类的 %New() 方法创建一个内部内存结构来包含对象的数据，并返回指向该结构的 OREF（对象引用）。 OREF 是 IRIS 中的一种特殊值。应该记住以下几点：

• 在终端中，OREF 的内容取决于所使用的语言：
  • 在 ObjectScript 中，会看到一个由数字、@ 符号和类名称组成的字符串。
  • 在 Python 中，会看到一个包含类名和内存中 18 个字符的唯一位置的字符串。

例如：

TESTNAMESPACE>set myobj=##class(Sample.Person).%New()
 
TESTNAMESPACE>w myobj
3@Sample.Person 

>>> myobj=iris.cls("Sample.Person")._New()
>>> print(myobj)
<iris.Sample.Person object at 0x000001A1E52FFD20>

• 如果没有使用预期的 OREF 或者使用了错误类型的 OREF，IRIS 将返回错误。此错误与 ObjectScript 终端和 Python 终端不同：

TESTNAMESPACE>set x=2

TESTNAMESPACE>set x.Name="Fred Parker"

SET x.

第三十一章 Classes - 继承规则

继承规则

与其他基于类的语言一样，可以通过继承组合多个类定义。 类定义可以扩展（或继承）多个其他类。这些类又可以扩展其他类。

请注意，类不能继承 Python 中定义的类（即 .py 文件中包含的类定义），反之亦然。

以下小节提供了中类继承的基本规则。

继承顺序

使用以下继承顺序规则：

1. 默认情况下，如果在多个超类中定义了给定名称的类成员，则子类将从超类列表中最左边的类中获取定义。
2. 如果类定义包含 Inheritance = right，则子类从超类列表中最右侧的类中获取定义。

由于历史原因，大多数类都包含 Inheritance = right。

主要的超类

任何扩展其他类的类都有一个主要超类。

无论类使用哪种继承顺序，主超类都是第一个，从左到右阅读。

对于任何类级编译器关键字，给定类使用其主超类中指定的值。

对于持久化类来说，主超类尤其重要。

最具体的类型类Most-Specific Type Class

尽管一个对象可以是属于多个类extent的实例（例如各种超类的extent），但它始终具有最特定的类型类 (MSTC)。当该对象是该类的实例但不是该类的任何子类的实例时，类是该对象的最具体类型。

重写方法

类从其一个或多个超类继承方法（类方法和实例方法），可以覆盖这些方法。如果这样做，必须确保方法定义中的签名与要重写的方法的签名匹配。

第三十章 Classes - 方法生成器

方法生成器

方法生成器是类编译器在类编译期间调用的程序。它的输出是该方法的实际运行时实现。方法生成器提供了一种继承方法的方法，可以生成根据继承类或属性的需要定制的高性能、专用代码。在 IRIS 库中，方法生成器广泛用于数据类型和存储类。

Class Queries

类可以包含类查询。类查询定义可由该类使用的 SQL 查询，并指定用作查询容器的类。下面显示了一个示例：

Query QueryName(Parameter As %String) As %SQLQuery
{
SELECT MyProperty, MyOtherProperty FROM MyClass
 WHERE (MyProperty = "Hello" AND MyOtherProperty = :Parameter)
 ORDER BY MyProperty
}

定义类查询以提供预定义的查找以供在应用程序中使用。例如，可以按某些属性（例如按名称）查找实例，或提供满足一组特定条件的实例列表，例如从巴黎到马德里的所有航班。此处显示的示例使用参数，这是提供灵活查询的常用方法。请注意，可以在任何类中定义类查询；不需要在持久类中包含类查询。

第二十八章 Classes - 引用其他类的方法

引用其他类的方法

在方法(或例程)中，使用下面的语法来引用其他类中的方法:

要调用类方法并访问其返回值，请使用如下表达式:

 ##class(Package.Class).MethodName(arguments)

iris.cls("Package.Class").MethodName(arguments)

例如：

 Set x=##class(Util.Utils).GetToday()

x=iris.cls("Util.Utils").GetToday()

也可以调用一个类方法而不访问它的返回值，如下所示:

 Do ##class(Util.Utils).DumpValues()

iris.cls("Util.Utils").DumpValues()

注意:##class不区分大小写。

• 要调用实例方法，创建一个实例，然后在ObjectScript或Python中使用如下表达式来调用该方法并访问其返回值:

instance.MethodName(arguments)

例如：

 Set x=instance.GetName()

x=instance.GetName()

你也可以在不访问返回值的情况下调用实例方法，方法如下:

 Do instance.InsertItem("abc")

instance.

第二十七章 Classes - 引用其他类成员

引用其他类成员

在方法中，使用下面的语法来引用其他类成员:

• 要引用ObjectScript中的参数，使用如下表达式:

 ..#PARAMETERNAME

只能使用ObjectScript直接访问参数。要从Python访问参数，请使用ObjectScript包装器方法返回参数，并在需要时调用此方法。例如:

Class User.Employee Extends %RegisteredObject
{

Parameter ADDRESS = "123 Main St.";

ClassMethod AddressWrapper() As %String [ Language = objectscript ]
{
    return .#ADDRESS
}

ClassMethod OfficeLocation() [ Language = python ]
{
    import iris
    location=iris.cls("User.Employee").

第二十六章 Classes - Methods

Methods

方法有两种：实例方法和类方法（在其他语言中称为静态方法）。

指定方法关键字

在方法定义中，可以包含影响方法行为的可选编译器关键字。以下列表显示了一些最常见的方法关键字：

Language

在 IRIS 中，可以用 ObjectScript 或 Python 编写方法。要指定编写方法所用的语言，请使用以下语法：

Method MyMethod() [ Language = objectscript ]
{
    // implementation details written in ObjectScript
}

Method MyMethod() [ Language = python ]
{
    # implementation details written in Python
}

如果方法不使用 Language 关键字，编译器将默认该方法是用 ObjectScript 编写的。

必须以全部小写字母编写方法的语言，如示例中所示。

Private

该关键字指定该方法是私有的，并且只能与 ObjectScript 方法一起使用。子类继承 Private 关键字的值并且不能覆盖它。

默认情况下，方法是公共的并且可以在任何地方访问。可以将方法标记为私有（通过 Private 关键字）。如果你这样做：

• 只能通过它所属类的方法来访问。

第二十五章 Classes - 基于数据类型的属性

基于数据类型的属性

当定义属性并将其类型指定为数据类型类时，可以使用特殊选项来定义和使用该属性，如本节中所述。

数据类型类

数据类型类使能够强制执行有关属性值的规则集。

IRIS 提供的数据类型类包括 %Library.String、 %Library.Integer、 %Library.Numeric、%Library.Date等等。因为 %Library 包的类名可以缩写，所以可以缩写其中的许多类；例如， %Date 是 %Library.Date的缩写。

每个数据类型类都具有以下特征：

• 它指定编译器关键字的值。对于属性，编译器关键字可以执行以下操作：

  • 使属性成为必需的
  • 指定属性的初始值
  • 控制如何将属性映射到 SQL、ODBC 和 Java 客户端

• 它指定影响细节的参数值，如下所示：

  • 数据类型允许的最大和最小逻辑值
  • 字符串可以包含的最大和最小字符数
  • 小数点后的位数
  • 如果字符串超过最大字符数是否截断
  • 显示格式
  • 如何转义任何特殊的 XML 或 HTML 字符
  • 可在任何用户界面中使用的逻辑值和显示值的枚举列表
  • 字符串必须匹配的模式（自动使用模式匹配运算符）
  • 导入或导出到 XML 时是否尊重或忽略 UTC 时区

• 它提供了一组方法来在存储（磁盘上）、逻辑（内存中）和显示格式之间转换文字数据。

可以添加自己的数据类型类。

第二十四章 Classes - 指定属性关键字

指定属性关键字

在属性定义中，可以包含影响属性使用方式的可选属性关键字。以下列表显示了一些最常见的关键字：

Required

指定可以将此类实例之前设置的属性值存储到磁盘。默认情况下，属性不是必需的。在子类中，可以将可选属性标记为必需，但不能执行相反的操作。

InitialExpression

指定属性的初始值。默认情况下，属性没有初始值。子类继承InitialExpression关键字的值并且可以覆盖它。指定的值必须是有效的 ObjectScript 表达式。

Transient

指定该属性不存储在数据库中。默认情况下，属性不是瞬态的。子类继承 Transient 关键字的值并且不能覆盖它。

Private

指定该属性是私有的。子类继承 Private 关键字的值并且不能覆盖它。

默认情况下，属性是公共的并且可以在任何地方访问。可以将属性标记为私有（通过 Private 关键字）。如果是这样，则只能通过其所属对象的方法来访问它

在 IRIS 中，私有属性始终是继承的，并且对定义该属性的类的子类可见。

在其他编程语言中，这些通常称为受保护的属性。

Calculated

指定在实例化包含该属性的对象时，没有为其分配内存存储。默认情况下，不计算属性。子类继承了Calculated关键字并且不能重写它。

MultiDimensional

指定属性是多维的。

第二十三章 Classes - 属性

形式上 IRIS 有两种属性：

• 属性，保存值。该值可以是以下任意值：

  • 单个文字值，通常基于数据类型。
  • 对象值（包括集合对象和流对象）。
  • 多维数组。这种情况不太常见。

  属性一词通常仅指作为properties的attributes，而不是指具有关联的属性。

• 关系，保持对象之间的关联。

可以在包含 ObjectScript 方法、Python 方法或两者组合的类中定义属性。但是，无法从 Python 方法访问关系。本节展示了一个示例类，其中包含显示以下一些变体的属性定义：

Class MyApp.Main.

第二十二章 Classes - 调用类方法的快捷方式

调用类方法的快捷方式

使用 ObjectScript 调用类方法时，在以下情况下可以省略包（或更高级别的包）：

• 引用是在一个类内，并且被引用的类在同一个包或子包中。
• 引用位于类内，并且该类使用 IMPORT 指令导入包含引用的类的包或子包。
• 该引用位于方法内，并且该方法使用 IMPORT 指令导入包含引用的类的包或子包。

从 ObjectScript 或 Python 调用类方法时，在以下情况下可以省略包（或更高级别的包）：

• 指的是 %Library 包中的一个类，该类是经过特殊处理的。可以将类 %Library.ClassName 引用为 %ClassName。例如，可以将 %Library.String引用为 %String。
• 指的是 User 包中的一个类，该类是经过特殊处理的。例如，可以将 User.MyClass 引用为 MyClass。

在 User 包中不提供任何类，这些类是保留给使用的。

在所有其他情况下，必须始终使用完整的包和类名称来调用类方法。

类参数

类参数定义一个对于给定类的所有对象都相同的值。除了极少数例外，该值是在编译类时确定的，并且不能在运行时更改。将类参数用于以下目的：

• 定义一个在运行时无法更改的值。
• 定义有关类定义的用户特定信息。类参数只是一个任意的名称-值对；可以使用它来存储您喜欢的有关课程的任何信息。

第十九章 ObjectScript - 执行例程

执行例程

执行例程时，使用DO命令，如下所示:

 do ^routinename

要执行一个过程、函数或子程序(不访问其返回值)，可以使用以下命令:

 do label^routinename

或

 do label^routinename(arguments)

要执行过程、函数或子例程并引用其返回值，可以使用$$label^routinename或$$label^routinename(参数)形式的表达式。例如:

 set myvariable=$$label^routinename(arguments)

在所有情况下，如果标签位于同一个例程中，则可以省略插入符号和例程名称。例如:

 do label
 do label(arguments)
 set myvariable=$$label(arguments)

在所有情况下，传递的参数可以是文字值、表达式或变量名。

New 命令

IRIS提供了另一种机制，使能够控制例程中变量的作用域:NEW命令。此命令的参数是一个或多个变量名，以逗号分隔的列表表示。变量必须是公共变量，不能是Global。

该命令为变量建立一个新的有限上下文(可能已经存在，也可能不存在)。

第十八章 ObjectScript - 使用例程

例程

可以将例程视为 ObjectScript 程序。例程可以从头开始编写，也可以在编译类时自动生成。

Procedures, Functions, and Subroutines 过程、函数和子程序

在 ObjectScript 例程中，标签定义以下代码单元之一的起点：

• Procedures过程（可选地返回一个值）。过程中定义的变量是该过程私有的，这意味着它们不可用于其他代码。对于函数和子例程来说，情况并非如此。

过程也称为过程块。

• 函数（返回值）。
• 子例程（不返回值）。

建议使用过程Procedures，因为这可以简化控制变量范围的任务。然而，在现有代码中，可能还会看到函数和子例程，并且能够识别它们非常有用。以下列表显示了所有这些形式的代码的外观。

procedure

label(args) scopekeyword {
    zero or more lines of code 
    QUIT returnvalue
    }

或者

label(args) scopekeyword {
    zero or more lines of code 
    }

label 是过程的标识符。

args 是可选的以逗号分隔的参数列表。即使没有参数，也必须包含括号。

第十七章 ObjectScript - 使用宏和包含文件

使用宏和包含文件

如前所述，可以定义宏并稍后在同一类或例程中使用它们。更常见的是，在包含文件中定义它们。

Macros

ObjectScript 支持定义替换的宏。定义可以是一个值、整行代码或（使用 ##continue 指令）多行。

要定义宏，请使用#define 指令或其他预处理器指令。例如：

#define macroname <definition> 

要引用宏，请使用以下语法：

$$$macroname

或者：

$$$macroname(arguments)

使用宏来确保一致性。例如：

 #define StringMacro "Hello, World!"

 write $$$StringMacro

为了让了解宏可以做什么，以下示例显示了内部使用的宏的定义：

 #define CALL(%C,%A) $$$INTCALL(%C,%A,Quit sc) 

这个宏接受参数，就像许多宏一样。它还引用了另一个宏。

一些系统类广泛使用宏。

预处理器指令记录在 ObjectScript 宏和使用 ObjectScript 中的宏预处理器中。

注意：管理门户列出了包含例程的Include files 。然而，Include files 实际上并不是例程，因为它们不可执行。

第十六章 ObjectScript - 日期和时间值

日期和时间值

当地时间

要访问当前进程的日期和时间，可以使用 $HOROLOG 特殊变量。因此，在许多 IRIS 应用程序中，日期和时间都以此变量使用的格式存储和传输。这种格式通常称为$H 格式或$HOROLOG 格式。

$HOROLOG 从操作系统检索日期和时间，因此始终位于本地时区。

IRIS 类库包含以更常见的格式（例如 ODBC）表示日期的数据类型类，许多应用程序使用这些数据类型而不是 $H 格式。请注意，通过数据类型类中的 %Library.PosixTime支持 POSIX 时间，新应用程序应使用该类来表示日期/时间值。

UTC Time

IRIS 还提供 $ZTIMESTAMP 特殊变量，其中包含 $H 格式的协调世界时值形式的当前日期和时间。这是全球时间和日期标准；该值很可能与本地时间（和日期）值不同。

日期和时间转换

ObjectScript 包含用于转换日期和时间值的函数。

给定 $H 格式的日期，函数 $ZDATE 返回一个表示指定格式的日期的字符串。

例如：

TESTNAMESPACE>WRITE $ZDATE($HOROLOG,3)
2010-12-03

给定 $H 格式的日期和时间，函数 $ZDATETIME 返回一个表示指定格式的日期和时间的字符串。

第十四章 ObjectScript - 系统函数

系统函数

本节重点介绍 ObjectScript 中一些最常用的系统函数。

这些函数的名称不区分大小写。

类库还提供了大量实用方法，可以像使用函数一样使用它们。

Value Choice

在给定一些输入的情况下，可以使用以下函数来选择一个值：

• $CASE 将给定的测试表达式与一组比较值进行比较，然后返回与匹配的比较值关联的返回值。例如：

TESTNAMESPACE>set myvar=1
 
TESTNAMESPACE>write $CASE(myvar,0:"zero",1:"one",:"other")
one

• $SELECT 检查一组表达式并返回与第一个 true 表达式关联的返回值。例如：

TESTNAMESPACE>set myvar=1
 
TESTNAMESPACE>write $SELECT(myvar=0:"branch A",1=1:"branch B")
branch B

存在函数

可以使用以下函数来测试变量或变量节点是否存在。

• 要测试特定变量是否存在，请使用 $DATA 函数。

对于包含多个节点的变量，该函数可以指示给定节点是否存在，以及给定节点是否有值和子节点。

• 要获取变量的值（如果存在）或获取默认值（如果不存在），请使用 $GET 函数。

列表函数

ObjectScript 提供本机列表格式。

第十三章 ObjectScript - 特殊变量

特殊变量

一些特殊变量提供有关代码运行环境的信息。其中包括以下内容：

• $HOROLOG，包含操作系统给出的当前进程的日期和时间。请参阅日期和时间值。
• $USERNAME 和 $ROLES，包含有关当前使用的用户名以及该用户所属角色的信息。

 write "You are logged in as: ", $USERNAME, !, "And you belong to these roles: ",$ROLES

• $ZVERSION，其中包含标识当前运行的 IRIS 版本的字符串。

其他包括 $JOB、$ZTIMEZONE、$IO 和 $ZDEVICE。

其他变量提供有关代码处理状态的信息。其中包括 $STACK、$TLEVEL、$NAMESPACE 和 $ZERROR。

$SYSTEM 特殊变量

特殊变量 $SYSTEM 提供对大量实用方法的轻松访问。

特殊变量 $SYSTEM 是 %SYSTEM 包的别名，其中包含提供可满足各种需求的类方法的类。引用 %SYSTEM 中方法的惯用方法是构建使用 $SYSTEM 变量的引用。例如，以下命令在类中执行 %SYSTEM.OBJ 中的 SetFlags() 方法：

 DO $SYSTEM.OBJ.

第十二章 ObjectScript - 命令

命令

本节概述了在 ObjectScript 常用命令。其中包括与其他语言中的命令相似的命令，以及其他语言中没有等效项的其他命令。

命令名称不区分大小写，尽管按照惯例它们在运行文本中显示为全大写。

熟悉的命令

ObjectScript 提供命令来执行熟悉的任务，如下所示：

• 要定义变量，请使用 SET（如前所示）。

• 要删除变量，请使用 KILL，如前所示。

• 要控制逻辑流程，请使用以下命令：

  • IF、ELSEIF 和 ELSE 一起工作
  • FOR
  • WHILE，可以单独使用
  • DO 和 WHILE 可以一起使用
  • QUIT，也可以返回一个值

  还有其他用于流量控制的命令，但使用频率较低。

• 要捕获错误，请使用 TRY 和 CATCH，它们一起工作。

• 要写入值，请使用 WRITE。这会将值写入当前设备（例如，终端或文件）。

  在不带参数的情况下使用该命令会写入所有局部变量的值。

  此命令可以使用一小组格式控制代码字符来定位输出。在现有代码中，可能会看到感叹号，它开始一个新行。例如：

   write "hello world",!,"another line"
  

• 要从当前设备（例如终端）读取值，请使用 READ。

• 要使用主设备以外的设备，请使用以下命令：

  • OPEN 使设备可供使用。