op_vvec_from_value()

摘要

将给定值转换为该值的位表示形式,然后将位表示形式放入一个新的值向量。

语法

op_vvec_from_value (target, byte_order, bit_format, target_size, value_type, value)
参数 类型 说明
target Vvec_Vector* 指向一个值向量的指针,该向量将存放 value 的位表示形式
byte_order Vvec_ByteOrder 将 value 转换为位向量时使用的字节序
[这是一个常量,表示模型所采用的相应字节序方案(参见 Table 94 “Value Vector Byte Ordering Symbolic Constants“ 第 33 页。)]
bit_format Vvec_BitFormat 将 value 转换为位向量时使用的位格式
[这是一个常量,表示模型所采用的相应位格式(参见 Table 93 “Value Vector Bit Format Symbolic Constants“ 第 33 页。)]
target_size int 新向量的大小(以位计)
[该值决定在将 value 转换为位向量时可以使用哪些位格式。]
value_type Vvec_NativeType 待转换为位向量的 value 的格式
[这是一个常量,表示 value 的相应类型(参见 Table 96 “Value Vector Native Type Symbolic Constants“ 第 34 页。)]
value Vartype 待转换为位向量的值

返回类型

int

完成代码,指示该操作是否成功完成。可能的返回值完整列表参见 Table 95 “Value Vector Completion Code Symbolic Constants“ 第 33 页。

示例

/* Convert a packet to a value vector by iterating over its fields. */
max = op_pk_fd_max_index (source);
for (i = 0; i <= max; i++)
	{
	switch (op_pk_fd_type (pkptr, i))
		{
		Vvec_Vector    temp_vec;

		case OPC_FIELD_TYPE_INTEGER:
			op_pk_fd_get (pkptr, i, &pk_int);
			if (op_pk_fd_size (pkptr , i))
				{
				op_vvec_from_value (&temp_vec, OPC_VVEC_BYTE_ORDER_LITTLE_ENDIAN,
					OPC_VVEC_BITFORMAT_BINARY, op_pk_fd_size (pkptr, i),
					OPC_VVEC_NATIVE_INT, pk_int);
				}
			break;
		case OPC_FIELD_TYPE_DOUBLE:
			op_pk_fd_get (pkptr, i, &pk_dbl);
			if (op_pk_fd_size (pkptr , i))
				{
				op_vvec_from_value (&temp_vec, OPC_VVEC_BYTE_ORDER_LITTLE_ENDIAN,
					OPC_VVEC_BITFORMAT_FP, op_pk_fd_size (pkptr, i),
					OPC_VVEC_NATIVE_DOUBLE, pk_dbl);
				}
			break;
		}
	}

详情

该内核过程将单个值转换为该值的位表示形式,然后将其放入一个新的目标值向量。

对于类型为 boolean 或 bit 的 value 参数,不要赋值字面值 0 和 1。而应使用相应的常量:

  • boolean 类型使用 OpC_BoolL_F 和 OpC_Bool_T
  • bit 类型使用 OpC_Bit_0 和 OpC_Bit_1

通常,op_vvec_from_value() 用于为放置在外部系统的 esys 接口上的数据做准备。

target size 的值必须与字节序和位格式规格保持一致。如果仿真内核由于内存限制或其他原因无法满足该请求,则会产生目标大小错误。

用途

提供一种创建包含给定值的位表示形式的值向量的机制。该过程足够灵活,能够处理所有标准数据类型,同时也支持标准位格式和字节序约定。

错误

  • 可恢复错误:所请求转换中的源类型与目标类型不兼容。
  • 可恢复错误:转换目标大小(<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