op_vvec_to_value()

摘要

将值的位表示形式转换为 C 数据类型的值。

语法

op_vvec_to_value (source, byte_order, bit_format, value_type, value_ptr)
参数 类型 说明
source Vvec_Vector 包含某个值的位表示形式的值向量
byte_order Vvec_ByteOrder 源向量的字节序
[这是一个常量,表示模型所采用的相应字节序方案(参见 Table 94 “Value Vector Byte Ordering Symbolic Constants“ 第 33 页。)]
bit_format Vvec_BitFormat 源向量的位格式
[这是一个常量,表示模型所采用的相应位格式(参见 Table 93 “Value Vector Bit Format Symbolic Constants“ 第 33 页。)]
value_type Vvec_NativeType 被解码值的数据类型。可以是任何标准 C 数据类型。
[这是一个常量,表示 value 的相应类型(参见 Table 96 “Value Vector Native Type Symbolic Constants“ 第 34 页。)]
value_ptr void* 指向用于存放解码后值的变量的指针
[该变量存放 source 所表示的值。]

返回类型

int

完成代码,指示该操作是否成功完成。

可能的返回值列表参见 Table 95 “Value Vector Completion Code Symbolic Constants“ 第 33 页。

示例

/* Generate an ATM cell header from a vector. */
atm_cell_pkptr = op_pk_create_fmt ("ams_atm_cell");

/* first four bits are the GFC. */
temp_vec = op_vvec_remove (output_vector, 0, 4);
op_vvec_to_value (temp_vec, OPC_VVEC_BYTE_ORDER_LITTLE_ENDIAN,
	OPC_VVEC_BITFORMAT_BINARY, OPC_VVEC_NATIVE_INT, &i);
op_vvec_destroy (temp_vec);
op_pk_nfd_set (atm_cell_pkptr, "GFC", i);

/* Next 8 bits contain the VPI. */
temp_vec = op_vvec_remove (output_vector, 0, 8);
op_vvec_to_value (temp_vec, OPC_VVEC_BYTE_ORDER_LITTLE_ENDIAN,
	OPC_VVEC_BITFORMAT_BINARY, OPC_VVEC_NATIVE_INT, &i);
op_vvec_destroy (temp_vec);
op_pk_nfd_set (atm_cell_pkptr, "VPI", i);

/* Next 16 bits contain the VCI. */
temp_vec = op_vvec_remove (output_vector, 0, 16);
op_vvec_to_value (temp_vec, OPC_VVEC_BYTE_ORDER_LITTLE_ENDIAN,
	OPC_VVEC_BITFORMAT_BINARY, OPC_VVEC_NATIVE_INT, &i);
op_vvec_destroy (temp_vec);

详情

该内核过程将值的位表示形式转换为该值本身,然后将该值放入类型正确的变量中。

对于类型为 boolean 或 bit 的值,该函数返回以下常量之一:

  • boolean 类型返回 OpC_Bool_F 和 OpC_Bool_T
  • bit 类型返回 OpC_Bit_0 和 OpC_Bit_1

用途

提供一种根据值的位表示形式以及将该值转换为位表示形式所使用方法的有关信息来解码值的机制。该过程足够灵活,能够处理所有标准数据类型,同时也支持标准位格式和字节序约定。

错误

  • 可恢复错误:值向量无效。
  • 可恢复错误:所请求转换中的源类型与目标类型不兼容。
  • 可恢复错误:源向量大小(<size>)对于该转换无效。
  • 可恢复错误:值向量转换发生一般性失败。
  • 可恢复错误:内存不足,无法执行转换。

参考

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