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>)获取值。

参考

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