第十章 ObjectScript 系统宏（一）

使这些宏可访问

本页描述的宏可用于 %RegisteredObject 的所有子类。要使这些在例程或不扩展 %RegisteredObject 的类中可用，请包含适当的文件：

对于与状态相关的宏，请包含 %occStatus.inc。
对于与消息相关的宏，请包含 %occMessages.inc

此类语句的语法是：

#include %occStatus

这些包含文件的名称区分大小写。

宏引用

宏名称区分大小写。 IRIS 提供的宏包括：

`ADDSC (sc1, sc2)`

ADDSC 宏将 %Status 代码 (sc2) 附加到现有%Status 代码 (sc1)。该宏需要 %occStatus.inc。

`EMBEDSC(sc1, sc2)`

EMBEDSC 宏将 %Status 代码 (sc2) 嵌入到现有 %Status 代码 (sc1) 中。该宏需要 %occStatus.inc。

`ERROR(errorcode, arg1, arg2, ...)`

ERROR 宏使用对象错误代码 (errorcode) 创建 %Status 对象，该对象的关联文本可以接受一定数量的 %1、%2 等形式的参数。然后，ERROR 根据这些附加参数的顺序将这些参数替换为错误代码后面的宏参数（arg1、arg2 等）。该宏需要 %occStatus.inc。

`FormatMessage(language,domain,id,default,arg1,arg2,...)`

FormatMessage 宏使能够从消息字典中检索文本，并用文本替换消息参数，所有这些都在同一个宏调用中进行。它在返回 %String。

`Argument`	`Description`
`language`	`RFC1766Op` 语言代码。在 `Web` 应用程序中，可以指定 `%response.Language` 以使用默认区域设置。
`domain`	消息域。在 `Web` 应用程序中，可以指定 `%response.Domain`
`id`	消息 `ID`。
`default`	如果未找到由语言、域和 `ID` 标识的消息，则使用该字符串。
`arg1, arg2, and so on`	消息参数的替换文本。所有这些都是可选的，因此即使消息没有参数，也可以使用 `$$$FormatMessage`。

该宏需要 %occMessages.inc。