第十章 ObjectScript 系统宏（一）

文章目录

• 第十章 ObjectScript 系统宏（一）
• 使这些宏可访问
• 宏引用
• • • • [`ADDSC (sc1, sc2)`](#ADDSC (sc1, sc2))
      • [`EMBEDSC(sc1, sc2)`](#EMBEDSC(sc1, sc2))
      • [`ERROR(errorcode, arg1, arg2, ...)`](#ERROR(errorcode, arg1, arg2, ...))
      • `FormatMessage(language,domain,id,default,arg1,arg2,...)`

第十章 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。