prg_vector_find_and_remove_unordered()
Abstract
Removes an element, specified by its address, from a vector without preserving the order of the remaining elements.
Syntax
prg_vector_find_and_remove_unordered (vector_ptr, element_ptr)
| Argument | Type | Description |
|---|---|---|
vector_ptr |
PrgT_Vector * |
vector of interest |
element_ptr |
void * |
address of element to be removed |
Return Type
PrgT_Compcode
PrgC_Compcode_Failure if the element address was not in the vector; PrgC_Compcode_Success otherwise.
Header
prg_vector.h
Details
Provides the same behavior as prg_vector_remove_unordered(), but instead of identifying the element to be removed by its position index, the caller identifies the element by its address. This function searches the vector to find the element of interest (note the performance implications of this function call). If the element is not found, the call has no effect and a failure status is returned.