op_pk_nfd_name_to_index()
摘要
将字段名称转换为对应的数字字段索引,转换依据是指定数据包的格式。
语法
op_pk_nfd_name_to_index (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* |
目标字段的名称 [该名称应当是数据包格式中已定义的字段;若不是,该内核过程将返回一个很大的负数,表示指定字段未在数据包中定义] |
返回类型
int
指定字段的数字索引。
如果发生错误,将返回常量 OPC_FIELD_INDEX_INVALID。
示例
/* pull the next packet off the queue */
pkptr = op_subq_pk_remote (0, OPC_QPOS_HEAD);
/* determine the size of the information field */
info_size = op_pk_nfd_size (pkptr, "fd_info");
/* if the size of this field is too large, clamp it */
if (info_size > 1300)
{
/* convert the field name into a field index */
fd_index = op_pk_nfd_name_to_index (pkptr, "fd_info");
/* set the field size to the maximum */
op_pk_fd_set (pkptr, fd_index, OPC_FIELD_TYPE_INTEGER, 1300, 16);
}
详情
数据包字段以列表形式存储在数据包内部。它们始终以数字索引标识,而在格式化数据包中它们还带有相应的字段名称。字段名称与数字索引之间的转换可以由该内核过程及其反向内核过程 op_pk_fd_index_to_name() 完成。
目的
提供一种确定格式化数据包中字段数字索引的机制。该内核过程的典型用途是修改格式化数据包字段的预定义大小(即数据包格式中指定的大小);实现这一点的唯一方式是使用 op_pk_fd_set(),而它依赖于该内核过程(如上一页示例所示)。
错误
- 程序中止:段违例。(由无效的数据包指针或格式错误的数据包引起)
- 程序中止:数据包指针为 NIL。
- 程序中止:数据包指针指向已被销毁的数据包。
- 可恢复错误:数据包 (
<pk_id>) 中没有名为 (<fd_name>) 的字段。
参考
- 使用内核过程 op_pk_name_to_index() 对指定的数据包格式(而非数据包)执行相同操作
- 使用内核过程 op_pk_fd_index_to_name() 执行反向操作,将数字字段索引转换为字段名称
- 使用内核过程 op_pk_fd_set() 通过数字索引设置数据包中字段的值