prg_vector_append_unique()
Abstract
Adds an element to the end of a vector, but only if that element does not already exist.
Syntax
prg_vector_append_unique (vector_ptr, element_ptr)
| Argument | Type | Description |
|---|---|---|
vector_ptr |
PrgT_Vector * |
vector of interest |
element_ptr |
void * |
element to be added to the end of the vector |
Return Type
PrgT_Compcode
Indicates successful insertion or failure due to pre-existence (also could be due to insufficient memory resources for the new element)
Header
prg_vector.h
Details
Provides the same behavior as prg_vector_append(), but first verifies that the element is not already present. Existence of an identical element is determined simply by comparing element memory addresses, not through any kind of sophisticated determination of equivalence. If the element does already exist in the vector, then the call has no effect and a failure code is returned.