Isom.Context.EcuList

 ISOM/L-Bibliothek für Serviceautoren: <br />Isom.Context.EcuList

ISOM/L-Bibliothek
für Serviceautoren

Version 9.10.1.0 vom 25 November 2013

Namensraum Isom.Context.EcuList

Beschreibung

Es gibt zwei Möglichkeiten, um auf die Elemente in der Liste zuzugreifen:

  • der indizierte Zugriff mit der Funktion At()
  • das Durchlaufen der Liste mit den Funktionen HasNext() und Next(). Vor dem Durchlaufen sollte Reset() aufgerufen werden.

Datum:
letzte Änderung am 20.07.2010


Funktionen

Isom.Context.EcuList.At

Gibt ein Listenelement zurück.

objectbound Isom.Context.Ecu Isom.Context.EcuList.At  ( Isom.Base.Number  index  ) 

Gibt ein Listenelement zurück.

Ruft das Element aus der Liste ab, das durch den (Null-basierten) Index ausgewählt wird.

Parameter:
index  Index.
Rückgabe:
Isom.Context.Ecu
Ausgewähltes Steuergerät.
Ausnahmebehandlung:
Es wird das Void-Objekt zurückgegeben, falls der Index kleiner als 0 oder größer gleich der Anzahl der Listenelemente ist.
Datum:
letzte Änderung am 20.07.2010
Isom.Context.EcuList.Clone

Erzeugt eine neue Liste, die die Elemente dieser Liste enthält.

objectbound Isom.Context.EcuList Isom.Context.EcuList.Clone  (  ) 

Erzeugt eine neue Liste, die die Elemente dieser Liste enthält.

Rückgabe:
Isom.Context.EcuList
Neue Liste, die die Elemente dieser Liste enthält.
Datum:
letzte Änderung am 20.07.2010
Isom.Context.EcuList.Contains

Prüft, ob ein Element in der Liste vorhanden ist.

objectbound Isom.Base.Boolean Isom.Context.EcuList.Contains  ( Isom.Context.Ecu  element  ) 

Prüft, ob ein Element in der Liste vorhanden ist.

Parameter:
element  Gesuchtes Element.
Rückgabe:
Isom.Base.Boolean
'true', falls das Element gefunden werden konnte, 'false' sonst.
Datum:
letzte Änderung am 20.07.2010
Isom.Context.EcuList.CreateNew

Erzeugt eine neue, leere Steuergeräteliste.

Isom.Context.EcuList Isom.Context.EcuList.CreateNew  (  ) 

Erzeugt eine neue, leere Steuergeräteliste.

Rückgabe:
Isom.Context.EcuList
neue, leere Liste.
Datum:
letzte Änderung am 20.07.2010
Isom.Context.EcuList.Current

Liefert das Listenelement an der aktuellen Position des Iterators.

objectbound Isom.Context.Ecu Isom.Context.EcuList.Current  (  ) 

Liefert das Listenelement an der aktuellen Position des Iterators.

Zu beachten:
Diese Funktion sollte nur beim Iterieren über die Liste verwendet werden.
Rückgabe:
Isom.Context.Ecu
Aktuelles Element der Liste.
Ausnahmebehandlung:
Es wird das Void-Objekt zurückgegeben, falls der Iterator zurückgesetzt wurde.
Datum:
letzte Änderung am 20.07.2010
Isom.Context.EcuList.Filter

Filtert die aktuelle Liste mit der als Parameter übergebenen Liste.

objectbound Isom.Context.EcuList Isom.Context.EcuList.Filter  ( Isom.Context.EcuList  otherList  ) 

Filtert die aktuelle Liste mit der als Parameter übergebenen Liste.

