属性 / 组件 / 值(ACV)

上一节列出的每个运算符都有一个或多个实现它的 EMA 库函数。大多数运算符函数有一个或多个参数,用于指明该运算符所作用的模型或对象。但是,属性读取与设置函数在参数方面具有一种特殊的接口。为了更加简洁高效,这些函数允许同时访问或赋值模型或对象的多个属性。该特性通过传递可变数量的参数来实现,其基础是 C 语言标准支持集的一部分——varargs 接口。

每个单独的属性操作都由三个参数组成:

  • Attribute(属性)
  • Component(组件)
  • Value(值)

Attribute 参数指定要操作对象或模型的哪个属性。Component 参数指定要操作该属性的哪个组件(到目前为止,本文档中唯一介绍过的属性组件是属性“contents”(内容))。Value 参数指定用作属性某个组件值之来源或目标的变量或常量。这三个参数称为一个 ACV,而构成 attr_get 与 attr_set 运算符参数的 ACV 序列称为 ACV 列表(ACV List)。ACV 列表以符号常量 EMAC_EOL(即表示列表结束的 EMA 符号常量)终止。

以下各行说明了这些概念:

	<ACV> = <attribute_arg>, <component_arg>, <value_arg>
	<ACV List> = <ACV>, <ACV>, ..., EMAC_EOL

组件机制用于支持对带有类型修饰符的属性(如数组属性或 toggle 属性)的操作。下面将逐一介绍各个属性组件,并给出针对每种核心类型的属性声明值的示例。

Contents 组件

此前已经介绍过、且在运算符调用中使用最频繁的属性组件是属性的内容(contents)。该组件通过将 ACV 的第二个参数设置为符号常量 COMP_CONTENTS 来指明。

contents 组件的 ACV 形式为:

	<attr_name>, COMP_CONTENTS, <value>

根据属性的核心类型不同,作为 ACV 值使用的变量应按下表所示以不同方式声明和传递。另请注意,attr_set 运算符中的 ACV 可以包含与属性核心类型相对应的 C 数据类型的常量值(例如整数与对象 ID (10)、双精度数 (10.1112),或字符串 (“constant”));C 语言的全部参数约定均适用。

表 4:COMP_CONTENTS 值类型

核心类型 值声明 运算符 ACV 形式
整数(integer) int var; attr_get
attr_set
A, C, &var
A, C, var
双精度数(double) double var; attr_get
attr_set
A, C, &var
A, C, var
字符串(string) char var [256]; attr_get
attr_set
A, C, var
A, C, var
文本列表(textlist) PrgT_List *var; attr_get
attr_set
A, C, &var
A, C, var
对象 ID(object ID) EmaT_Object_Id var; attr_get
attr_set
A, C, &var
A, C, var

Array Contents 组件

array contents 组件用于读取或设置带有 array 类型修饰符的属性的内容。这类属性提出了一项特殊要求,禁止使用常规的 COMP_CONTENTS 符号常量:必须把数组元素的索引传递给运算符,以便它找到应当操作的那个唯一数组元素。数组索引要求通过一个作为 ACV 第二个参数传递的宏来实现:COMP_ARRAY_CONTENTS()。该宏接受自己的参数,即所需数组元素的索引。如果试图读取或设置索引超出当前数组大小的元素的内容,数组将被扩展到该大小(在数组内存限制的范围内)。

array contents 组件的 ACV 形式为:

	<attr_name>, COMP_ARRAY_CONTENTS(<array_index>), <value>

尽管 ACV 中间参数的形式有所变化,表 4 中列出的 COMP_CONTENTS 组件的值类型仍然适用于此组件。

Array Symbolic Contents 组件

array symbolic contents 组件用于读取或设置带有 array 类型修饰符的属性的符号内容。该组件与前面描述的 array contents 组件几乎完全相同。区别在于符号内容的值始终是字符串(要么指明不存在符号值,要么给出某个符号值的名称)。符号常量 EMAC_NO_SYMBOL 用于指定无符号值。

array symbolic contents 组件的 ACV 形式为:

	<attr_name>, COMP_ARRAY_CONTENTS_SYMBOL(<array_index>), <value>

Array Size 组件

EMA 中的数组是按数字索引的元素列表;数组中包含的元素数目称为数组的大小(size),并存储在 array size 组件中。该组件可以通过 attr_get 运算符获取,方法是将 ACV 的第二个参数设置为符号常量 COMP_ARRAY_SIZE。此组件是只读(get-only)的,因此不能用这种方式设置。使用 attr_get 和 attr_set 运算符,可以将数组扩展到超出其默认大小。但不可能把数组缩减到更小的尺寸(即数组大小是单调递增的)。

