util_split_at_instance_ex
Description:
[ Version ( since = "3.38" ) ]
public Component? util_split_at_instance_ex (Component icalcomp, Time rid, Time? master_dtstart, RecurResolveTimezoneCb tz_cb)
Splits a recurring icalcomp
into two at time rid
.
The returned Component is modified icalcomp
which contains
recurrences beginning at rid
, inclusive. The instance identified by rid
should exist. The master_dtstart
can be a null time, then it is read from the icalcomp
.
Uses tz_cb
with tz_cb_data
to resolve time zones when needed.
Use util_remove_instances_ex with E_CAL_OBJ_MOD_THIS_AND_FUTURE
mode on the icalcomp
to remove the overlapping interval from it, if needed.
Free the returned non-NULL component with unref, when done with it.
Parameters:
icalcomp |
A (recurring) Component |
rid |
The base RECURRENCE-ID to remove |
master_dtstart |
The DTSTART of the master object |
tz_cb |
The RecurResolveTimezoneCb to call |
tz_cb_data |
User data to be passed to the |
Returns:
the split |
Namespace: ECal
Package: libecal-2.0