Isom.Context.DtcList

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

ISOM/L-Bibliothek
für Serviceautoren

Version 9.10.1.0 vom 25 November 2013

Namensraum Isom.Context.DtcList

Beschreibung

Es wird eine Liste von Fehlerspeichereintragsobjekten des Typs Isom.Context.Dtc bereitgestellt.

Das Fachobjekt Isom.Context.DtcList bietet folgende Leistungsmerkmale:

  • die für ISOM-Listentypen üblichen Möglichkeiten zur Iteration mit HasNext() und Next()
  • fachliche Suchfunktionen für die sogenannte Hierarchischen Suche

Zu beachten:
Im Allgemeinen kann nicht von einer fachlichen Reihenfolge der Fehlerspeichereinträge in der Liste ausgegangen werden.
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.Context.DtcList.At

Ruft den Fehlerspeichereintrag innerhalb der Liste ab, welcher durch den Index ausgewählt wurde.

objectbound Isom.Context.Dtc Isom.Context.DtcList.At  ( Isom.Base.Number  index  ) 

Ruft den Fehlerspeichereintrag innerhalb der Liste ab, welcher durch den Index ausgewählt wurde.

Parameter:
index  Index.
Rückgabe:
Isom.Context.Dtc
Ausgewählter Fehlerspeichereintrag.
Ausnahmebehandlung:
Es wird das Void-Objekt zurückgegeben, falls der Index kleiner als 0 ist oder größer gleich der Anzahl der Listenelemente.
Isom.Context.DtcList.Clone

Erzeugt eine identische Kopie des Objekts.

objectbound Isom.Context.DtcList Isom.Context.DtcList.Clone  (  ) 

Erzeugt eine identische Kopie des Objekts.

Rückgabe:
Isom.Context.DtcList
Das geklonte Objekt vom Typ Isom.Context.DtcList.
Isom.Context.DtcList.Contains

Abfrage, ob ein bestimmtes Element in der Liste vorhanden ist.

objectbound Isom.Base.Boolean Isom.Context.DtcList.Contains  ( Isom.Context.Dtc  element  ) 

Abfrage, ob ein bestimmtes Element in der Liste vorhanden ist.

Parameter:
element  Gesuchtes Element.
Rückgabe:
Isom.Base.Boolean
'true', falls das Element gefunden werden konnte,
'false' sonst.
Isom.Context.DtcList.CreateNew

Erzeugt eine neue, leere Fehlerspeichereintragsliste zur temporären Speicherung

Isom.Context.DtcList Isom.Context.DtcList.CreateNew  (  ) 

Erzeugt eine neue, leere Fehlerspeichereintragsliste zur temporären Speicherung

Verwendungsbeispiel:
Rückgabe:
Isom.Context.DtcList
Das neu erzeugte Fehlerspeichereintragslisten-Objekt.
Isom.Context.DtcList.Current

Liefert das aktuelle Listenelement während der Iteration über die Liste.

objectbound Isom.Context.Dtc Isom.Context.DtcList.Current  (  ) 

Liefert das aktuelle Listenelement während der Iteration über die Liste.

Rückgabe:
Isom.Context.Dtc
Aktuelles Element der Liste.
Ausnahmebehandlung:
Es wird das Void-Objekt zurückgegeben, falls der Iterator zurückgesetzt wurde.
Isom.Context.DtcList.FilterByProp

Liefert eine Teilliste

objectbound Isom.Context.DtcList Isom.Context.DtcList.FilterByProp  ( Isom.Base.String  propName,
Isom.Base.String  propValue  )

Liefert eine Teilliste

Liefert eine Teilliste, in der sämtliche enthaltenen Fehlerspeichereinträge für die vorgegebene Eigenschaft propName mit dem vorgegebenen Wert propValue übereinstimmen, wobei semantische Begriffsbeziehungen (Unterbegriffe, Spezialisierungen) nicht berücksichtigt weden (keine Hierarchiesuche).

Verwendungsbeispiel:
  Isom.Context.DtcList all = Dtc.GetPossibleDtc(); 

  Isom.Context.DtcList stored =  all.FilterByProp( "IsStored", "true" ); 

  while( stored.HasNext() ) 
  { 
      Isom.Context.Dtc dtc = stored.Next(); 
      // dtc ist im SG permanent gespeichert 
  } 
Parameter:
propName  Name der zu vergleichenden Eigenschaft.
propValue  gesuchter Wert der zu vergleichenden Eigenschaft.
Rückgabe:
Isom.Context.DtcList
Neue Fehlerspeichereintragsliste entsprechend o.g. Filterkriterien.
Isom.Context.DtcList.GetEcus

Liefert die Steuergeräte-Fachobjekte, auf die sich einer der Fehlerocdes bezieht.

objectbound Isom.Context.EcuList Isom.Context.DtcList.GetEcus  (  ) 

Liefert die Steuergeräte-Fachobjekte, auf die sich einer der Fehlerocdes bezieht.

Die Ergebnisliste beinhaltet alle Steuergeräte, bei denen ein Fehlercode aus der Liste aufgetreten sind bzw. die für diesen Fehlercode in den Diagnoseservicedaten modelliert sind.

Rückgabe:
Isom.Context.EcuList
Liste assoziierter Steuergeräte-Fachobjekte.
Isom.Context.DtcList.HasNext

Liefert einen Wahrheitswert, der angibt, ob beim Iterieren über die Liste noch Werte abgerufen werden können.

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

Liefert einen Wahrheitswert, der angibt, 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.
Isom.Context.DtcList.Insert

Fügt der Liste ein Element hinzu.

objectbound Isom.Base.Number Isom.Context.DtcList.Insert  ( Isom.Context.Dtc  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.
Isom.Context.DtcList.IsEmpty

Liefert einen Wahrheitswert, der angibt, ob diese Liste leer ist oder nicht.

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

Liefert einen Wahrheitswert, der angibt, ob diese Liste leer ist oder nicht.

Rückgabe:
Isom.Base.Boolean
'true', falls die Liste leer ist,
'false' sonst.
Isom.Context.DtcList.IsVoid

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

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

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

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

Liefert die Anzahl der Elemente in der Liste.

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

Liefert die Anzahl der Elemente in der Liste.

Rückgabe:
Isom.Base.Number
Anzahl der Elemente.
Isom.Context.DtcList.Next

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

objectbound Isom.Context.Dtc Isom.Context.DtcList.Next  (  ) 

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

Diese Funktion sollte zum Iterieren über die Liste verwendet werden.

Rückgabe:
Isom.Context.Dtc
Nächstes Element der Liste.
Ausnahmebehandlung:
Es wird das Void-Objekt zurückgegeben, falls keine weiteren Elemente in der Liste sind.
Isom.Context.DtcList.Remove

Entfernt das durch den Index gekennzeichnete Element aus der Liste.

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

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).
Isom.Context.DtcList.Reset

Setzt den Iterator zurück, sodass er vor dem ersten Element der Liste steht.

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

Setzt den Iterator zurück, sodass er vor dem ersten Element der Liste steht.

Rückgabe:
Isom.Base.Boolean
Immer 'true'.
Isom.Context.DtcList.Void

Erzeugt ein ungültiges Objekt.

Isom.Context.DtcList Isom.Context.DtcList.Void  (  ) 

Erzeugt ein ungültiges Objekt.

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

Rückgabe:
Isom.Context.DtcList
Ungültiges Objekt vom Typ Isom.Context.DtcList.

Version 9.10.1.0 vom 25 November 2013