Die Reihenfolge der aktuellen Liste bleibt erhalten. Die zurückgegebene Liste enthält alle Steuergeräte der aktuellen Liste außer denjenigen, die in der als Parameter übergebenen Liste nicht enthalten sind. Dabei gilt als Kriterium, dass alle fachlichen Eigenschaften, die in dem Steuergerät aus der aktuellen Liste gesetzt sind, in dem Steuergerät aus der als Parameter übergebenen Liste entweder die gleichen Werte haben oder nicht gesetzt sind. In dem Steuergerät aus der als Parameter übergebenen Liste dürfen zudem keine fachlichen Eigenschaften gesetzt sein, die in dem Steuergerät aus der aktuellen Liste nicht gesetzt sind.

   Isom.Context.CurrentVehicleContext currentContext = Isom.Context.CurrentVehicleContext.GetInstance(); 
   Isom.Context.EcuList ccEcuList = currentContext.GetEcus(); 
   Isom.Context.EcuList voEcuList = ccEcuList.Filter(currentContext.GetVehicleConfigurationEcus()); 
   // Erstellen der Filterliste 
   EcuList otherList = EcuList.CreateNew(); 

   // Erstellen und einfügen der Steuergeräte 
   Ecu pattern1 = Ecu.CreateNewByAddress("33"); 
   pattern1.SetProp("BaseVariant", "EMOTORHR"); 

   Ecu pattern2 = Ecu.CreateNewByAddress("150"); 
   pattern2.SetProp("BaseVariant", "EMOTORHL"); 

   Ecu pattern3 = Ecu.CreateNewByAddress("278"); 
   pattern3.SetProp("BaseVariant", "EMOTORVR"); 

   Ecu pattern4 = Ecu.CreateNewByAddress("389"); 
   pattern4.SetProp("BaseVariant", "EMOTORVL"); 

   otherList.Insert(pattern1); 
   otherList.Insert(pattern2); 
   otherList.Insert(pattern3); 
   otherList.Insert(pattern4); 

   //Filtern der Liste 'ccEcuList' mit der Liste 'otherList' 
   ccEcuList.Filter(otherList); 
Parameter:
otherList  Liste, mit der die aktuelle Liste gefiltert werden soll.
Rückgabe:
Isom.Context.EcuList
Gefilterte Liste.
Datum:
letzte Änderung am 20.07.2010
Isom.Context.EcuList.FilterByBaseVariant

Sucht alle Steuergeräte mit dem angegebenen Basisvariantennamen in der Liste.

objectbound Isom.Context.EcuList Isom.Context.EcuList.FilterByBaseVariant  ( Isom.Base.String  baseVariantName  ) 

Sucht alle Steuergeräte mit dem angegebenen Basisvariantennamen in der Liste.

Die durchsuchte Liste selbst bleibt unverändert.

   Isom.Context.EcuList ecuList = Isom.Context.EcuList.CreateNew(); 

   //Befüllen der Liste 'ecuList' 

   Isom.Context.EcuList baseVariants = ecuList.FilterByBaseVariant("MOTOR"); 
Parameter:
baseVariantName  Basisvariantenname
Rückgabe:
Isom.Context.EcuList
Liste aller gefundenen Elemente.
Ausnahmebehandlung:
Es wird das Void-Objekt zurückgegeben, falls der übergebene 'baseVariantName' Void ist.
Siehe auch:
Isom.Context.Ecu.GetBaseVariant().
Datum:
letzte Änderung am 20.07.2010
Isom.Context.EcuList.FilterByEcuAddress

Sucht alle Steuergeräte mit der angegebenen Diagnoseadresse in der Liste.

objectbound Isom.Context.EcuList Isom.Context.EcuList.FilterByEcuAddress  ( Isom.Base.String  ecuAddress  ) 

Sucht alle Steuergeräte mit der angegebenen Diagnoseadresse in der Liste.

Die durchsuchte Liste selbst bleibt unverändert.

   Isom.Context.EcuList ecuList = Isom.Context.EcuList.CreateNew(); 

   //Befüllen der Liste 'ecuList' 

   Isom.Context.EcuList filtered = ecuList.FilterByEcuAddress("64"); 
Parameter:
ecuAddress  Diagnoseadresse
Rückgabe:
Isom.Context.EcuList
Liste aller gefundenen Elemente.
Ausnahmebehandlung:
Es wird das Void-Objekt zurückgegeben, falls die übergebene 'ecuAddress' Void ist.
Siehe auch:
Isom.Context.Ecu.GetEcuAddress().
Datum:
letzte Änderung am 20.07.2010
Isom.Context.EcuList.FilterByGroupName

Sucht alle Steuergeräte mit dem angegebenen Diagnosegruppendateinamen in der Liste.

objectbound Isom.Context.EcuList Isom.Context.EcuList.FilterByGroupName  ( Isom.Base.String  diagGroup  ) 

Sucht alle Steuergeräte mit dem angegebenen Diagnosegruppendateinamen in der Liste.

Die durchsuchte Liste selbst bleibt unverändert.

   Isom.Context.EcuList ecuList = Isom.Context.EcuList.CreateNew(); 

   //Befüllen der Liste 'ecuList' 

   Isom.Context.EcuList filteredList = ecuList.FilterByGroupName("MOTOR"); 
Parameter:
diagGroup  Diagnosegruppendateiname
Rückgabe:
Isom.Context.EcuList
Liste aller gefundenen Elemente.
Ausnahmebehandlung:
Es wird das Void-Objekt zurückgegeben, falls die übergebene 'diagGroup' Void ist.
Siehe auch:
Isom.Context.Ecu.GetGroupName().
Datum:
letzte Änderung am 20.07.2010
Isom.Context.EcuList.FilterByState