大多数数组属性的默认大小为零,但有些属性为方便起见具有预设的初始大小。array size 组件的 ACV 形式如下所示;其值必须始终是整数指针。

	<attr_name>, COMP_ARRAY_SIZE, &var

Double Vector Contents 组件

double vector contents 组件用于读取或设置核心类型为 double vector(双精度向量)的属性的内容。与数组属性一样,double vector 属性也提出了一项特殊要求,禁止使用常规的 COMP_CONTENTS 符号常量:必须把向量元素的索引传递给运算符,以便它找到应当操作的那个唯一向量元素。向量索引要求通过一个作为 ACV 第二个参数传递的宏来实现:COMP_DVEC_CONTENTS()。该宏接受单个参数,即所需向量元素的索引。如果试图读取或设置索引超出当前向量大小的元素的内容,将会产生错误(注意这与数组属性不同,数组属性会自动扩展以适应“越界”访问)。

double vector contents 组件的 ACV 形式为:

	<attr_name>, COMP_DVEC_CONTENTS(<vector_index>), <value>

尽管 ACVs 中间参数的形式有所变化,表 4 中列出的 COMP_CONTENTS 组件的值类型仍然适用于此组件。

Double Vector Size 组件

double vector 属性是按数字索引的元素列表;向量中包含的元素数目称为向量的大小,并存储在 double vector size 组件中。该组件可以通过 attr_get 运算符获取,方法是将 ACV 的第二个参数设置为符号常量 COMP_DVEC_SIZE。double vector 属性不能通过在 attr_set 或 attr_get 运算符中使用“越界”索引来自动扩展;改变 double vector 属性大小的唯一方法,是使用组件为 COMP_DVEC_SIZE 的 attr_set 运算符。因此,该组件既可读取也可设置。

大多数 double vector 属性的默认大小为零,但有些属性为方便起见具有预设的初始大小。如果某个 double vector 属性的默认大小为零,那么在对其应用任何作用于 double vector contents 组件的 attr_set 或 attr_get 运算符之前,必须先使用 double vector size 组件设置其大小。

double vector size 组件的 ACV 形式为:

attr_get: <attr_name>, COMP_DVEC_SIZE, &var

attr_set: <attr_name>, COMP_DVEC_SIZE, var

Toggle 组件

带有 toggle 类型修饰符的属性可以处于启用或禁用状态。读取或设置属性的 toggle 可以通过 toggle 组件完成。该组件通过将 ACV 的第二个参数设置为符号常量 COMP_TOGGLE 来指明。属性的状态与属性的内容相互独立,内容仍像往常一样通过 COMP_CONTENTS 组件设置。toggle 组件的两种 ACV 形式如下所示;对于 attr_get 运算符,其值必须是整数指针;对于 attr_set 运算符,其值必须是整数。

attr_get: <attr_name>, COMP_TOGGLE, &var

attr_set: <attr_name>, COMP_TOGGLE, var

Symbolic Contents 组件

symbolic contents 组件与 contents 组件类似,区别在于其值是表示属性符号值的字符串。符号常量 EMAC_NO_SYMBOL 用于指定无符号值。

symbolic contents 组件的 ACV 形式为:

	<attr_name>, COMP_CONTENTS_SYMBOL, <value>

Type 组件

如前所述,某些 EMA 对象属性并不定义为具有单一特定类型,而是可以呈现多种可能的类型(poly 类型)。属性的 type 组件指定属性的值将表示哪种受支持的类型。有效的值常量是整数常量 EMAC_INTEGER、EMAC_DOUBLE、EMAC_STRING、EMAC_TOGGLE、EMAC_TOGGLE_DOUBLE、EMAC_DATAFILE 和 EMAC_COMPOUND。

type 组件的两种 ACV 形式如下所示。对于 attr_get 运算符,其值必须是整数指针;对于 attr_set 运算符,其值必须是整数。

attr_get: <attr_name>, COMP_CONTENT_TYPE, &var

attr_set: <attr_name>, COMP_CONTENT_TYPE, var

Set 组件

常常需要判断某个特定属性是否已被设置,尤其是当属性类型是可选对象 ID 时。如果这些属性尚未被设置,它们就不会有明确定义的值(因为对象 ID 没有默认值)。因此,在它们未被设置的情况下访问和使用其内容可能导致错误。每个属性的 set 组件提供了一种判断属性是否已被设置的便捷机制。该只读(get-only)组件可以通过第二个参数设置为符号常量 COMP_SET 的 ACV 来访问。

set 组件的 ACV 形式如下所示。其值必须始终是整数指针。

	<attr_name>, COMP_SET, &var

