快速枚举和比较指定 Vector 对象实例中从指定起始至最后一个元素
bool vector_helper_enum_element(VectorContext* vector_object_context,size_t* element_start_index,const void* element_value,size_t element_value_size);
参数名 | 类型 | 必选 | 描述 |
vector_object_context | Vector | True | 指定 Vector 对象实例描述符 |
element_start_index | size_t* | True | 指定保存枚举起始元素索引号的变量 |
element_value | const void* | True | 指向需要与枚举元素比较的值缓冲区 |
element_value_size | size_t | True | 需要与枚举元素比较的值缓冲区大小(byte) |
类型:bool
描述:在快速枚举过程中,若被枚举元素比较成功则返回 True
,反之返回 False
。
参数 element_start_index
指向变量的值会跟随此函数的元素枚举过程而变化。
参数 element_value_size
的值(byte)应小于等于指定 Vector 对象实例单个元素大小(byte),否则此函数将失败。
一个设计良好的应用程序应确保参数 element_value_size
的值(byte)等于指定 Vector 对象实例单个元素的大小(byte),同时应遵循类似如下的代码逻辑:
Cint element_value = 10;for(size_t element_index; vector_helper_enum_element(..., &element_index,&element_value, sizeof(element_value)); element_index++){printf("enum element index = %zd\n", element_index);}