op_pk_nfd_size()
摘要
获取指定数据包中某字段的建模大小(以比特计);目标字段通过名称指定。
语法
op_pk_nfd_size (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* |
目标字段名称 [该名称应当是数据包格式中已定义的字段;但即使未定义也不会发生错误,而是返回 OPC_FIELD_SIZE_INVALID,表示指定字段未在数据包中定义。] |
返回类型
OpT_Packet_Size
指定字段的建模大小(以比特计)。
若发生可恢复错误,将返回常量值 OPC_FIELD_SIZE_INVALID。
示例
/* obtain an arriving packet */
pkptr = op_pk_get (0);
/* determine the size of the information field */
data_size = op_pk_nfd_size (pkptr, "info_fd");
/* write the data size out as a statistic */
op_stat_write (0, (double) data_size);
/* deallocate the packet */
op_pk_destroy (pkptr);
详情
返回指定字段的大小:该大小可能是字段在数据包格式中最初定义的值,可能是最近一次通过内核过程 op_pk_fd_set() 设置的值;对于数据包类型的字段,则取自通过 op_pk_nfd_set() 或 op_pk_fd_set() 赋值的被封装数据包。
用途
提供了一种确定数据包字段建模大小的机制。当信息字段大小可变、且其大小对计算流量统计量有意义时,这通常很有用(如上一页的示例)。该内核过程只应应用于已格式化的数据包;否则,传递给该内核过程的任何字段名称所返回的大小都将为零。
错误
- 程序中止:段违例。(由于无效的数据包指针或
fd_name参数) - 程序中止:数据包指针为 NIL。
- 程序中止:数据包指针指向已被销毁的数据包。
- 可恢复错误:数据包 (<pk_id>) 中不存在名为 (<fd_name>) 的字段。
参考
- 使用内核过程
op_pk_fd_size()确定未格式化(或已格式化)数据包中字段的大小,通过数字索引指定字段 - 使用内核过程
op_pk_nfd_type()确定数据包字段的类型 - 使用内核过程
op_pk_nfd_is_set()判断数据包字段是否已设置 - 使用内核过程
op_pk_total_size_get()确定数据包的总大小 - 使用内核过程
op_pk_bulk_size_get()确定数据包的批量数据大小