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