op_esys_interface_vector_get()
摘要
从向量接口读取连续的值并将其插入值向量。
语法
op_esys_interface_vector_get (interface, target, start_offset)
| 参数 | 类型 | 说明 |
|---|---|---|
interface |
Esys_Interface |
待读取的向量接口的接口 ID [该 esys 接口必须是向量接口。可以通过 Topo 包和 Id 包中的若干内核过程(包括 op_topo_child() 和 op_id_from_name())以及 op_intrpt_esys_interface() 获取 esys 接口 ID。] |
target |
Vvec_Vector |
将接收向量接口内容的值向量 [向量接口与目标值向量的数据类型必须一致,且必须具有相同的维数。目标值向量必须已经存在。] |
start_offset |
int |
在目标向量中开始插入值的位置 [可以使用常量 OPC_VVEC_VECTOR_END 指定将值追加到向量末尾。向量接口的每个元素被依次读取到值向量的后续位置。这些位置上已存在的值不会被覆盖;而是将其位置编号增大,为新值腾出空间。] |
返回类型
int
指示操作是否成功完成的完成码。
OPC_ESYS_SUCCESS 表示操作成功。关于其余的完成码,参见表 53 “External System Completion Code Symbolic Constants“ 第 13 页。
示例
/* Obtain value of an esys vector interface, and convert to an integer. */
vector = op_vvec_create (OPC_TYPE_BIT);
op_esys_interface_vector_get (interface_id, vector, 0);
/* Convert this vector into an integer. */
op_vvec_to_value (vector, OPC_VVEC_BYTE_ORDER_LITTLE_ENDIAN,
OPC_VVEC_BITFORMAT_BINARY, OPC_VVEC_NATIVE_INT, &i);
详情
可以使用表 99 “Value Vector Position Symbolic Constants“ 第 35 页中描述的常量,指定在值向量中从哪个位置开始插入来自向量接口的值。
用途
提供一种读取向量接口上的值并将其放入值向量的机制。因此,可以将向量接口视为持有值向量的内容。该函数调用允许将向量接口中的值插入值向量。
错误
- 程序中止:段违例。(由于向量参数无效)
- 可恢复错误:接口句柄无效。
- 可恢复错误:输入向量无效。
- 可恢复错误:试图从非向量接口(
<name>)获取向量或数组值。 - 可恢复错误:试图从 esys 输入接口(
<name>)获取值。
参考
- 使用内核过程 op_intrpt_esys_interface() 获取某个 esys 接口的接口 ID
- 使用内核过程 op_esys_interface_vector_set() 将值向量的内容放置到向量接口上
- 使用内核过程 op_esys_interface_array_get() 将向量接口中的元素放入已有数组
- 使用内核过程 op_esys_interface_value_get() 将 esys 接口的值放入变量
- 使用内核过程 op_vvec_create() 创建值向量
- 使用内核过程 op_vvec_type_get() 确定向量的数据类型