RealmList
RealmList is used to model one-to-many relationships in a RealmObject or EmbeddedRealmObject.
A RealmList has two modes: managed
and unmanaged
. In managed
mode all objects are persisted inside a Realm whereas in unmanaged
mode it works as a normal MutableList.
Only Realm can create managed RealmLists. Managed RealmLists will automatically update their content whenever the underlying Realm is updated. Said content can only be accessed using the getter of a RealmObject or EmbeddedRealmObject.
Unmanaged RealmLists can be created by the user and can contain both managed and unmanaged RealmObjects or EmbeddedRealmObjects. This is useful when dealing with JSON deserializers like Gson or other frameworks that inject values into a class. Unmanaged elements in a list can be added to a Realm using the MutableRealm.copyToRealm method.
Deleting a list through MutableRealm.delete or DynamicMutableRealm.delete will delete any referenced objects from the realm and clear the list.
Parameters
the type of elements contained in the RealmList.
Functions
Observes changes to the RealmList. The Flow will emit InitialList once subscribed, and then UpdatedList on every change to the list. The flow will continue running indefinitely until canceled or until the parent object is deleted.
Makes an unmanaged in-memory copy of the elements in a managed RealmList. This is a deep copy that will copy all referenced objects.
Query the objects in a list by filter
and arguments
.
Instantiates an unmanaged RealmDictionary containing all the elements of this iterable of Pairs of Strings and Ts.