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_text(3),  vf_parse_end(3),  vf_read_file(3), vf_write_file(3),
       vf_get_next_object(3),  vf_create_object(3),  vf_get_object_type(3),   vf_get_property(3),
       vf_get_property_ex(3),            vf_get_next_property(3),           vf_get_prop_value(3),
       vf_set_prop_value(3),       vf_get_prop_value_string(3),       vf_get_prop_name_string(3),
       vf_set_prop_name_string(3),        vf_get_prop_name(3),       vf_get_prop_value_object(3),
       vf_set_prop_value_object(3),   vf_set_prop_value_string(3),   vf_set_prop_value_base64(3),
       vf_get_prop_value_base64(3),       vf_set_property_from_file(3),      vf_delete_object(3),
       vf_delete_prop(3),   vf_is_modified(3),   vf_find_charset(3),   vf_date_string_to_time(3),
       vf_period_string_to_time(3),    vf_period_time_to_string(3),    vf_set_prop_value_time(3),
       vf_get_prop_value_time(3)