op_vvec_remove()
摘要
从已存在的向量中移除数据元素,并返回一个包含这些元素的新向量。
语法
op_vvec_remove (source, position, count)
| 参数 | 类型 | 说明 |
|---|---|---|
source |
Vvec_Vector |
将从中移除元素的值向量 [该向量必须是已存在的向量。该向量中的值将被移除并放入一个新的值向量,该新向量即为本过程的返回值。] |
position |
unsigned int |
要从源向量中移除的第一个元素的索引号 |
count |
unsigned int |
要移除的元素数量 |
返回类型
Vvec_Vector
由从源向量中移除的元素组成的值向量。
示例
/* apply 16-bit chunks of a bit value vector on an esys interface. */
for (i = 0; i < (op_vvec_size_get (src_vector) / 16); i++)
{
head = op_vvec_remove (vvec, OPC_VVEC_VECTOR_START, 16);
/* Schedule values on the esys vector interface at 100 ns intervals. */
op_esys_interface_vector_set (intf_id, op_sim_time() + (i * 1e-7), head, 0);
/* done with this value vector. */
op_vvec_destroy (head);
}
/* source vector's data has been send to the esys interface. */
op_vvec_destroy (src_vector);
详情
该过程允许你从一个向量中移除特定元素,并创建一个仅包含这些元素的新向量。源向量会同时失去被移除的值及其索引位置。因此,源向量的大小加上新向量的大小等于原始源向量的大小。
例如,若对向量 {1, 2, 3, 4, 5} 应用 op_vvec_remove(),position 参数为 1,count 为 2,则得到以下向量:
Original vector: {1, 4, 5}
New vector: {2, 3}
(注意向量中第一个位置的索引为 0。)
新的值向量是 op_vvec_remove() 的返回值。可以移除源向量的所有值,从而留下一个大小为零的向量。如果 position 参数大于向量中的最后一个索引号,则返回一个空向量。如果 count 参数使该过程达到或超过向量的末尾,则向量中从 position 到末尾的所有值都会出现在新向量中。
源向量和新向量最终都必须被销毁。即使源向量被留为空向量(大小为零),该过程也绝不会销毁源向量。
用途
提供一种将一个向量的特定元素移动到另一个向量中的机制。
错误
- 可恢复错误:值向量无效。
- 可恢复错误:内存不足,无法执行移除。
参考
- 使用内核过程 op_vvec_create() 创建一个新向量
- 使用内核过程 op_vvec_destroy() 释放分配给向量的内存
- 使用内核过程 op_vvec_insert() 将一个向量中的元素放入另一个向量