RealmList< T > Class Template Reference

Return type for a managed object property when you declare a to-many relationships with IList. More...

Inherits IList< T >, IRealmList, IDynamicMetaObjectProvider, and ICopyValuesFrom.

Public Member Functions
void	Add (T item)
	Makes a relationship to an item, appending it at the end of the sorted relationship. More...
void	Clear ()
	Breaks the relationship to all related items, without deleting the items. More...
bool	Contains (T item)
	Tests if an item exists in the related set. More...
void	CopyTo (T[] array, int arrayIndex)
	Copies all the elements to a portion of an array. More...
Enumerator	GetEnumerator ()
	Factory for an iterator to be called explicitly or used in a foreach loop. More...
int	IndexOf (T item)
	Finds an ordinal index for an item in a relationship. More...
void	Insert (int index, T item)
	Makes a relationship to an item, inserting at a specified location ahead of whatever else was in that location. More...
bool	Remove (T item)
	Breaks the relationship to the specified item, without deleting the item. More...
void	RemoveAt (int index)
	Breaks the relationship to the item at the ordinal index, without deleting the item. More...

Public Attributes
const int	ITEM_NOT_FOUND = -1
	Value returned by IndexOf if an item is not found. More...

Properties
int	Count [get]
	Returns the count of related items. More...
T	this[int index] [get, set]
	Returns the item at the ordinal index. More...

Detailed Description

Return type for a managed object property when you declare a to-many relationships with IList.

Relationships are ordered and preserve their order, hence the ability to use ordinal indexes in calls such as Insert and RemoveAt.

Although originally used in declarations, whilst that still compiles, it is not recommended as the IList approach both supports standalone objects and is implemented with a faster binding.

Template Parameters

T	Type of the RealmObject which is the target of the relationship.

Type Constraints

T

:

RealmObject

Member Function Documentation

void Add

(

T

item

)

Makes a relationship to an item, appending it at the end of the sorted relationship.

Parameters

item	RealmObject being added to the relationship.

Template Parameters

T	Type of the RealmObject which is the target of the relationship.

Referenced by RealmList< T >.RemoveAt().

void Clear

(

)

Breaks the relationship to all related items, without deleting the items.

bool Contains

(

T

item

)

Tests if an item exists in the related set.

Parameters

item	Object to be searched for in the related items.

Template Parameters

T	Type of the RealmObject which is the target of the relationship.

Returns

True if found, false if not found.

References RealmList< T >.IndexOf(), and RealmList< T >.ITEM_NOT_FOUND.

void CopyTo	(	T[]	array,
		int	arrayIndex
	)

Copies all the elements to a portion of an array.

Parameters

array	Preallocated destination into which we copy.
arrayIndex	Ordinal zero-based starting index of the destination of the related items being copied.

Exceptions

ArgumentNullException	Thrown if array is null.
ArgumentOutOfRangeException	Thrown if arrayIndex is less than 0.
ArgumentException	Thrown if there is not enough room in array from arrayIndex onward.

References RealmList< T >.Count.

Enumerator GetEnumerator

(

)

Factory for an iterator to be called explicitly or used in a foreach loop.

Returns

A RealmListEnumerator as the generic IEnumerator<T>.

Referenced by RealmList< T >.RemoveAt().

int IndexOf

(

T

item

)

Finds an ordinal index for an item in a relationship.

Parameters

item	RealmObject being removed from the relationship.

Template Parameters

T	Type of the RealmObject which is the target of the relationship.

Returns

0-based index if the item was found in the related set, or RealmList.ITEM_NOT_FOUND.

Referenced by RealmList< T >.Contains(), and RealmList< T >.Remove().

void Insert	(	int	index,
		T	item
	)

Makes a relationship to an item, inserting at a specified location ahead of whatever else was in that location.

Parameters

index	Ordinal zero-based index at which to insert the related items.
item	RealmObject being inserted into the relationship.

Template Parameters

T	Type of the RealmObject which is the target of the relationship.

Exceptions

IndexOutOfRangeException

When the index is out of range for the related items.

bool Remove

(

T

item

)

Breaks the relationship to the specified item, without deleting the item.

Parameters

item	RealmObject being removed from the relationship.

Template Parameters

T	Type of the RealmObject which is the target of the relationship.

Returns

True if the item was found and removed, false if it is not in the related set.

References RealmList< T >.IndexOf(), and RealmList< T >.RemoveAt().

void RemoveAt

(

int

index

)

Breaks the relationship to the item at the ordinal index, without deleting the item.

Parameters

index

Ordinal zero-based index of the related item.

Exceptions

IndexOutOfRangeException

When the index is out of range for the related items.

References RealmList< T >.Add(), and RealmList< T >.GetEnumerator().

Referenced by RealmList< T >.Remove().

Member Data Documentation

const int ITEM_NOT_FOUND = -1

Value returned by IndexOf if an item is not found.

Referenced by RealmList< T >.Contains().

Property Documentation

int Count

get

Returns the count of related items.

Returns

0 if there are no related items, including a "null" relationship never established, or the count of items.

Referenced by RealmList< T >.CopyTo().

T this[int index]

getset

Returns the item at the ordinal index.

Parameters

index

Ordinal zero-based index of the related items.

Template Parameters

T	Type of the RealmObject which is the target of the relationship.

Returns

A related item, if exception not thrown.

Exceptions

IndexOutOfRangeException

When the index is out of range for the related items.