op_pk_fd_type()

摘要

获取指定数据包中某个字段的类型;目标字段由数字索引指定。

语法

op_pk_fd_type (pkptr, fd_index)
参数 类型 说明
pkptr Packet* 目标数据包的指针
[数据包的指针可以从许多内核过程中获得,包括 op_pk_create()、op_pk_create_fmt()、op_pk_copy()、op_pk_get()、op_subq_pk_access() 和 op_subq_pk_remove()。]
fd_index int 目标字段的数字索引
[该值应为非负数;但即使为负数也不会发生错误,而是返回 OPC_FIELD_TYPE_UNSPEC,表示指定字段未在数据包中定义。]

返回类型

int

指定字段的类型。

[该值是表示字段类型的整数代码(见表 55“Field Type Symbolic Constants“,第 14 页);该代码的可能取值也列于下一页的详情小节中。]

示例

pkptr = op_subq_pk_remove (0, OPC_QPOS_HEAD);

/* determine the number of fields the packet has */
num_fds = op_pk_fd_max_index (pkptr);

/* loop through each field, printing out its contents */
for (j = 0; j < num_fds; j++)
	{
	if (op_pk_fd_is_set (pkptr, j) == OPC_FALSE)
		continue;
	switch (op_pk_fd_type (pkptr, j))
		{
		case OPC_FIELD_TYPE_INTEGER:
			op_pk_fd_get (pkptr, j, &val_i);
			printf ("Field (%d): Type (integer) Value (%d)\n", j, val_i);
			break;

		case OPC_FIELD_TYPE_DOUBLE:
			op_pk_fd_get (pkptr, j, &val_d);
			printf ("Field (%d): Type (double) Value (%g)\n", j, val_d);
			break;
		}
	}

详情

该内核过程返回表示指定字段类型的整数代码;该整数代码的值可与下列符号常量进行比较:

  • OPC_FIELD_TYPE_INTEGER
  • OPC_FIELD_TYPE_DOUBLE
  • OPC_FIELD_TYPE_STRUCT
  • OPC_FIELD_TYPE_INFO
  • OPC_FIELD_TYPE_PACKET
  • OPC_FIELD_TYPE_UNSPEC

若发生可恢复错误,则返回常量 OPC_FIELD_TYPE_UNSPEC。

用途

提供了一种确定数据包字段类型的机制。通常用于以通用方式编写的进程接收数据包的场合,使其能够处理各种各样的传入数据包格式。进程可以用 op_pk_fd_max_index() 确定数据包中的最大字段索引,然后遍历各个字段,判断其是否已置位,用该内核过程查询其类型,并确定其值或大小。这种数据包处理技术既可用于未格式化数据包,也可用于格式化数据包。

错误

  • 程序中止:段错误。(由无效的数据包指针或畸形数据包引起)
  • 程序中止:数据包指针为 NIL。
  • 程序中止:数据包指针指向已被销毁的数据包。
  • 可恢复错误:数据包 (<pk_id>) 中不存在索引为 (<fd_index>) 的字段。

参考

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · 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