Attachment #336230 for bug #453204

View | Details | Raw Unified | Return to bug 453204
Collapse All | Expand All




p_qualifier argument in the arglist).  Valid calls might be:

@example
  vf_get_property(&p_out, p_object, VFGP_FIND, NULL, "N", (char*)0);
    - find and return "N" properties.  If there are none, return FALSE.

  vf_get_property(&p_out, p_object, VFGP_FIND, NULL, "TEL", "WORK", (char*)0);
    - 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", (char*)0);
    - find and return work phone number.  The entry is automatically
    added if not pre-existing.

  vf_get_property(&p_out, p_object, VFGP_GET, "ME", "TEL", "WORK", (char*)0);
    - 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", "*", (char*)0);
    - effectively enumerates all entries in the "ME" group.
@end example





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", (char*)0);
.br
- Find and return "N" properties.  If there are none, return FALSE.

vf_get_property(&p_out, p_object, VFGP_FIND, NULL, "TEL", "WORK", (char*)0);
.br
- 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", (char*)0);
.br
- Find and return work phone number.  The entry is automatically
added if not pre-existing.

vf_get_property(&p_out, p_object, VFGP_GET, "ME", "TEL", "WORK", (char*)0);
.br
- 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", "*", (char*)0);
.br
- Effectively enumerates all entries in the "ME" group.


Return to bug 453204

Lines 183-204 Link Here

(-)doc.old/libvformat-1.texi (-5 / +5 lines)
183	p_qualifier argument in the arglist). Valid calls might be:	183	p_qualifier argument in the arglist). Valid calls might be:
184		184
185	@example	185	@example
186	vf_get_property(&p_out, p_object, VFGP_FIND, NULL, "N", NULL);	186	vf_get_property(&p_out, p_object, VFGP_FIND, NULL, "N", (char*)0);
187	- find and return "N" properties. If there are none, return FALSE.	187	- find and return "N" properties. If there are none, return FALSE.
188		188
189	vf_get_property(&p_out, p_object, VFGP_FIND, NULL, "TEL", "WORK", NULL);	189	vf_get_property(&p_out, p_object, VFGP_FIND, NULL, "TEL", "WORK", (char*)0);
190	- find and return "TEL" entries qualified by the "work" attribute	190	- find and return "TEL" entries qualified by the "work" attribute
191	(ie. work phone numbers). If there are none, return FALSE.	191	(ie. work phone numbers). If there are none, return FALSE.
192		192
193	vf_get_property(&p_out, p_object, VFGP_GET, NULL, "TEL", "WORK", NULL);	193	vf_get_property(&p_out, p_object, VFGP_GET, NULL, "TEL", "WORK", (char*)0);
194	- find and return work phone number. The entry is automatically	194	- find and return work phone number. The entry is automatically
195	added if not pre-existing.	195	added if not pre-existing.
196		196
197	vf_get_property(&p_out, p_object, VFGP_GET, NULL, "TEL", "WORK", NULL);	197	vf_get_property(&p_out, p_object, VFGP_GET, "ME", "TEL", "WORK", (char*)0);
198	- find and return work phone numbers in the group identifier by the "ME"	198	- find and return work phone numbers in the group identifier by the "ME"
199	identifier. The entry is automatically added if not pre-existing.	199	identifier. The entry is automatically added if not pre-existing.
200		200
201	vf_get_property(&p_out, p_object, VFGP_FIND, "ME", "*", NULL);	201	vf_get_property(&p_out, p_object, VFGP_FIND, "ME", "", (char)0);
202	- effectively enumerates all entries in the "ME" group.	202	- effectively enumerates all entries in the "ME" group.
203	@end example	203	@end example
204		204

Lines 55-80 Link Here

(-)doc.old/vf_get_property.3 (-5 / +5 lines)
55	of arguments must be NULL terminated (hence the appearance of the	55	of arguments must be NULL terminated (hence the appearance of the
56	p_qualifier argument in the arglist). Valid calls might be:	56	p_qualifier argument in the arglist). Valid calls might be:
57		57
58	vf_get_property(&p_out, p_object, VFGP_FIND, NULL, "N", NULL);	58	vf_get_property(&p_out, p_object, VFGP_FIND, NULL, "N", (char*)0);
59	.br	59	.br
60	- Find and return "N" properties. If there are none, return FALSE.	60	- Find and return "N" properties. If there are none, return FALSE.
61		61
62	Vf_get_property(&p_out, p_object, VFGP_FIND, NULL, "TEL", "WORK", NULL);	62	vf_get_property(&p_out, p_object, VFGP_FIND, NULL, "TEL", "WORK", (char*)0);
63	.br	63	.br
64	- Find and return "TEL" entries qualified by the "work" attribute	64	- Find and return "TEL" entries qualified by the "work" attribute
65	(ie. Work phone numbers). If there are none, return FALSE.	65	(ie. Work phone numbers). If there are none, return FALSE.
66		66
67	Vf_get_property(&p_out, p_object, VFGP_GET, NULL, "TEL", "WORK", NULL);	67	vf_get_property(&p_out, p_object, VFGP_GET, NULL, "TEL", "WORK", (char*)0);
68	.br	68	.br
69	- Find and return work phone number. The entry is automatically	69	- Find and return work phone number. The entry is automatically
70	added if not pre-existing.	70	added if not pre-existing.
71		71
72	Vf_get_property(&p_out, p_object, VFGP_GET, NULL, "TEL", "WORK", NULL);	72	vf_get_property(&p_out, p_object, VFGP_GET, "ME", "TEL", "WORK", (char*)0);
73	.br	73	.br
74	- Find and return work phone numbers in the group identifier by the "ME"	74	- Find and return work phone numbers in the group identifier by the "ME"
75	identifier. The entry is automatically added if not pre-existing.	75	identifier. The entry is automatically added if not pre-existing.
76		76
77	Vf_get_property(&p_out, p_object, VFGP_FIND, "ME", "*", NULL);	77	vf_get_property(&p_out, p_object, VFGP_FIND, "ME", "", (char)0);
78	.br	78	.br
79	- Effectively enumerates all entries in the "ME" group.	79	- Effectively enumerates all entries in the "ME" group.
80		80