包概述
Vvec(Value Vector)包是一组内核过程的集合,用于在协同仿真期间操作值向量,并准备值向量中的数据以供外部系统使用。值向量是由单一名称引用的一组值的集合。它与数组类似,可以看作一系列值的序列,序列中的每个位置都由一个索引编号引用。它与数组的不同之处在于,值向量的元素不一定对应内存中的某个特定位置。该包中的内核过程使得操作值向量比操作数组更容易、更方便。值向量所存储的值可以是任何标准 C 数据类型。
警告: 对于 boolean 和 bit 数据类型,不要使用字面值 0 和 1。而应使用相应的符号常量:
– OpC_Bool_F 和 OpC_Bool_T 用于 boolean
– OpC_Bit_0 和 OpC_Bit_1 用于 bit
使用值向量的原因之一,是便于将值从其 C 数据类型转换为位表示,从而可以在协同仿真期间方便地传递给外部系统。有两个过程负责这些转换。第一个是 op_vvec_from_value(),它接收一个值,生成该值的位表示,并将该表示放入一个值向量。另一个过程 op_vvec_to_value() 则从值的位表示生成一个标准 C 数据类型值。
与数据包一样,值向量必须创建和销毁。创建值向量时,仿真内核为该向量分配内存。销毁值向量时会释放该内存。如果仿真不断创建值向量,却不在不再需要时销毁它们,内存可能被占满,从而导致系统崩溃。用于创建值向量的过程是 op_vvec_create(),用于销毁值向量的过程是 op_vvec_destroy()。通常,在创建值向量时,会将它们赋给一个变量名以便后续访问。
另外两个过程也会创建值向量。op_vvec_copy() 返回一个新的值向量,由已存在值向量的全部或部分构成。op_vvec_remove() 生成一个新的值向量,由从已存在值向量中移除的值构成。使用这两个过程创建的值向量同样必须销毁,正如使用 op_vvec_create() 创建的值向量一样。
使用 op_vvec_create() 创建的值向量不包含任何值。与数组不同,值向量的大小(元素个数)无需在创建时指定。在值向量的整个生命周期内,其大小可以按需增长和缩小。值向量中各个元素通过过程 op_vvec_value_set() 赋值。值向量中的元素无需按顺序赋值。如果为新向量的第五个元素赋值,则前面的四个值会自动设置为 0。要获取值向量中某个特定元素的值,请使用过程 op_vvec_value_get()。
Vvec 包中其余的过程允许以各种方式处理值向量。例如,op_vvec_insert() 允许将一个值向量插入另一个值向量的开头、中间或末尾。op_vvec_valid() 判断一个值向量是否有效。op_vvec_type_get() 给出值向量在创建时所指定的类型,op_vvec_print() 将值向量的内容发送到标准输出设备。最后,op_vvec_size_get() 返回该值向量中的元素个数。