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