prg_vector_find()
摘要
根据元素的地址在 vector 中定位该元素,并返回其位置。
语法
prg_vector_find (vector_ptr, element_ptr, found_ptr)
| 参数 | 类型 | 说明 |
|---|---|---|
vector_ptr |
PrgT_Vector * |
目标 vector |
element_ptr |
void * |
要定位的元素的地址 |
found_ptr |
int * |
查找操作的结果:查找成功为 PRGC_TRUE,否则为 PRGC_FALSE。 |
返回类型
unsigned long
元素在 vector 中的零基位置索引。仅当 &found_ptr 的值为 TRUE 时,此返回值才有意义。
头文件
prg_vector.h
详情
遍历 vector 中的元素进行搜索(注意调用此函数对性能的影响)。如果找到具有指定地址的元素,则返回其在 vector 中的位置索引。此函数使 vector 成为“按内容可寻址的”。
返回值从零开始编号。如果此过程未找到该元素,它返回的是一个无意义的值;因此,在使用返回值之前,应始终先检查 &found_ptr 的值。