Sucht alle Steuergeräte, die sich im angegebenen Zustand befinden.

objectbound Isom.Context.EcuList Isom.Context.EcuList.FilterByState  ( Isom.Base.String  testState  ) 

Sucht alle Steuergeräte, die sich im angegebenen Zustand befinden.

Die durchsuchte Liste selbst bleibt unverändert.

   Isom.Context.EcuList ecuList = Isom.Context.EcuList.CreateNew(); 

   //Befüllen der Liste 'ecuList' 

   Isom.Context.EcuList filteredList = ecuList.FilterByState("Isom.Logistics.NotAccepted"); 
Parameter:
testState  vollqualifizierter Zustandsname.
Rückgabe:
Isom.Context.EcuList
Liste aller gefundenen Elemente.
Ausnahmebehandlung:
Es wird das Void-Objekt zurückgegeben, falls das übergebene 'testState' Void ist.
Siehe auch:
Isom.Context.Ecu.IsInState().
Datum:
letzte Änderung am 20.07.2010
Isom.Context.EcuList.FindByBaseVariant

Sucht das eindeutige Steuergerät mit dem angegebenen Basisvariantennamen in der Liste.

objectbound Isom.Context.Ecu Isom.Context.EcuList.FindByBaseVariant  ( Isom.Base.String  baseVariantName  ) 

Sucht das eindeutige Steuergerät mit dem angegebenen Basisvariantennamen in der Liste.

Die durchsuchte Liste selbst bleibt unverändert.

   Isom.Context.EcuList ecuList = Isom.Context.EcuList.CreateNew(); 

   //Befüllen der Liste 'ecuList' 

   Isom.Context.Ecu ecu = ecuList.FindByBaseVariant("MOTOR"); 
Parameter:
baseVariantName  Basisvariantenname
Rückgabe:
Isom.Context.Ecu
Gefundenes Steuergerät.
Ausnahmebehandlung:
Es wird das Void-Objekt zurückgegeben, falls die übergebene 'baseVariantName' Void ist.
Es wird das Void-Objekt zurückgegeben, falls mehr als ein oder weniger als ein Element gefunden wurde.
Siehe auch:
Isom.Context.Ecu.GetBaseVariant().
Datum:
letzte Änderung am 20.07.2010
Isom.Context.EcuList.FindByEcuAddress

Sucht das eindeutige Steuergerät mit der angegebenen Diagnoseadresse in der Liste und gibt es zurück.

objectbound Isom.Context.Ecu Isom.Context.EcuList.FindByEcuAddress  ( Isom.Base.String  ecuAddress  ) 

Sucht das eindeutige Steuergerät mit der angegebenen Diagnoseadresse in der Liste und gibt es zurück.

   Isom.Context.EcuList ecuList = Isom.Context.EcuList.CreateNew(); 

   //Befüllen der Liste 'ecuList' 

   Isom.Context.Ecu ecu = ecuList.FindByEcuAddress("64"); 
Parameter:
ecuAddress  Diagnoseadresse
Rückgabe:
Isom.Context.Ecu
Gefundenes Steuergerät.
Ausnahmebehandlung:
Es wird das Void-Objekt zurückgegeben, falls die übergebene 'ecuAddress' Void ist.
Es wird das Void-Objekt zurückgegeben, falls mehr als ein oder weniger als ein Element gefunden wurde.
Siehe auch:
Isom.Context.Ecu.GetEcuAddress().
Datum:
letzte Änderung am 20.07.2010
Isom.Context.EcuList.FindByGroupName

Sucht das eindeutige Steuergerät mit der angegebenen Diagnosegruppendatei in der Liste.

objectbound Isom.Context.Ecu Isom.Context.EcuList.FindByGroupName  ( Isom.Base.String  diagGroup  ) 

Sucht das eindeutige Steuergerät mit der angegebenen Diagnosegruppendatei in der Liste.

Die durchsuchte Liste selbst bleibt unverändert.

   Isom.Context.EcuList ecuList = Isom.Context.EcuList.CreateNew(); 

   //Befüllen der Liste 'ecuList' 

   Isom.Context.Ecu ecu = ecuList.FindByGroupName("MOTOR"); 
Parameter:
diagGroup  Diagnosegruppendateiname
Rückgabe:
Isom.Context.Ecu
Gefundenes Steuergerät.
Ausnahmebehandlung:
Es wird das Void-Objekt zurückgegeben, falls die übergebene 'diagGroup' Void ist.
Es wird das Void-Objekt zurückgegeben, falls mehr als ein oder weniger als ein Element gefunden wurde.
Siehe auch:
Isom.Context.Ecu.GetGroupName().
Datum:
letzte Änderung am 20.07.2010
Isom.Context.EcuList.HasNext

