op_vvec_copy()
摘要
返回一个新的值向量,其中包含与原始值向量相同的元素;从原始向量中指定的位置开始,包含 count 个元素。
语法
op_vvec_copy (original, position, count)
| 参数 | 类型 | 说明 |
|---|---|---|
original |
Vvec_Vector |
要被复制的值向量 |
position |
unsigned int |
要复制的第一个值的起始位置 [值向量的第一个位置的索引为 0。也可以使用任意值向量位置常量来指示该过程的起始位置(参见 Table 99 “Value Vector Position Symbolic Constants“ 第 35 页)。] |
count |
unsigned int |
要复制的值的个数 [将 position 设为 0 并将 count 设为 OPC_VVEC_COUNT_ALL,即可复制整个向量。] |
返回类型
Vvec_vector
新的值向量
[该过程创建一个新向量,其中包含从 position 开始的原始向量中的元素。共有 count 个元素被复制到新向量。]
示例
/* Retain a copy of a vector being manipulated. */
Vvec_Vector copy_vector = op_vvec_copy (target_vector, OPC_VVEC_VECTOR_START,
OPC_VVEC_COUNT_ALL);
/* now change all characters in the target vector to upper case. */
for (i = 0; i < op_vvec_size_get (target_vector); i++)
{
/* Get current vector value */
op_vvec_value_get (target_vector, i, &c);
/* Modify if lower-case. */
if (islower (c))
c = toupper (c);
/* Modify target vector. */
op_vvec_value_set (target_vector, i, c);
}
/* copy_vector still contains original values in target_vector. */
详情
由 op_vvec_copy() 得到的向量可以赋值给一个先前已声明但尚未定义的向量。或者,也可以使用这个过程对值向量的副本执行操作,同时保持原始向量不变。
例如,如果原始向量包含元素 {1, 2, 3, 4, 5},position 为 1,count 为 3,则 op_vvec_copy() 返回以下值向量:
- {2, 3, 4}
然而,如果使用同一个原始向量,并将 position 设为 0、count 设为 OPC_VVEC_COUNT_ALL,则得到以下向量:
- {1, 2, 3, 4, 5}
用途
提供一种复制值向量的方法。
错误
- 可恢复错误:值向量无效。
- 可恢复错误:内存不足,无法复制(
<count>)个值。 - 可恢复错误:位置(
<pos>)至(<pos>)处的值无法被复制。
参考
- 使用内核过程 op_vvec_create() 创建一个新向量
- 使用内核过程 op_vvec_insert() 将一个向量中的元素放入另一个向量
- 使用内核过程 op_vvec_remove() 创建一个由从另一个向量中移除的元素构成的新向量