Isom.Base.NumberList

 ISOM/L-Bibliothek für Serviceautoren: <br />Isom.Base.NumberList

ISOM/L-Bibliothek
für Serviceautoren

Version 9.10.1.0 vom 25 November 2013

Namensraum Isom.Base.NumberList

Beschreibung

Isom.Base.NumberList repräsentiert Listen von Zahlen (Isom.Base.Number).

Zu beachten:
Es gibt zwei Möglichkeiten, um auf die Elemente in der Liste zuzugreifen:
  • durch einen indizierten Zugriff mit der Funktion .At()
  • durch Durchlaufen der Liste mit den Funktionen .HasNext() und .Next(). Vor einem Durchlaufen sollte .Reset() aufgerufen werden.


Funktionen

Isom.Base.NumberList.At

Ruft eine durch einen Index gekennzeichnete Zahl aus der Liste ab.

objectbound Isom.Base.Number Isom.Base.NumberList.At  ( Isom.Base.Number  index  ) 

Ruft eine durch einen Index gekennzeichnete Zahl aus der Liste ab.

 NumberList list = NumberList.CreateNumberList(); 
 list.Insert(1111); 
 Number a = list.At(0);               //a ist 1111 
 Number 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:
Zahl 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.
Isom.Base.NumberList.Clone

Erzeugt eine identische Kopie dieses Objekts.

objectbound Isom.Base.NumberList Isom.Base.NumberList.Clone  (  ) 

Erzeugt eine identische Kopie dieses Objekts.

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

Rückgabe:
Kopie dieses Objekts.
Isom.Base.NumberList.Contains

Abfrage, ob ein Element in der Liste vorhanden ist.

objectbound Isom.Base.Boolean Isom.Base.NumberList.Contains  ( Isom.Base.Number  element  ) 

Abfrage, ob ein Element in der Liste vorhanden ist.

 NumberList list = NumberList.CreateNumberList(); 
 list.Insert(2);                                  //Füge 2 der Liste hinzu 
 Boolean result = list.Contains(2);               //result ist true 
 result = list.Contains(1);                       //result ist false 
Parameter:
element  Gesuchtes Element.
Rückgabe:
'true', falls das Element gefunden werden konnte, 'false' sonst.
Isom.Base.NumberList.CreateNumberList

Erzeugt eine neue, leere Zahlenliste.

Isom.Base.NumberList Isom.Base.NumberList.CreateNumberList  (  ) 

Erzeugt eine neue, leere Zahlenliste.

 NumberList list = NumberList.CreateNumberList(); 
Rückgabe:
Leere Liste.
Isom.Base.NumberList.Current

Liefert während dem Durchlaufen der Liste die aktuelle Zahl.

objectbound Isom.Base.Number Isom.Base.NumberList.Current  (  ) 

Liefert während dem Durchlaufen der Liste die aktuelle Zahl.

 NumberList list = ... 
 list.Reset();                        //Listendurchlauf vorbereiten 
 while (list.HasNext ())              //Prüfen, ob es ein nächstes Element gibt 
 { 
    list.Next();                        //Durchlauf weiterführen 
    Number current = 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.
Isom.Base.NumberList.HasNext

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

objectbound Isom.Base.Boolean Isom.Base.NumberList.HasNext  (  ) 

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

 NumberList list = ... 
 list.Reset();                        //Listendurchlauf vorbereiten 
 while (list.HasNext ())              //Prüfen, ob es ein nächstes Element gibt 
 { 
    Number current = list.Next();       //Element abrufen und Durchlauf weiterführen 
    ... 
 } 
Rückgabe:
'true', falls noch Zahlen in der Liste mit .Next() abgerufen werden können, 'false' sonst.
Isom.Base.NumberList.Insert

Fügt der Liste ein Element hinzu.

objectbound Isom.Base.Number Isom.Base.NumberList.Insert  ( Isom.Base.Number  element  ) 

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.

 NumberList list = NumberList.CreateNumberList(); 
 list.Insert(9); 
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 Zahl.
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.
Isom.Base.NumberList.IsEmpty

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

objectbound Isom.Base.Boolean Isom.Base.NumberList.IsEmpty  (  ) 

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

 NumberList list = NumberList.CreateNumberList(); 
 Boolean isEmpty = list.IsEmpty();    // isEmpty ist true 
 list.Insert(1); 
 isEmpty = list.IsEmpty();             // isEmpty ist false 
Rückgabe:
'true', falls die Liste leer ist, 'false' sonst.
Isom.Base.NumberList.IsVoid

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

objectbound Isom.Base.Boolean Isom.Base.NumberList.IsVoid  (  ) 

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

Rückgabe:
'true', falls dies das Void-Objekt ist, 'false' sonst.
Isom.Base.NumberList.Length

Liefert die Anzahl der Elemente in der Liste.

objectbound Isom.Base.Number Isom.Base.NumberList.Length  (  ) 

Liefert die Anzahl der Elemente in der Liste.

 NumberList list = NumberList.CreateNumberList(); 
 list.Insert(1); 
 list.Insert(2); 
 list.Insert(3); 
 list.Insert(4); 
 Number length = list.Length();       //length ist 4 
Rückgabe:
Anzahl der Elemente.
Isom.Base.NumberList.Next

Liefert beim Durchlaufen der Liste die nächste Zahl.

objectbound Isom.Base.Number Isom.Base.NumberList.Next  (  ) 

Liefert beim Durchlaufen der Liste die nächste Zahl.

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

 NumberList list = ... 
 list.Reset();                        //Listendurchlauf vorbereiten 
 while (list.HasNext ())              //Prüfen, ob es ein nächstes Element gibt 
 { 
    Number current = 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.
Isom.Base.NumberList.Remove

Entfernt ein durch einen Index gekennzeichnetes Element aus der Liste.

objectbound Isom.Base.Boolean Isom.Base.NumberList.Remove  ( Isom.Base.Number  index  ) 

Entfernt ein durch einen Index gekennzeichnetes Element aus der Liste.

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

 NumberList list = NumberList.CreateNumberList(); 
 Boolean result = list.Remove(0);       //result ist false 
 list.Insert(1); 
 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).
Isom.Base.NumberList.Reset

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

objectbound Isom.Base.Boolean Isom.Base.NumberList.Reset  (  ) 

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

 NumberList list = ... 
 list.Reset();                        //Listendurchlauf vorbereiten 
 while (list.HasNext ())              //Prüfen, ob es ein nächstes Element gibt 
 { 
    Number current = list.Next();       //Element abrufen und Durchlauf weiterführen 
    ... 
 } 
Rückgabe:
Immer 'true'.
Isom.Base.NumberList.Void

Erzeugt ein Void-Objekt.

Isom.Base.NumberList Isom.Base.NumberList.Void  (  ) 

Erzeugt ein Void-Objekt.

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

Rückgabe:
Void-Objekt

Version 9.10.1.0 vom 25 November 2013