op_pk_nfd_type()

摘要

获取指定数据包中某字段的类型;目标字段通过名称指定。

语法

op_pk_nfd_type (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_TYPE_UNSPEC,表示指定字段未在数据包中定义。]

返回类型

int

指定字段的类型。

[该值是一个表示字段类型的整数代码(参见表 55“字段类型符号常量”);该代码的可能取值也列在“详情”一节中。]

示例

/* pull the next packet off the queue */
pkptr = op_subq_pk_remove (0, OPC_QPOS_HEAD);

/* determine the type of the payload field */
switch (op_pk_nfd_type (pkptr, "payload"))
	{
	case OPC_FIELD_TYPE_INTEGER:
		op_pk_nfd_get (pkptr, "payload", &val_i);
		printf ("Field (%d): Type (integer) Value (%d)\n", j, val_i); break;

	case OPC_FIELD_TYPE_DOUBLE:
		op_pk_nfd_get (pkptr, "payload", &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_type() 不同,这里必须指定字段名称,因此该内核过程最可能用于若干数据包格式相似、字段名称相同但字段类型不同的场合。

该内核过程只应应用于已格式化的数据包;否则,传递给该内核过程的任何字段名称所返回的类型代码都将是 OPC_FIELD_TYPE_UNSPEC。

错误

  • 程序中止:段违例。(由于无效的数据包指针或 fd_name 参数)
  • 程序中止:数据包指针为 NIL。
  • 程序中止:数据包指针指向已被销毁的数据包。
  • 可恢复错误:数据包 (<pk_id>) 中不存在名为 (<fd_name>) 的字段。

参考

  • 使用内核过程 op_pk_fd_type() 确定未格式化(或已格式化)数据包中字段类型,通过数字索引指定目标字段(该内核过程的这个未格式化版本往往更有用,因为它支持构造用于完全通用数据包处理的循环)
  • 使用内核过程 op_pk_nfd_size() 确定数据包字段的大小
  • 使用内核过程 op_pk_nfd_is_set() 判断数据包字段是否已设置

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