build

abstract fun build(from: Event, main: Event, to: Entity)

Maps a specific part of the given event into the provided Entity.

If from references the same object as main, this method is called for a main event (not an exception). If from references another object as main, this method is called for an exception (not a main event).

So you can use (note the referential equality operator):

val buildsMainEvent = from === main

Note: The result of the mapping is used to either create or update the event row in the content provider. For updates, explicit null values are required for fields that should be null (otherwise the value wouldn't be updated to null in case of an event update). Sub-rows of the Entity will always be created anew, so there's no need to use null values in sub-rows.

Parameters

from

event to map

main

main event

to

destination object where built values are stored (set null values, see note)

Throws

on missing or invalid required properties (like DTSTART)