op_vvec_insert()
摘要
将一个向量的内容插入到另一个已存在的向量中。
语法
op_vvec_insert (target, position, source)
| 参数 | 类型 | 说明 |
|---|---|---|
target |
Vvec_Vector |
将源向量元素插入其中的目标值向量 |
position |
unsigned int |
插入开始的索引号 [向量第一个元素的索引号为 0。] |
source |
Vvec_Vector |
其元素将被插入目标值向量的值向量 |
返回类型
int
完成代码,指示该操作是否成功完成。
可能的返回值列表参见 Table 95 “Value Vector Completion Code Symbolic Constants“ 第 33 页。
示例
/* Create destination vector. */
dest = op_vvec_create (OpC_Type_Bit);
for (i = 0; i < strlen (source_string); i++)
{
/* Convert a string of characters to a string of bits in a value vector. */
op_vvec_from_value (&temp_vec, OPC_VVEC_BYTE_ORDER_LITTLE_ENDIAN,
OPC_VVEC_BITFORMAT_ASCII_8, 8, OPC_VVEC_NATIVE_STRING, source_string);
/* insert this temporary vector into the destination vector. */
/* use OPC_VVEC_VECTOR_END to specify that the values are */
/* appended to the destination vector. */
op_vvec_insert (dest, OPC_VVEC_VECTOR_END, temp_vec);
}
详情
该过程从指定索引号开始,将一个向量(源向量)的内容复制到目标向量中。如果目标向量中已存在的值的索引号低于 position 参数指定的索引号,则不受影响。索引号等于或大于 position 指定数值的值会被移动到值向量的末尾,但不会被销毁。因此,可以将一个向量插入到另一个向量的中间。两个向量的数据类型必须相同。
例如,如果目标向量为 {1, 2, 3},源向量为 {8,9},那么在位置 1 处将源向量插入目标向量,结果为:{1, 8, 9, 2, 3}。(注意第一个值的索引是 0。)
可以使用符号位置常量来指定将源向量插入目标向量的开头(OPC_VVEC_VECTOR_START)或目标向量的末尾(OPC_VVEC_VECTOR_END)。
源向量不受该过程的影响。
用途
提供一种将一个向量的内容复制到另一个向量而不覆盖目标向量内容的方法。目标向量的原有内容会被移动,为新值腾出空间。
错误
- 可恢复错误:值向量无效。
- 可恢复错误:参数值向量中存放的值类型不匹配。
- 可恢复错误:内存不足,无法执行插入。
参考
- 使用内核过程 op_vvec_remove() 创建一个由从另一个向量中移除的元素构成的新向量
- 使用内核过程 op_vvec_size_get() 确定向量中的元素数量
- 使用内核过程 op_vvec_type_get() 确定向量的数据类型