prg_vector_reserve()
Abstract
Sets the allocated elements of a vector to a reserved count.
Syntax
prg_vector_reserve (vector_ptr, reserved_count)
| Argument | Type | Description |
|---|---|---|
vector_ptr |
PrgT_Vector * |
vector of interest |
reserved_count |
unsigned long |
reserved element count |
Return Type
PrgT_Compcode
PrgT_Compcode_Success if the operation is successful; PrgT_Compcode_Failure otherwise.
Header
prg_vector.h
Details
This function sets the allocated elements to a “reserved count” so that the vector can reduce the number of reallocations, dependent on knowledge that the client has gained after initially creating the vector.