Object Type 组件

EMA 为模型支持若干内置属性(见 EMA 内置属性)。其中一个属性 ATTR_EMA_NUM_OBJECTS 提供了一种机制,用于从 EMA 获取模型中包含的某种特定类型对象的数量。由于模型通常包含多种类型的对象,ATTR_EMA_NUM_OBJECTS 属性必须与之关联多个组件。每个组件记录某种特定类型对象的数量。所有这些组件都通过将 ACV 的第二个参数设置为宏 COMP_OBTYPE() 来指明。与 COMP_ARRAY_SIZE() 一样,该组件本身接受单个参数。但该参数不是索引,而是一个指明所查询对象类型的符号常量。例如,如果计算需要知道“A”对象的数量,那么 COMP_OBTYPE() 将接受参数 OBJ_A。

object type 组件的 ACV 形式如下所示。由于不能直接使用 ATTR_EMA_NUM_OBJECTS 设置对象数量,这些组件是只读(get-only)的。因此,其值必须始终是整数指针。

	ATTR_EMA_NUM_OBJECTS, COMP_OBTYPE(<object_type>), &var

Promote 组件

Riverbed 分析软件的环境架构支持在多个不同建模层级上的属性(例如,属性可以关联到进程模型、处理器、节点、子网以及整个仿真)。该架构的一项高级特性是支持把与较低层级实体关联的属性“提升(promotion)”到较高层级的实体。一个例子是:在进程模型层级定义的属性会被自动提升为其父处理器或队列(即正在执行该进程模型的模块)的属性。这使得属性可以按模块逐个赋值。如果属性没有在模块层级被赋值,它们将被自动提升到节点层级;再递归一次即可把属性提升到整个仿真层级。

对象的内置属性默认不会被提升;相反,当创建对象时,其内置属性具有默认的赋值。要提升内置属性,必须执行特定的工具操作。但是,对象(或进程模型情形下的模型)的用户定义属性会被自动提升。当为被提升的属性赋值后,该属性即被“取消提升(unpromoted)”,因为它不再需要在更高层级寻求赋值。

在 EMA 中,属性的提升通过 promote 组件处理,方法是将 ACV 的第二个参数设置为 COMP_PROMOTE 来访问该组件。该组件是一个具有布尔值(0 或 1)的整数,取决于属性是否被提升。EMA 内置模型属性和对象属性最初不会被提升,因此它们的 promote 组件初始值为零(表示关闭)。但通过 add attribute(添加属性)运算符创建的模型属性和对象属性是被提升的,因此它们的 promote 组件值为 1(表示开启)。

由于属性的 promote 组件与属性的 contents 组件彼此分离、相互独立,这两个组件存在若干精巧的组合。下表列出了 promote 组件与 contents 组件的各种组合:

表 5:promote 组件与 contents 组件的组合

Promote 组件 Contents 组件 说明
1 <not set> 属性被提升;属性的内容表示其默认值;内容仍设置为该属性的内置默认值
1 <set> 属性被提升;属性的内容表示其默认值;内容已被设置为用户指定的值
0 <not set> 属性未被提升;属性的内容表示其真实值;内容仍设置为该属性的内置默认值
0 <set> 属性未被提升;属性的内容表示其真实值;内容已被设置为用户指定的值

promote 组件的两种 ACV 形式如下所示。对于 attr_get 运算符,其值必须是整数指针;对于 attr_set 运算符,其值必须是整数。

attr_get: <attr_name>, COMP_PROMOTE, &var

attr_set: <attr_name>, COMP_PROMOTE, var

Properties 组件

properties 组件允许你获取与 non-built in(非内置)EMA 属性关联的 properties 对象的对象 ID。non-built in 属性包括在 Process Editor(进程编辑器)中定义的属性、扩展属性,以及通过提升出现在对象上的属性。如果对内置属性访问 properties 组件,将返回 EMAC_NULL_OBJ_ID。该只读(get-only)组件可以通过第二个参数设置为符号常量 COMP_PROPS 的 ACV 来访问。

properties 组件的 ACV 形式如下所示。其值必须始终是整数指针。

attr_get: <attr_name>, COMP_PROPS, &var

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · Documentation compiled and provided by Beijing ZNetLink Technology Co., Ltd.

交流群 · QQ Group:OPNET/智网妙算网络仿真交流群(群号 486383494)

原文档 © 2017 Riverbed Technology · 本站为公益翻译,由 AI 辅助完成,请仔细甄别

Original documentation © 2017 Riverbed Technology. Community translation, AI-assisted. Contact: jiazequn@znetlink.com