util_split_at_instance


Description:


[ Version ( deprecated = true , deprecated_since = "3.38" , since = "3.16" ) ]
public Component? util_split_at_instance (Component icalcomp, Time rid, Time? master_dtstart)

Warning: util_split_at_instance is deprecated since 3.38.

Splits a recurring icalcomp into two at time rid.

Note:

Use util_split_at_instance_ex instead, with provided timezone resolve function.

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.

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

Returns:

the split icalcomp, or null.


Namespace: ECal
Package: libecal-2.0