op_pk_nfd_exists()
摘要
判断数据包是否包含指定字段。
语法
op_pk_nfd_exists (pkptr, fd_name)
| 参数 | 类型 | 说明 |
|---|---|---|
pkptr |
Packet* |
指向目标数据包的指针 [数据包的指针可以从许多内核过程获得,包括 op_pk_create_fmt()、op_pk_copy()、op_pk_get()、op_subq_pk_access() 和 op_subq_pk_remove()。] |
fd_name |
const char* |
目标字段的名称 |
返回类型
OpT_Boolean
如果字段存在于数据包中则返回 OPC_TRUE;否则返回 OPC_FALSE。
示例
/* variable declarations */
Packet *pkptr;
/* obtain an arriving packet */
pkptr = op_pk_get (0);
/* process the payload, if any */
if (op_pk_nfd_exists (pkptr, "payload"))
{
/* do something */
}
详情
如果指定的数据包未格式化(此时不存在命名字段),将产生可恢复错误,且该函数返回 OPC_DBL_UNDEF。
目的
提供一种机制,用于判断特定字段是否存在于数据包中。
错误
- 程序中止:段违例。(由无效的数据包指针或格式错误的数据包引起)
- 程序中止:数据包指针指向无主数据包 (<pk_id>)。
- 可恢复错误:数据包 (<pk_id>) 的类型不包含格式化字段。
参考
- 无。