|
Libical API Documentation 4.0 UNRELEASED Go to the stable 3.0 documentation
|
Defines the data structure representing iCalendar properties. More...
Go to the source code of this file.
Functions | |
| icalproperty * | icalparameter_get_parent (const icalparameter *param) |
| void | icalparameter_set_parent (icalparameter *param, icalproperty *property) |
| icalvalue_kind | icalparameter_value_to_value_kind (icalparameter_value value) |
| const char * | icalproperty_action_to_string (icalproperty_action action) |
| void | icalproperty_add_parameter (icalproperty *prop, icalparameter *parameter) |
| void | icalproperty_add_parameters (icalproperty *prop, va_list args) |
| const char * | icalproperty_as_ical_string (icalproperty *prop) |
| char * | icalproperty_as_ical_string_r (icalproperty *prop) |
| const char * | icalproperty_class_to_string (icalproperty_class propclass) |
| icalproperty * | icalproperty_clone (const icalproperty *old) |
| int | icalproperty_count_parameters (const icalproperty *prop) |
| bool | icalproperty_enum_belongs_to_property (icalproperty_kind kind, int e) |
| const char * | icalproperty_enum_to_string (int e) |
| char * | icalproperty_enum_to_string_r (int e) |
| void | icalproperty_free (icalproperty *prop) |
| bool | icalproperty_get_allow_empty_properties (void) |
| icalparameter * | icalproperty_get_first_parameter (icalproperty *prop, icalparameter_kind kind) |
| const char * | icalproperty_get_iana_name (const icalproperty *prop) |
| icalparameter * | icalproperty_get_next_parameter (icalproperty *prop, icalparameter_kind kind) |
| const char * | icalproperty_get_parameter_as_string (icalproperty *prop, const char *name) |
| char * | icalproperty_get_parameter_as_string_r (icalproperty *prop, const char *name) |
| const char * | icalproperty_get_property_name (const icalproperty *prop) |
| char * | icalproperty_get_property_name_r (const icalproperty *prop) |
| icalvalue * | icalproperty_get_value (const icalproperty *prop) |
| const char * | icalproperty_get_value_as_string (const icalproperty *prop) |
| char * | icalproperty_get_value_as_string_r (const icalproperty *prop) |
| const char * | icalproperty_get_x_name (const icalproperty *prop) |
| icalproperty_kind | icalproperty_isa (const icalproperty *property) |
| bool | icalproperty_isa_property (void *property) |
| int | icalproperty_kind_and_string_to_enum (const int kind, const char *str) |
| bool | icalproperty_kind_is_valid (const icalproperty_kind kind) |
| const char * | icalproperty_kind_to_string (icalproperty_kind kind) |
| icalvalue_kind | icalproperty_kind_to_value_kind (icalproperty_kind kind) |
| const char * | icalproperty_method_to_string (icalproperty_method method) |
| icalproperty * | icalproperty_new (icalproperty_kind kind) |
| icalproperty * | icalproperty_new_from_string (const char *str) |
| void | icalproperty_normalize (icalproperty *prop) |
| const char * | icalproperty_participanttype_to_string (icalproperty_participanttype participanttype) |
| void | icalproperty_remove_parameter_by_kind (icalproperty *prop, icalparameter_kind kind) |
| Removes all parameters with the specified kind. | |
| void | icalproperty_remove_parameter_by_name (icalproperty *prop, const char *name) |
| Removes all parameters with the specified name. | |
| void | icalproperty_remove_parameter_by_ref (icalproperty *prop, icalparameter *param) |
| Removes the specified parameter reference from the property. | |
| const char * | icalproperty_resourcetype_to_string (icalproperty_resourcetype resourcetype) |
| void | icalproperty_set_allow_empty_properties (bool enable) |
| void | icalproperty_set_iana_name (icalproperty *prop, const char *name) |
| void | icalproperty_set_parameter (icalproperty *prop, icalparameter *parameter) |
| void | icalproperty_set_parameter_from_string (icalproperty *prop, const char *name, const char *value) |
| void | icalproperty_set_value (icalproperty *prop, icalvalue *value) |
| void | icalproperty_set_value_from_string (icalproperty *prop, const char *str, const char *type) |
| void | icalproperty_set_x_name (icalproperty *prop, const char *name) |
| const char * | icalproperty_status_to_string (icalproperty_status status) |
| icalproperty_action | icalproperty_string_to_action (const char *string) |
| icalproperty_class | icalproperty_string_to_class (const char *string) |
| icalproperty_kind | icalproperty_string_to_kind (const char *string) |
| icalproperty_method | icalproperty_string_to_method (const char *str) |
| icalproperty_participanttype | icalproperty_string_to_participanttype (const char *string) |
| icalproperty_resourcetype | icalproperty_string_to_resourcetype (const char *string) |
| icalproperty_status | icalproperty_string_to_status (const char *string) |
| icalproperty_transp | icalproperty_string_to_transp (const char *string) |
| const char * | icalproperty_transp_to_string (icalproperty_transp transp) |
| icalproperty_kind | icalproperty_value_kind_to_kind (icalvalue_kind kind) |
| icalproperty * | icalvalue_get_parent (const icalvalue *value) |
| void | icalvalue_set_parent (icalvalue *value, icalproperty *property) |
Defines the data structure representing iCalendar properties.
Definition in file icalproperty.h.
| icalproperty * icalparameter_get_parent | ( | const icalparameter * | param | ) |
Gets the parent icalproperty of an icalparameter.
| param | a pointer to the icalparameter |
icalproperty for the specified icalparameter. Definition at line 371 of file icalparameter.c.
| void icalparameter_set_parent | ( | icalparameter * | param, |
| icalproperty * | property ) |
Sets the parent icalproperty for the specified icalparameter.
| param | a pointer to a valid icalparameter |
| property | a pointer to a presumably valid icalproperty to use |
Definition at line 364 of file icalparameter.c.
| icalvalue_kind icalparameter_value_to_value_kind | ( | icalparameter_value | value | ) |
Converts an icalparameter_value to an icalvalue_kind.
| value | the icalparameter_value to use |
value; returns ICAL_NO_VALUE if value is invalid. | const char * icalproperty_action_to_string | ( | icalproperty_action | action | ) |
Converts an icalproperty_action to its string representation.
| action | is the icalproperty_action to use |
| void icalproperty_add_parameter | ( | icalproperty * | prop, |
| icalparameter * | parameter ) |
Adds a parameter to the specified icalproperty.
No error checking is performed by this function.
| prop | a pointer to a valid icalproperty |
| parameter | a pointer to a presumably valid icalparameter |
Definition at line 488 of file icalproperty.c.
| void icalproperty_add_parameters | ( | icalproperty * | prop, |
| va_list | args ) |
Adds a list of parameter to the specified icalproperty.
| prop | a pointer to a valid icalproperty. |
| args | a va_list of pointers that presumably point to list of valid icalparameters. |
If any item in va_list points to an illegal icalparameter the internal library icalerrno is set to ICAL_BADARG_ERROR.
Any item in va_list points to an icalvalue is ignored.
Definition at line 77 of file icalproperty.c.
| const char * icalproperty_as_ical_string | ( | icalproperty * | prop | ) |
Stringify an icalproperty.
| prop | a pointer to an icalproperty |
prop. NULL is returned is prop is invalid.Definition at line 360 of file icalproperty.c.
| char * icalproperty_as_ical_string_r | ( | icalproperty * | prop | ) |
Stringify an icalproperty.
| prop | a pointer to an icalproperty |
prop. NULL is returned is prop is invalid.Definition at line 369 of file icalproperty.c.
| const char * icalproperty_class_to_string | ( | icalproperty_class | propclass | ) |
Converts an icalproperty_class to its string representation.
| propclass | is the icalproperty_class to use |
| icalproperty * icalproperty_clone | ( | const icalproperty * | old | ) |
Deeply clones an icalproperty.
| old | a pointer to the icalproperty to clone |
Definition at line 100 of file icalproperty.c.
| int icalproperty_count_parameters | ( | const icalproperty * | prop | ) |
Gets the number of parameter for a specified icalproperty.
| prop | a pointer to a valid icalproperty |
prop. Returns -1 if prop is NULL. Definition at line 699 of file icalproperty.c.
| bool icalproperty_enum_belongs_to_property | ( | icalproperty_kind | kind, |
| int | e ) |
Determines if a integer ia a valid enum for a specified icalproperty_kind.
| kind | is the icalproperty_kind |
| e | is a an integer to validate as an enum of type icalproperty_kind |
| const char * icalproperty_enum_to_string | ( | int | e | ) |
Converts an integer representing some icalproperty type to its string representation.
| e | is an integer between ICALPROPERTY_FIRST_ENUM and ICALPROPERTY_LAST_ENUM, inclusive. |
| char * icalproperty_enum_to_string_r | ( | int | e | ) |
Converts an integer representing some icalproperty type to its string representation.
| e | is an integer between ICALPROPERTY_FIRST_ENUM and ICALPROPERTY_LAST_ENUM, inclusive. |
| void icalproperty_free | ( | icalproperty * | prop | ) |
Free the memory for an icalproperty.
| prop | a pointer to a valid icalproperty |
Definition at line 184 of file icalproperty.c.
| bool icalproperty_get_allow_empty_properties | ( | void | ) |
Returns if empty properties are allowed; else are replaced with X-LIC-ERROR properties.
Definition at line 72 of file icalproperty.c.
| icalparameter * icalproperty_get_first_parameter | ( | icalproperty * | prop, |
| icalparameter_kind | kind ) |
From the head position, iterates the icalparameter list attached to the specified icalproperty until the first icalparameter_kind is found.
| prop | a pointer to a valid icalproperty |
| kind | an icalparameter_kind to use for the search |
kind ; NULL if no matches are found. Definition at line 709 of file icalproperty.c.
| const char * icalproperty_get_iana_name | ( | const icalproperty * | prop | ) |
Gets the IANA name of the specified icalproperty.
| prop | a pointer to a valid icalproperty |
comp IANA name; will be NULL if the name has yet to be specified. Definition at line 883 of file icalproperty.c.
| icalparameter * icalproperty_get_next_parameter | ( | icalproperty * | prop, |
| icalparameter_kind | kind ) |
From the current position, iterates the icalparameter list attached to the specified icalproperty until the next icalparameter_kind is found.
| prop | a pointer to a valid icalproperty |
| kind | an icalparameter_kind to use for the search |
kind; NULL if no matches are found. Definition at line 731 of file icalproperty.c.
| const char * icalproperty_get_parameter_as_string | ( | icalproperty * | prop, |
| const char * | name ) |
Gets the parameter value for a specified icalproperty parameter.
| prop | a pointer to a valid icalproperty |
| name | a a pointer to a char string containing the name of icalparameter to use |
name refers to an invalid icalproperty_kind.Definition at line 548 of file icalproperty.c.
| char * icalproperty_get_parameter_as_string_r | ( | icalproperty * | prop, |
| const char * | name ) |
Gets the parameter value for a specified icalproperty parameter.
| prop | a pointer to a valid icalproperty |
| name | a pointer to a char string containing the name of icalparameter to use |
name refers to an invalid icalproperty_kind.Definition at line 557 of file icalproperty.c.
| const char * icalproperty_get_property_name | ( | const icalproperty * | prop | ) |
Gets the name of the specified icalproperty.
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.
| prop | a pointer to the icalproperty |
Definition at line 891 of file icalproperty.c.
| char * icalproperty_get_property_name_r | ( | const icalproperty * | prop | ) |
Gets the name of the specified icalproperty.
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.
| prop | a pointer to the icalproperty |
Definition at line 900 of file icalproperty.c.
| icalvalue * icalproperty_get_value | ( | const icalproperty * | prop | ) |
Gets the icalvalue for the specified icalproperty.
| prop | a pointer to a valid icalproperty |
prop icalvalue; or NULL if prop does not have an attached icalvalue yet. Definition at line 822 of file icalproperty.c.
| const char * icalproperty_get_value_as_string | ( | const icalproperty * | prop | ) |
Gets the icalvalue for the specified icalproperty as a char string.
| prop | a pointer to a valid icalproperty |
prop icalvalue; or NULL if prop does not have an attached icalvalue yet.Definition at line 829 of file icalproperty.c.
| char * icalproperty_get_value_as_string_r | ( | const icalproperty * | prop | ) |
Gets the icalvalue for the specified icalproperty as a char string.
| prop | a pointer to a valid icalproperty |
prop icalvalue; or NULL if prop does not have an attached icalvalue yet.Definition at line 838 of file icalproperty.c.
| const char * icalproperty_get_x_name | ( | const icalproperty * | prop | ) |
Gets the X-NAME icalproperty of the specified icalproperty.
| prop | a pointer to a valid icalproperty |
Definition at line 862 of file icalproperty.c.
| icalproperty_kind icalproperty_isa | ( | const icalproperty * | property | ) |
Determines the icalproperty_kind of the specified icalproperty.
| property | a pointer to valid icalproperty. |
property; ICAL_NO_PROPERTY is returned if property is NULL. Definition at line 467 of file icalproperty.c.
| bool icalproperty_isa_property | ( | void * | property | ) |
Determines if the specified pointer is an icalproperty pointer.
Just looks if the ::id member strncmps to "prop".
| property | a pointer, presumably to an icalproperty. |
Definition at line 476 of file icalproperty.c.
| int icalproperty_kind_and_string_to_enum | ( | const int | kind, |
| const char * | str ) |
Converts an integer representation of an icalvalue_kind enum along with a string representation of an icalproperty_kind to an integer representation of an icalproperty enum.
| kind | is a integer representation of an icalvalue_kind |
| str | is a non-NULL pointer to a char string containing the string representation of the icalproperty enum. |
kind is invalid. | bool icalproperty_kind_is_valid | ( | const icalproperty_kind | kind | ) |
Check validity of a specified icalproperty_kind.
| kind | is the icalproperty_kind |
| const char * icalproperty_kind_to_string | ( | icalproperty_kind | kind | ) |
Converts an icalproperty_kind to its string representation.
| kind | is the icalproperty_kind to use |
| icalvalue_kind icalproperty_kind_to_value_kind | ( | icalproperty_kind | kind | ) |
Converts an icalproperty_kind to an icalvalue_kind.
| kind | is the icalproperty_kind to use |
kind; returns ICAL_NO_VALUE if kind is invalid. | const char * icalproperty_method_to_string | ( | icalproperty_method | method | ) |
Converts an icalproperty_method to its string representation.
| method | is the icalproperty_method to use |
| icalproperty * icalproperty_new | ( | icalproperty_kind | kind | ) |
Construct a new icalproperty of the specified icalproperty_kind.
| kind | is the icalproperty_kind to use |
Definition at line 91 of file icalproperty.c.
| icalproperty * icalproperty_new_from_string | ( | const char * | str | ) |
Construct and populate a new icalproperty from a char string.
| str | a non-NULL pointer to the data used to populate the new icalproperty. |
Definition at line 138 of file icalproperty.c.
| void icalproperty_normalize | ( | icalproperty * | prop | ) |
Normalizes (reorders and sorts the parameters) the specified icalproperty.
| prop | a pointer a valid icalproperty |
Definition at line 953 of file icalproperty.c.
| const char * icalproperty_participanttype_to_string | ( | icalproperty_participanttype | participanttype | ) |
Converts an icalproperty_participanttype to its string representation.
| participanttype | is the icalproperty_participanttype to use |
| void icalproperty_remove_parameter_by_kind | ( | icalproperty * | prop, |
| icalparameter_kind | kind ) |
Removes all parameters with the specified kind.
| prop | A valid icalproperty. |
| kind | The kind to remove (ex. ICAL_TZID_PARAMETER) |
See icalproperty_remove_parameter_by_name() and icalproperty_remove_parameter_by_ref() for alternate ways of removing parameters
Definition at line 632 of file icalproperty.c.
| void icalproperty_remove_parameter_by_name | ( | icalproperty * | prop, |
| const char * | name ) |
Removes all parameters with the specified name.
| prop | A valid icalproperty. |
| name | The 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 icalproperty_remove_parameter_by_kind() and icalproperty_remove_parameter_by_ref() for alternate ways of removing parameters
Definition at line 650 of file icalproperty.c.
| void icalproperty_remove_parameter_by_ref | ( | icalproperty * | prop, |
| icalparameter * | param ) |
Removes the specified parameter reference from the property.
| prop | A valid icalproperty. |
| param | A reference to a specific icalparameter. |
This function removes the specified parameter reference from the property.
Definition at line 681 of file icalproperty.c.
| const char * icalproperty_resourcetype_to_string | ( | icalproperty_resourcetype | resourcetype | ) |
Converts an icalproperty_resourcetype to its string representation.
| resourcetype | is the icalproperty_resourcetype to use |
| void icalproperty_set_allow_empty_properties | ( | bool | enable | ) |
Sets if empty properties are permitted.
Determines the library behavior whenever an empty property is encountered. When not set (the default) empty properties are replaced with X-LIC-ERROR properties. Otherwise, processing proceeds normally and the property value will be empty.
| enable | If true, libical allows empty properties; otherwise empty properties are replaced by X-LIC-ERROR properties. |
Note that if icalerror_get_errors_are_fatal is also true a SIGABRT will be raised whenever an empty property is encountered.
Definition at line 67 of file icalproperty.c.
| void icalproperty_set_iana_name | ( | icalproperty * | prop, |
| const char * | name ) |
Sets the IANA name for an icalproperty.
| prop | a pointer to a valid icalproperty |
| name | a pointer to char string containing the IANA name. |
Definition at line 869 of file icalproperty.c.
| void icalproperty_set_parameter | ( | icalproperty * | prop, |
| icalparameter * | parameter ) |
Adds an icalparameter to an icalproperty.
No error checking is performed by this function.
| prop | a pointer to a valid icalproperty |
| parameter | a pointer to a presumably valid icalparameter |
If parameter kind is already attached to prop then the old parameter is removed in favor of parameter.
Definition at line 496 of file icalproperty.c.
| void icalproperty_set_parameter_from_string | ( | icalproperty * | prop, |
| const char * | name, | ||
| const char * | value ) |
Sets a icalparameter from a string for the specified icalproperty.
| prop | a pointer to a valid icalproperty |
| name | a pointer to a char string containing the parameter name |
| value | a pointer to a char string containing the parameter value |
If name refers to an invalid icalparameter_kind or value is illegal, then the internal library icalerrno is set to ICAL_BADARG_ERROR.
Definition at line 515 of file icalproperty.c.
| void icalproperty_set_value | ( | icalproperty * | prop, |
| icalvalue * | value ) |
Sets an icalvalue for the specified icalproperty.
| prop | a pointer to a valid icalproperty |
| value | a pointer to a valid icalvalue to use |
If prop already has an icalvalue it will be replaced.
Definition at line 751 of file icalproperty.c.
| void icalproperty_set_value_from_string | ( | icalproperty * | prop, |
| const char * | str, | ||
| const char * | type ) |
Sets an icalvalue for the specified icalproperty from a char string..
| prop | a pointer to a valid icalproperty |
| str | a non-NULL pointer to char string to be converted to the icalvalue |
| type | a non-NULL pointer to a char string to be converted to an icalvalue_kind |
If type string matches "NO" then the icalvalue_kind will be taken from an existing icalvalue (if one exists) or will use the default icalvalue_kind for the icalproperty.
If prop already has an icalvalue it will be replaced.
Definition at line 781 of file icalproperty.c.
| void icalproperty_set_x_name | ( | icalproperty * | prop, |
| const char * | name ) |
Sets the X-NAME property of the specified icalproperty.
| prop | a pointer to a valid icalproperty |
| name | a pointer to a char string to use as the X-NAME |
Definition at line 849 of file icalproperty.c.
| const char * icalproperty_status_to_string | ( | icalproperty_status | status | ) |
Converts an icalproperty_status to its string representation.
| status | is the icalproperty_status to use |
| icalproperty_action icalproperty_string_to_action | ( | const char * | string | ) |
Converts a char string into an icalproperty_action.
| string | a pointer to a char string containing the character representation of an icalproperty_action |
string. ICAL_ACTION_NONE is returned if string is invalid. | icalproperty_class icalproperty_string_to_class | ( | const char * | string | ) |
Converts a char string into an icalproperty_class.
| string | a pointer to a char string containing the character representati on of an icalproperty_class_ |
string. ICAL_CLASS_NONE is returned if string is invalid. | icalproperty_kind icalproperty_string_to_kind | ( | const char * | string | ) |
Converts a char string into an icalproperty_kind.
| string | a pointer to a char string containing the character representati on of an icalproperty_kind |
string. ICAL_NO_PROPERTY is returned if string is invalid. | icalproperty_method icalproperty_string_to_method | ( | const char * | str | ) |
Converts a char string into an icalproperty_method.
| str | a pointer to a char string containing the character representati on of an icalproperty_method |
string. ICAL_METHOD_NONE is returned if str is invalid. | icalproperty_participanttype icalproperty_string_to_participanttype | ( | const char * | string | ) |
Converts a char string into an icalproperty_participanttype.
| string | a pointer to a char string containing the character representation of an icalproperty_participanttype |
string. ICAL_PARTICIPANTTYPE_NONE is returned if string is invalid. | icalproperty_resourcetype icalproperty_string_to_resourcetype | ( | const char * | string | ) |
Converts a char string into an icalproperty_resourcetype.
| string | a pointer to a char string containing the character representation of an icalproperty_resourcetype |
string. ICAL_RESOURCETYPE_NONE is returned if string is invalid. | icalproperty_status icalproperty_string_to_status | ( | const char * | string | ) |
Converts a char string into an icalproperty_status.
| string | a pointer to a char string containing the character representation of an icalproperty_status |
string. ICAL_STATUS_NONE is returned if string is invalid. | icalproperty_transp icalproperty_string_to_transp | ( | const char * | string | ) |
Converts a char string into an icalproperty_transp.
| string | a pointer to a char string containing the character representation of an icalproperty_transp |
string. ICAL_TRANSP_NONE is returned if string is invalid. | const char * icalproperty_transp_to_string | ( | icalproperty_transp | transp | ) |
Converts an icalproperty_transp to its string representation.
| transp | is the icalproperty_transp to use |
| icalproperty_kind icalproperty_value_kind_to_kind | ( | icalvalue_kind | kind | ) |
Converts an icalvalue_kind to an icalproperty_kind.
| kind | is the icalvalue_kind to use |
kind; returns ICAL_NO_PROPERTY if kind is invalid. | icalproperty * icalvalue_get_parent | ( | const icalvalue * | value | ) |
Gets the parent icalproperty of the specified icalvalue.
| value | a pointer to the icalvalue |
icalproperty for the specified icalvalue. Definition at line 1548 of file icalvalue.c.
| void icalvalue_set_parent | ( | icalvalue * | value, |
| icalproperty * | property ) |
Sets the parent icalproperty for the specified icalvalue.
| value | a pointer to a valid icalvalue |
| property | a pointer to a presumably valid icalproperty to use |
Definition at line 1541 of file icalvalue.c.