Gibt an, ob beim Iterieren über die Liste noch Werte abgerufen werden können.

objectbound Isom.Base.Boolean Isom.Context.EcuList.HasNext  (  ) 

Gibt an, ob beim Iterieren über die Liste noch Werte abgerufen werden können.

Rückgabe:
Isom.Base.Boolean
'true', falls noch Werte in der Liste zur Verfügung stehen, 'false' sonst.
Datum:
letzte Änderung am 20.07.2010
Isom.Context.EcuList.Insert

Fügt der Liste ein Element hinzu.

objectbound Isom.Base.Number Isom.Context.EcuList.Insert  ( Isom.Context.Ecu  element  ) 

Fügt der Liste ein Element hinzu.

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

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 Steuergerät.
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.
Datum:
letzte Änderung am 20.07.2010
Isom.Context.EcuList.IsEmpty

Gibt an, ob diese Liste leer ist.

objectbound Isom.Base.Boolean Isom.Context.EcuList.IsEmpty  (  ) 

Gibt an, ob diese Liste leer ist.

Rückgabe:
Isom.Base.Boolean
'true', falls die Liste leer ist, 'false' sonst.
Datum:
letzte Änderung am 20.07.2010
Isom.Context.EcuList.IsVoid

Bestimmt, ob die Aufrufinstanz das Void-Objekt ist.

objectbound Isom.Base.Boolean Isom.Context.EcuList.IsVoid  (  ) 

Bestimmt, ob die Aufrufinstanz das Void-Objekt ist.

Das Void-Objekt kann z. B. bei Funktionsaufrufen geliefert werden, um einen Fehler anzuzeigen.

Rückgabe:
Isom.Base.Boolean
'true', falls dies das Void-Objekt ist, 'false' sonst.
Datum:
letzte Änderung am 20.07.2010
Isom.Context.EcuList.Length

Liefert die Anzahl der Elemente in der Liste.

objectbound Isom.Base.Number Isom.Context.EcuList.Length  (  ) 

Liefert die Anzahl der Elemente in der Liste.

Rückgabe:
Isom.Base.Number
Anzahl der Elemente.
Datum:
letzte Änderung am 20.07.2010
Isom.Context.EcuList.Next

Liefert das nächste Steuergerät in der Liste.

objectbound Isom.Context.Ecu Isom.Context.EcuList.Next  (  ) 

Liefert das nächste Steuergerät in der Liste.

Diese Funktion setzt den Iterator der Liste auf das nächste Element und gibt dieses Element zurück.

Zu beachten:
Diese Funktion sollte zum Iterieren über die Liste verwendet werden.
Vor dem Iterieren sollte der Iterator mit Reset() zurückgesetzt werden.
Rückgabe:
Isom.Context.Ecu
Nächstes Element der Liste.
Ausnahmebehandlung:
Es wird das Void-Objekt zurückgegeben, falls keine weiteren Elemente in der Liste sind.
Datum:
letzte Änderung am 20.07.2010
Isom.Context.EcuList.Remove

Entfernt ein Element aus der Liste.

objectbound Isom.Base.Boolean Isom.Context.EcuList.Remove  ( Isom.Base.Number  index  ) 

Entfernt ein Element aus der Liste.

Entfernt das durch den Index gekennzeichnete Element aus der Liste. Ein eventuell aktiver Iterator wird durch diese Operation zurückgesetzt.

Parameter:
index  Index.
Rückgabe:
Isom.Base.Boolean
'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).
Datum:
letzte Änderung am 20.07.2010
Isom.Context.EcuList.Reset

Setzt den Iterator zurück.

objectbound Isom.Base.Boolean Isom.Context.EcuList.Reset  (  ) 

Setzt den Iterator zurück.

Setzt den Iterator auf die Position vor dem ersten Element der Liste.

Rückgabe:
Isom.Base.Boolean
Immer 'true'.
Datum:
letzte Änderung am 20.07.2010
Isom.Context.EcuList.Void

Erzeugt ein Void-Objekt.

Isom.Context.EcuList Isom.Context.EcuList.Void  (  ) 

Erzeugt ein Void-Objekt.

Die Funktion kann in Fehlerfällen verwendet werden, um z.B. einen ungültigen Funktionsrückgabewert zu erzeugen.

Rückgabe:
Isom.Context.EcuList
Die Funktion liefert immer ein Void-Objekt.
Ausnahmebehandlung:
Void wird von dieser Funktion immer geliefert.
Datum:
letzte Änderung am 19.07.2010

Version 9.10.1.0 vom 25 November 2013