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>)无效。 - 可恢复错误:值向量转换发生一般性失败。
- 可恢复错误:内存不足,无法执行转换。
参考
- 使用内核过程 op_vvec_to_value() 将位表示形式转换为值
- 使用内核过程 op_vvec_type_get() 查询给定值向量的类型
- 使用内核过程 op_vvec_value_get() 从值向量中获取特定值