op_pk_vvec_is_set()
摘要
判断值向量数据包当前是否包含值向量。
语法
op_pk_vvec_is_set (pk_ptr)
| 参数 | 类型 | 说明 |
|---|---|---|
pk_ptr |
Packet* |
指向目标数据包的指针 [该数据包必须是值向量数据包。] |
返回类型
Boolean
若数据包包含值向量则返回 OPC_TRUE,若数据包不包含值向量则返回 OPC_FALSE。
示例
/* Append a "partition" value vector onto the contents of a */
/* value vector packet. */
/* Determine if there is already a value vector in this packet */
if (op_pk_vvec_is_set (pkptr))
{
/* There is an existing value vector already in this packet. */
/* Append the "partition" to the existing value vector. */
op_pk_vvec_get (pkptr, ¤t_vvec);
end_pos = op_vvec_size_get (current_vvec);
op_vvec_insert (current_vvec, end_pos, partition_vvec);
}
else
{
/* When op_pk_vvec_set () is called, the Kernel */
/* takes ownership of the value vector. */
/* Therefore, create a duplicate of "partition" */
/* to install into the value vector packet. */
current_vvec = op_vvec_copy (partition_vvec, 0,
op_vvec_size_get (partition_vvec));
}
op_pk_vvec_set (pkptr, current_vvec);
详情
值向量数据包并非任何时刻都包含值向量。该函数使你能够判断给定的值向量数据包是否包含值向量。
用途
提供一种判断值向量数据包是否包含值向量的机制。
错误
- 程序中止:数据包指针指向已销毁的数据包。
- 可恢复错误:数据包
<pk_id>) 属于不包含值向量的类型。
参考
- 使用内核过程 op_pk_vvec_set() 将值向量插入值向量数据包
- 使用内核过程 op_pk_vvec_get() 从值向量数据包中获取值向量
- 使用内核过程 op_vvec_create() 创建新的值向量
- 使用内核过程 op_pk_destroy() 销毁数据包并释放其内存
- 使用内核过程 op_pk_type() 查看数据包是已格式化、未格式化还是值向量类型