Libical API Documentation 4.0 STABLE VERSION [Visit the v3.0 documentation]
Loading...
Searching...
No Matches
vcardproperty.c File Reference

Implements the data structure representing vCard properties. More...

Go to the source code of this file.

Functions

void vcardproperty_add_parameter (vcardproperty *p, vcardparameter *parameter)
void vcardproperty_add_parameters (vcardproperty *prop, va_list args)
void vcardproperty_add_type_parameter (vcardproperty *prop, vcardenumarray_element *type)
const char * vcardproperty_as_vcard_string (vcardproperty *prop)
char * vcardproperty_as_vcard_string_r (vcardproperty *prop)
vcardproperty * vcardproperty_clone (const vcardproperty *old)
 Deeply clones an vcardproperty.
int vcardproperty_count_parameters (const vcardproperty *prop)
void vcardproperty_free (vcardproperty *p)
vcardparameter * vcardproperty_get_first_parameter (vcardproperty *p, vcardparameter_kind kind)
const char * vcardproperty_get_group (const vcardproperty *prop)
vcardparameter * vcardproperty_get_next_parameter (vcardproperty *p, vcardparameter_kind kind)
const char * vcardproperty_get_parameter_as_string (vcardproperty *prop, const char *name)
char * vcardproperty_get_parameter_as_string_r (vcardproperty *prop, const char *name)
vcardcomponent * vcardproperty_get_parent (const vcardproperty *property)
 Returns the parent vcard for the specified property.
const char * vcardproperty_get_property_name (const vcardproperty *prop)
char * vcardproperty_get_property_name_r (const vcardproperty *prop)
vcardvalue * vcardproperty_get_value (const vcardproperty *prop)
const char * vcardproperty_get_value_as_string (const vcardproperty *prop)
char * vcardproperty_get_value_as_string_r (const vcardproperty *prop)
const char * vcardproperty_get_x_name (const vcardproperty *prop)
vcardproperty_kind vcardproperty_isa (const vcardproperty *p)
bool vcardproperty_isa_property (void *property)
vcardproperty * vcardproperty_new (vcardproperty_kind kind)
vcardproperty * vcardproperty_new_from_string (const char *str)
struct vcardproperty_impl * vcardproperty_new_impl (vcardproperty_kind kind)
void vcardproperty_normalize (vcardproperty *prop)
void vcardproperty_remove_parameter_by_kind (vcardproperty *prop, vcardparameter_kind kind)
 Removes all parameters with the specified kind.
void vcardproperty_remove_parameter_by_name (vcardproperty *prop, const char *name)
 Removes all parameters with the specified name.
void vcardproperty_remove_parameter_by_ref (vcardproperty *prop, vcardparameter *parameter)
 Removes the specified parameter reference from the property.
void vcardproperty_set_group (vcardproperty *prop, const char *group)
void vcardproperty_set_parameter (vcardproperty *prop, vcardparameter *parameter)
void vcardproperty_set_parameter_from_string (vcardproperty *prop, const char *name, const char *value)
void vcardproperty_set_parent (vcardproperty *property, vcardcomponent *comp)
 Sets the parent vcard for the specified vcardproperty property.
void vcardproperty_set_value (vcardproperty *p, vcardvalue *value)
void vcardproperty_set_value_from_string (vcardproperty *prop, const char *str, const char *type)
void vcardproperty_set_x_name (vcardproperty *prop, const char *name)

Detailed Description

Implements the data structure representing vCard properties.

Definition in file vcardproperty.c.

Function Documentation

◆ vcardproperty_add_parameter()

void vcardproperty_add_parameter ( vcardproperty * p,
vcardparameter * parameter )

Definition at line 567 of file vcardproperty.c.

◆ vcardproperty_add_parameters()

void vcardproperty_add_parameters ( vcardproperty * prop,
va_list args )

Definition at line 63 of file vcardproperty.c.

◆ vcardproperty_add_type_parameter()

void vcardproperty_add_type_parameter ( vcardproperty * prop,
vcardenumarray_element * type )

Definition at line 1143 of file vcardproperty.c.

◆ vcardproperty_as_vcard_string()

const char * vcardproperty_as_vcard_string ( vcardproperty * prop)

Definition at line 442 of file vcardproperty.c.

◆ vcardproperty_as_vcard_string_r()

char * vcardproperty_as_vcard_string_r ( vcardproperty * prop)

Definition at line 451 of file vcardproperty.c.

◆ vcardproperty_clone()

vcardproperty * vcardproperty_clone ( const vcardproperty * old)

Deeply clones an vcardproperty.

Returns a pointer to the memory for the newly cloned vcardproperty.

Since
4.0

Definition at line 87 of file vcardproperty.c.

◆ vcardproperty_count_parameters()

int vcardproperty_count_parameters ( const vcardproperty * prop)

Definition at line 775 of file vcardproperty.c.

◆ vcardproperty_free()

void vcardproperty_free ( vcardproperty * p)

Definition at line 189 of file vcardproperty.c.

◆ vcardproperty_get_first_parameter()

vcardparameter * vcardproperty_get_first_parameter ( vcardproperty * p,
vcardparameter_kind kind )

Definition at line 785 of file vcardproperty.c.

◆ vcardproperty_get_group()

const char * vcardproperty_get_group ( const vcardproperty * prop)

Definition at line 965 of file vcardproperty.c.

◆ vcardproperty_get_next_parameter()

vcardparameter * vcardproperty_get_next_parameter ( vcardproperty * p,
vcardparameter_kind kind )

Definition at line 807 of file vcardproperty.c.

