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 `tz_cb` callback

Returns:

the split icalcomp, or null.

Namespace: ECal

Package: libecal-2.0