prg_vector_create()
摘要
创建一个具有指定初始维度的新 vector。
语法
prg_vector_create (initial_size, destroy_proc, copy_proc)
| 参数 | 类型 | 说明 |
|---|---|---|
initial_size |
unsigned long |
vector 初始提供的条目数 |
destroy_proc |
PrgT_Vector_Destroy_Proc |
释放 vector 中元素的过程 |
copy_proc |
PrgT_Vector_Copy_Proc |
复制 vector 中元素的过程 |
返回类型
PrgT_Vector *
指向一个 vector 的指针,可传递给 Prg_Vector 中的大多数其他函数
头文件
prg_vector.h
详情
vector 初始为空。指定的初始大小并不是 vector 中的元素个数,而是对 vector 需要多大才能容纳将要添加的元素的初步估计。如果添加的元素超出这个初始大小,vector 会自动调整大小,因此初始大小是否精确并不关键。但尽可能避免调整大小是最好的,因为调整大小的计算效率较低。当最终元素数目未知时的权衡是:选择比实际需要更大的值会浪费一些内存。初始大小也可以设为零,这种情况下 vector 会在添加第一个元素时立即扩展。
销毁过程和复制过程是系统分别在 vector 被销毁或被复制时调用的处理器。这些处理器对存储在 vector 中的元素提供恰当的处理(复制或释放)。这两个过程的函数原型见 PrgT_Vector_Copy_Proc 和 PrgT_Vector_Destroy_Proc。