◆ vcardproperty_get_parameter_as_string()

const char * vcardproperty_get_parameter_as_string ( vcardproperty * prop,
const char * name )

Definition at line 627 of file vcardproperty.c.

◆ vcardproperty_get_parameter_as_string_r()

char * vcardproperty_get_parameter_as_string_r ( vcardproperty * prop,
const char * name )

Definition at line 636 of file vcardproperty.c.

◆ vcardproperty_get_parent()

vcardcomponent * vcardproperty_get_parent ( const vcardproperty * property)

Returns the parent vcard for the specified property.

Definition at line 1020 of file vcardproperty.c.

◆ vcardproperty_get_property_name()

const char * vcardproperty_get_property_name ( const vcardproperty * prop)

Returns the name of the property – the type name converted to a string, or the value of _get_x_name if the type is and X property

Definition at line 972 of file vcardproperty.c.

◆ vcardproperty_get_property_name_r()

char * vcardproperty_get_property_name_r ( const vcardproperty * prop)

Definition at line 981 of file vcardproperty.c.

◆ vcardproperty_get_value()

vcardvalue * vcardproperty_get_value ( const vcardproperty * prop)

Definition at line 899 of file vcardproperty.c.

◆ vcardproperty_get_value_as_string()

const char * vcardproperty_get_value_as_string ( const vcardproperty * prop)

Definition at line 906 of file vcardproperty.c.

◆ vcardproperty_get_value_as_string_r()

char * vcardproperty_get_value_as_string_r ( const vcardproperty * prop)

Definition at line 915 of file vcardproperty.c.

◆ vcardproperty_get_x_name()

const char * vcardproperty_get_x_name ( const vcardproperty * prop)

Definition at line 942 of file vcardproperty.c.

◆ vcardproperty_isa()

vcardproperty_kind vcardproperty_isa ( const vcardproperty * p)

Definition at line 550 of file vcardproperty.c.

◆ vcardproperty_isa_property()

bool vcardproperty_isa_property ( void * property)

Definition at line 559 of file vcardproperty.c.

◆ vcardproperty_new()

vcardproperty * vcardproperty_new ( vcardproperty_kind kind)

Definition at line 78 of file vcardproperty.c.

◆ vcardproperty_new_from_string()

vcardproperty * vcardproperty_new_from_string ( const char * str)

Definition at line 143 of file vcardproperty.c.

◆ vcardproperty_new_impl()

struct vcardproperty_impl * vcardproperty_new_impl ( vcardproperty_kind kind)

Definition at line 41 of file vcardproperty.c.

◆ vcardproperty_normalize()

void vcardproperty_normalize ( vcardproperty * prop)

Normalizes (reorders and sorts the parameters) the specified vcardproperty.

Since
3.0

Definition at line 1033 of file vcardproperty.c.

◆ vcardproperty_remove_parameter_by_kind()

void vcardproperty_remove_parameter_by_kind ( vcardproperty * prop,
vcardparameter_kind kind )

Removes all parameters with the specified kind.

Parameters
propA valid vcardproperty.
kindThe kind to remove (ex. VCARD_TZ_PARAMETER)

See vcardproperty_remove_parameter_by_name() and vcardproperty_remove_parameter_by_ref() for alternate ways of removing parameters

Definition at line 710 of file vcardproperty.c.

◆ vcardproperty_remove_parameter_by_name()

void vcardproperty_remove_parameter_by_name ( vcardproperty * prop,
const char * name )

Removes all parameters with the specified name.

Parameters
propA valid vcardproperty.
nameThe name of the parameter to remove

This function removes parameters with the given name. The name corresponds to either a built-in name (TZID, etc.) or the name of an extended parameter (X-FOO)

See vcardproperty_remove_parameter_by_kind() and vcardproperty_remove_parameter_by_ref() for alternate ways of removing parameters

Definition at line 727 of file vcardproperty.c.

◆ vcardproperty_remove_parameter_by_ref()

void vcardproperty_remove_parameter_by_ref ( vcardproperty * prop,
vcardparameter * param )

Removes the specified parameter reference from the property.

Parameters
propA valid vcardproperty.
paramA reference to a specific vcardparameter.

This function removes the specified parameter reference from the property.

Definition at line 757 of file vcardproperty.c.

◆ vcardproperty_set_group()

void vcardproperty_set_group ( vcardproperty * prop,
const char * group )

Definition at line 949 of file vcardproperty.c.

◆ vcardproperty_set_parameter()

void vcardproperty_set_parameter ( vcardproperty * prop,
vcardparameter * parameter )

Definition at line 575 of file vcardproperty.c.

◆ vcardproperty_set_parameter_from_string()

void vcardproperty_set_parameter_from_string ( vcardproperty * prop,
const char * name,
const char * value )

Definition at line 594 of file vcardproperty.c.

◆ vcardproperty_set_parent()

void vcardproperty_set_parent ( vcardproperty * property,
vcardcomponent * comp )

Sets the parent vcard for the specified vcardproperty property.

Since
3.0

Definition at line 1013 of file vcardproperty.c.

◆ vcardproperty_set_value()

void vcardproperty_set_value ( vcardproperty * p,
vcardvalue * value )

Definition at line 827 of file vcardproperty.c.

◆ vcardproperty_set_value_from_string()

void vcardproperty_set_value_from_string ( vcardproperty * prop,
const char * str,
const char * type )

Definition at line 858 of file vcardproperty.c.

◆ vcardproperty_set_x_name()

void vcardproperty_set_x_name ( vcardproperty * prop,
const char * name )

Definition at line 926 of file vcardproperty.c.