Top | ![]() |
![]() |
![]() |
![]() |
ECalComponentDateTime * | e_cal_component_datetime_new () |
ECalComponentDateTime * | e_cal_component_datetime_new_take () |
ECalComponentDateTime * | e_cal_component_datetime_copy () |
void | e_cal_component_datetime_free () |
void | e_cal_component_datetime_set () |
ICalTime * | e_cal_component_datetime_get_value () |
void | e_cal_component_datetime_set_value () |
void | e_cal_component_datetime_take_value () |
const gchar * | e_cal_component_datetime_get_tzid () |
void | e_cal_component_datetime_set_tzid () |
void | e_cal_component_datetime_take_tzid () |
ECalComponentDateTime * e_cal_component_datetime_new (const ICalTime *value
,const gchar *tzid
);
Creates a new ECalComponentDateTime instance, which holds
the value
and tzid
. The returned structure should be freed
with e_cal_component_datetime_free()
, when no longer needed.
value |
an ICalTime as a value. |
[not nullable] |
tzid |
timezone ID for the |
[nullable] |
Since: 3.34
ECalComponentDateTime * e_cal_component_datetime_new_take (ICalTime *value
,gchar *tzid
);
Creates a new ECalComponentDateTime instance, which holds
the value
and tzid
. It is similar to e_cal_component_datetime_new()
,
except this function assumes ownership of the value
and tzid
.
The returned structure should be freed with e_cal_component_datetime_free()
,
when no longer needed.
value |
an ICalTime as a value. |
[transfer full][not nullable] |
tzid |
timezone ID for the |
[transfer full][nullable] |
Since: 3.34
ECalComponentDateTime *
e_cal_component_datetime_copy (const ECalComponentDateTime *dt
);
Creates a new copy of dt
. The returned structure should be freed
with e_cal_component_datetime_free()
when no longer needed.
Since: 3.34
void
e_cal_component_datetime_free (gpointer dt
);
Free dt
, previously created by e_cal_component_datetime_new()
,
e_cal_component_datetime_new_take()
or e_cal_component_datetime_copy()
.
The function does nothing, if dt
is NULL
.
[skip]
Since: 3.34
void e_cal_component_datetime_set (ECalComponentDateTime *dt
,const ICalTime *value
,const gchar *tzid
);
Sets both value
and tzid
in one call. Use e_cal_component_datetime_set_value()
and e_cal_component_datetime_set_tzid()
to set them separately.
dt |
||
value |
an ICalTime as a value. |
[not nullable] |
tzid |
timezone ID for the |
[nullable] |
Since: 3.34
ICalTime *
e_cal_component_datetime_get_value (const ECalComponentDateTime *dt
);
Returns the value stored with the dt
. The object is owned by dt
and
it's valid until the dt
is freed or its value overwritten.
Since: 3.34
void e_cal_component_datetime_set_value (ECalComponentDateTime *dt
,const ICalTime *value
);
Sets the value
of the dt
. Any previously set value is freed.
Since: 3.34
void e_cal_component_datetime_take_value (ECalComponentDateTime *dt
,ICalTime *value
);
Sets the value
of the dt
and assumes ownership of the value
.
Any previously set value is freed.
Since: 3.34
const gchar *
e_cal_component_datetime_get_tzid (const ECalComponentDateTime *dt
);
Returns the TZID stored with the dt
. The string is owned by dt
and
it's valid until the dt
is freed or its TZID overwritten. It never
returns an empty string, it returns either set TZID parameter value
or NULL
, when none is set.
Since: 3.34
void e_cal_component_datetime_set_tzid (ECalComponentDateTime *dt
,const gchar *tzid
);
Sets the tzid
of the dt
. Any previously set TZID is freed.
An empty string or a NULL
as tzid
is treated as none TZID.
Since: 3.34
void e_cal_component_datetime_take_tzid (ECalComponentDateTime *dt
,gchar *tzid
);
Sets the tzid
of the dt
and assumes ownership of tzid
. Any previously
set TZID is freed. An empty string or a NULL
as tzid
is treated as none TZID.
Since: 3.34