op_td_is_set()
摘要
判断指定的传输数据属性是否已有赋值。
语法
op_td_is_set (pkptr, tda_index)
| 参数 | 类型 | 说明 |
|---|---|---|
pkptr |
Packet* |
指向所关注数据包的指针 |
tda_index |
int |
所关注的传输数据属性的数字索引。 [该值是一个整数代码,指定要访问的传输数据属性。该参数的预定义值列于“Transmission Data Attribute“ 第 28 页。] |
返回类型
Boolean
指示指定传输数据属性是否已获得赋值的 Boolean 值。如果该 TDA 已设置,返回常量 OPC_TRUE;否则返回 OPC_FALSE。
示例
摘自:示例模型(models/std/base);管道模型(dra_power)。
/* If the incoming packet is ’valid’, it may cause the receiver to */
/* lock onto it. However, if the receiving node is disabled, then */
/* the channel match should be set to noise. */
if (op_td_get_int (pkptr, OPC_TDA_RA_MATCH_STATUS) == OPC_TDA_RA_MATCH_VALID)
{
if (op_td_is_set (pkptr, OPC_TDA_RA_ND_FAIL))
{
/* The receiving node is disabled. Change the channel */
/* match status to noise. */
op_td_set_int (pkptr, OPC_TDA_RA_MATCH_STATUS, OPC_TDA_RA_MATCH_NOISE);
}
else
{
. . .
}
}
详情
传输数据属性用于在仿真内核与各级收发器管道阶段之间传递链路建模数据。Td 包的内核过程提供了用于操作传输数据属性的基本操作(设置和获取)。如果该值已设置(即它曾经获得过赋值),该内核过程将返回 OPC_TRUE;否则返回 OPC_FALSE。
用途
提供了一种判断传输数据属性值当前是否已设置的机制。当管道阶段未必能依赖数据包中存在特定属性时,这一点十分有用——原因可能是这些阶段以通用方式编写,以便与多种其他阶段协同工作,也可能是已知管道中的另一个(前序)阶段可能使所关注的属性保持未赋值状态。试图访问未赋值的属性会导致仿真错误。因此,如果可以预见到这种情形,应在尝试提取 TDA 值之前先用 op_td_is_set() 进行检测。
错误
- 程序中止:段违例。(由于无效的数据包指针或格式错误的数据包)
- 程序中止:数据包指针为 NIL。
- 程序中止:数据包指针指向已销毁的数据包(
<pk_id>)。 - 程序中止:Tda 索引(
<tda_index>)超出数据包(<pk_id>)的范围。
参考
- 使用内核过程 op_td_get_int() 或 op_td_get_int64() 获取整型传输数据属性的值
- 使用内核过程 op_td_get_dbl() 获取 double 传输数据属性的值
- 使用内核过程 op_td_get_ptr() 获取指针传输数据属性的值
- 使用内核过程 op_td_set_int() 或 op_td_set_int64() 为整型传输数据属性赋值
- 使用内核过程 op_td_set_dbl() 为 double 传输数据属性赋值
- 使用内核过程 op_td_set_ptr() 为指针传输数据属性赋值