go to
> vf_parse_init(3)
> vf_parse_text(3)
> vf_parse_end(3)
> vf_read_file(3)
> vf_write_file(3)
Homepage > Man Pages > Category > Subroutines
Homepage > Man Pages > Name > V

vf_get_property

man page of vf_get_property

vf_get_property: vf_get_property()

NAME

vf_get_property - vf_get_property()

SYNOPSIS

#include <../vformat/vf_iface.h> extern bool_t vf_get_property ( VF_PROP_T **pp_prop, VF_OBJECT_T *p_object, vf_get_t ops, const char *p_group, const char *p_name, const char *p_qualifier, ... );

PARAMETERS

VF_PROP_T **pp_prop Output pointer. VF_OBJECT_T *p_object Object to add to. vf_get_t ops Search flags. const char *p_group Group name if any. const char *p_name Name of tag. const char *p_qualifier First qualifier if any. ... Subequent qualifiers.
DESCRIPTION
Basic searching function locating elements of the VOBJECT by qualified name. The function is a varargs function (like sprintf) and the list of arguments must be NULL terminated (hence the appearance of the p_qualifier argument in the arglist). Valid calls might be: vf_get_property(&p_out, p_object, VFGP_FIND, NULL, "N", NULL); - Find and return "N" properties. If there are none, return FALSE. Vf_get_property(&p_out, p_object, VFGP_FIND, NULL, "TEL", "WORK", NULL); - Find and return "TEL" entries qualified by the "work" attribute (ie. Work phone numbers). If there are none, return FALSE. Vf_get_property(&p_out, p_object, VFGP_GET, NULL, "TEL", "WORK", NULL); - Find and return work phone number. The entry is automatically added if not pre-existing. Vf_get_property(&p_out, p_object, VFGP_GET, NULL, "TEL", "WORK", NULL); - Find and return work phone numbers in the group identifier by the "ME" identifier. The entry is automatically added if not pre-existing. Vf_get_property(&p_out, p_object, VFGP_FIND, "ME", "*", NULL); - Effectively enumerates all entries in the "ME" group. A pointer to the first property matching the search criteria is returned via the pp_prop argument. The search actually locates all such matches and pointer to subsequent entries (if there are >1) may be found by calling the vf_get_next_property() function. The tags may occur in any order _except_ that the p_name must be first. Note that the VF_PROP_T returned by pp_prop is an opaque type and the functions vf_get_prop_xxxx() etc. Must be used to locate real "values". Cached search results (the list enumerated by subsequent calls to the vf_get_next_property() function) are maintained through the use of a a single internal pointer therefore this method is not thread safe.
RETURNS
TRUE iff found/added successfully. Ptr to prop returned via pp_prop.

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_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_find_prop_qual_index(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) VF_GET_PROPERTY(3)
 
 
 

Copyright © 2011–2018 by topics-of-interest.com . All rights reserved. Hosted by all-inkl.
Contact · Imprint · Privacy

Page generated in 17.45ms.

amazing-wings.de | brieftaubenversteigerung.com | generiere.de