Ruft ein durch einen Index gekennzeichnetes Datenobjekt aus der Liste ab.

 DataList list = DataList.CreateDataList(); 
 Data data = Create("A"); 
 list.Insert(data); 
 Data a = list.At(0);               //a ist das vorher hinzugefügte Datenobjekt 
 Data b = list.At(1);               //b ist das Void-Objekt 

Parameter:

index

Index des abgerufenen Elements in der Liste, beginnend bei 0 für das erste Element.

Rückgabe:

Datenobjekt mit dem übergebenen Index.

Ausnahmebehandlung:

Es wird das Void-Objekt zurückgegeben, falls der Index kleiner als 0 ist oder größer gleich der Anzahl der Listenelemente minus Eins.

Erzeugt eine identische Kopie dieses Objekts.

Dabei werden für alle enthaltenen Datenobjekte ebenso Kopien erzeugt.

Rückgabe:

Kopie dieses Objekts.

Abfrage, ob ein Element in der Liste vorhanden ist.

 DataList list = DataList.CreateDataList(); 
 Data data1 = Create("A"); 
 Data data2= Create("B"); 
 list.Insert(data1);                            //Füge data1 der Liste hinzu 
 Boolean result = list.Contains(data1);         //result ist true 
 result = list.Contains(data2);                 //result ist false 

Parameter:

element

Gesuchtes Element.

Rückgabe:

'true', falls das Element gefunden werden konnte, 'false' sonst.

Erzeugt eine neue, leere Liste.

 DataList list = DataList.CreateDataList(); 

Rückgabe:

Leere Liste.

Liefert während Durchlaufens der Liste das aktuelle Datenobjekt.

 DataList list = ... 
 list.Reset();                        //Listendurchlauf vorbereiten 
 while (list.HasNext ())              //Prüfen, ob es ein nächstes Element gibt 
 { 
    list.Next();                        //Durchlauf weiterführen 
    Data currentData = list.Current();  //Element abrufen 
    ... 
 } 

Rückgabe:

Aktuelles Element der Liste.

Ausnahmebehandlung:

Es wird das Void-Objekt zurückgegeben, falls der Durchlauf-Iterator vor das erste Element der Liste zeigt.

Prüft, ob es beim Durchlaufen der Liste mit .Next() Datenobjekte gibt, die noch nicht abgerufen wurden.

 DataList list = ... 
 list.Reset();                        //Listendurchlauf vorbereiten 
 while (list.HasNext ())              //Prüfen, ob es ein nächstes Element gibt 
 { 
    Data currentData = list.Next();     //Element abrufen und Durchlauf weiterführen 
    ... 
 } 

Rückgabe:

'true', falls noch Werte in der Liste mit .Next() abgerufen werden können, 'false' sonst.

Fügt der Liste ein Element hinzu.

Das Element wird an der letzten Position der Liste eingefügt. Ein eventuell aktiver Durchlauf-Iterator wird durch diese Operation zurückgesetzt.

 DataList list = DataList.CreateDataList(); 
 Data data = Create("A"); 
 list.Insert(data); 

Zu beachten:

Der zurückgegebene Index des eingefügten Elements ist nur gültig, solange kein Element an einer Position mit einem kleineren Index aus der Liste entfernt wird.

Parameter:

element

Hinzuzufügendes Datenobjekt.

Rückgabe:

Isom.Base.Number
Aktueller Index des eingefügten Elements in der Liste.

Ausnahmebehandlung:

Es wird das Void-Objekt zurückgegeben, falls das Element nicht hinzugefügt werden konnte.

Prüft, ob diese Liste leer ist oder nicht.

 DataList list = DataList.CreateDataList(); 
 Boolean isEmpty = list.IsEmpty();    // isEmpty ist true 
 Data data = Create("A"); 
 list.Insert(data); 
 isEmpty = list.IsEmpty();             // isEmpty ist false 

Rückgabe:

'true', falls die Liste leer ist, 'false' sonst.

Bestimmt, ob es sich um das Void-Objekt handelt.

Rückgabe:

'true', falls dies das Void-Objekt ist, 'false' sonst.

Liefert die Anzahl der Elemente der Liste.

 DataList list = DataList.CreateDataList(); 
 Data data = Create("A"); 
 list.Insert(data); 
 Number length = list.Length();    // length ist 1 

Rückgabe:

Anzahl der Elemente.

Liefert beim Durchlaufen der Liste das nächste Datenobjekt.

Ein Listendurchlauf wird mit .Reset() zurückgesetzt, um die Liste mit .Next() vom Listenanfang an durchlaufen zu können.

 DataList list = ... 
 list.Reset();                    //Listendurchlauf vorbereiten 
 while (list.HasNext ())          //Prüfen, ob es ein nächstes Element gibt 
 { 
    Data currentData = list.Next(); //Element abrufen und Durchlauf weiterführen 
    ... 
 } 

Rückgabe:

Nächstes Element der Liste.

Ausnahmebehandlung:

Es wird das Void-Objekt zurückgegeben, falls keine weiteren Elemente in der Liste sind.

Entfernt ein durch einen Index gekennzeichnetes Element aus der Liste.

Ein eventuell aktiver Durchlauf-Iterator, wird durch diese Operation zurückgesetzt.

 DataList list = DataList.CreateDataList(); 
 Boolean result = list.Remove(0);       //result ist false 
 Data data = Create("A"); 
 list.Insert(data); 
 result = list.Remove(0);               //result ist true 

Parameter:

index

Index des zu entfernenden Elements in der Liste, beginnend bei 0 für das erste Element.

Rückgabe:

'true', falls das Element entfernt werden konnte, 'false' sonst (z.B. wenn der Index das Void-Objekt ist oder außerhalb des zulässigen Bereichs liegt).

Setzt den Durchlauf-Iterator vor das erste Element der Liste, so ein neuer Durchlauf der Liste begonnen werden kann.

 DataList list = ... 
 list.Reset();                        //Listendurchlauf vorbereiten 
 while (list.HasNext ())              //Prüfen, ob es ein nächstes Element gibt 
 { 
    Data currentData = list.Next();     //Element abrufen und Durchlauf weiterführen 
    ... 
 } 

Rückgabe:

Immer 'true'.

Erzeugt ein Void-Objekt.

Das erzeugte Void-Objekt kann z. B. in Funktionen zurückgegeben werden, um einen Fehler anzuzeigen.

Rückgabe:

Void-Objekt