---
name: "vf_find_prop_qual_index"
section: "3"
platform: "linux"
package: "libvformat-dev"
version: "1.13-12"
release: "Debian 12 (Bookworm)"
platforms: ["linux"]
url: "https://new.carta.tech/vf_find_prop_qual_index"
---

# vf\_find\_prop\_qual\_index(3)

vf\_find\_prop\_qual\_index()

## NAME

vf\_find\_prop\_qual\_index - vf\_find\_prop\_qual\_index()

## SYNOPSIS

**#include \<../vformat/vf\_iface.h\>**

**extern bool\_t vf\_find\_prop\_qual\_index**\
 **(**\
\
 	**VF\_PROP\_T \*p\_prop,**\
\
 	**uint32\_t \*p\_qualifier\_index,**\
\
 	**uint32\_t \*p\_found\_value\_index,**\
\
 	**const char \*\*pp\_possible\_values,**\
\
 	**const char \*p\_token,**\
\
 	**vf\_search\_flags\_t match**\
 **);**

## PARAMETERS

- **VF\_PROP\_T \*p\_prop**

  The property we're querying.

- **uint32\_t \*p\_qualifier\_index**

  Ptr to output name index.

- **uint32\_t \*p\_found\_value\_index**

  Ptr to output index in array.

- **const char \*\*pp\_possible\_values**

  Array of possible values.

- **const char \*p\_token**

  Token searched for.

- **vf\_search\_flags\_t match**

  String comparison flags.

## DESCRIPTION

Locate property qualifier given either an array of possible values or a single token that is either present or absent.  For example if we have a property:

NAME;THIRD;TIME;LUCKY:VALUE1;VALUE2;VALUE3

Then there are two possible searches.

Firstly we can look for the property qualifier which can take values from the array { "FIRST", "SECOND", THIRD" } in which case the array is passed as pp\_possible\_values and the function returns with the values \*p\_found\_value\_index=2, p\_qualifier\_index=1

Secondly we can look for the token with value "TIME" in which case p\_token is set to "TIME" and the function returns \*p\_qualifier\_index=2.

## RETURNS

TRUE iff found, FALSE else.

## SEE ALSO

[vf\_parse\_init(3)](/vf_parse_init/3.md), [vf\_parse\_text(3)](/vf_parse_text/3.md), [vf\_parse\_end(3)](/vf_parse_end/3.md), [vf\_read\_file(3)](/vf_read_file/3.md), [vf\_write\_file(3)](/vf_write_file/3.md), [vf\_get\_next\_object(3)](/vf_get_next_object/3.md), [vf\_create\_object(3)](/vf_create_object/3.md), [vf\_get\_object\_type(3)](/vf_get_object_type/3.md), [vf\_get\_property(3)](/vf_get_property/3.md), [vf\_get\_property\_ex(3)](/vf_get_property_ex/3.md), [vf\_get\_next\_property(3)](/vf_get_next_property/3.md), [vf\_get\_prop\_value(3)](/vf_get_prop_value/3.md), [vf\_set\_prop\_value(3)](/vf_set_prop_value/3.md), [vf\_get\_prop\_value\_string(3)](/vf_get_prop_value_string/3.md), [vf\_get\_prop\_name\_string(3)](/vf_get_prop_name_string/3.md), [vf\_set\_prop\_name\_string(3)](/vf_set_prop_name_string/3.md), [vf\_get\_prop\_name(3)](/vf_get_prop_name/3.md), [vf\_get\_prop\_value\_object(3)](/vf_get_prop_value_object/3.md), [vf\_set\_prop\_value\_object(3)](/vf_set_prop_value_object/3.md), [vf\_set\_prop\_value\_string(3)](/vf_set_prop_value_string/3.md), [vf\_set\_prop\_value\_base64(3)](/vf_set_prop_value_base64/3.md), [vf\_get\_prop\_value\_base64(3)](/vf_get_prop_value_base64/3.md), [vf\_set\_property\_from\_file(3)](/vf_set_property_from_file/3.md), [vf\_delete\_object(3)](/vf_delete_object/3.md), [vf\_delete\_prop(3)](/vf_delete_prop/3.md), [vf\_is\_modified(3)](/vf_is_modified/3.md), [vf\_find\_charset(3)](/vf_find_charset/3.md), [vf\_date\_string\_to\_time(3)](/vf_date_string_to_time/3.md), [vf\_period\_string\_to\_time(3)](/vf_period_string_to_time/3.md), [vf\_period\_time\_to\_string(3)](/vf_period_time_to_string/3.md), [vf\_set\_prop\_value\_time(3)](/vf_set_prop_value_time/3.md), [vf\_get\_prop\_value\_time(3)](/vf_get_prop_value_time/3.md)