next up previous contents index
Next: generateExternSubobjectsDefinitions Up: Schnittstellenbeschreibung Previous: getNumberOfExternSubobjects   Contents   Index


checkExternSubobjects

Syntax: unsignedIntFib checkExternSubobjects(
intFib *iErrorNumber=NULL )


Diese Methode prüft die Unterobjekte des root-Objekts.


Dabei wird geprüft:

  1. Ob alle Unterobjekte, die im Haupt-Fib-Objekt des root-Elements vorkommen, auch im root-Element definiert werden. Wenn nicht, wird die Nummer, welche das ersten fehlende Unterobjekt hat, zurückgegeben.
  2. Ob die Unterobjekte im Haupt-Fib-Objekt die gleiche Anzahl von Ausgabevariablen haben, wie in ihrer jeweiligen Definition im root-Element angegeben. Wenn nicht, wird die Nummer des ersten Unterobjekts, bei dem die Anzahl nicht übereinstimmt, zurückgegeben.
  3. Ob alle Unterobjekte, welche im root-Element definiert werden, auch im Haupt-Fib-Objekt verwendet werden. Wenn nicht, wird die Nummer des ersten Unterobjekts, welches nicht verwendet wird, zurückgegeben.

Wenn während der Prüfung ein Fehler festgestellt wird, wird die Prüfung unterbrochen und die Nummer des Unterobjekts (nicht die Nummer in der Ordnung der Fib-Elemente) zurückgegeben bei dem der Fehler auftrat.

Im Feld auf das iErrorNumber zeigt wird eine eventuelle Fehlernummer zurückgegeben. Wenn der Zeiger iErrorNumber gleich NULL ist, wird keine Fehlernummer zurückgegeben. Negative Fehlernummern deuten auf Fehler hin, die behoben werden müssen, und positive Fehlernummern auf Wahrnungen.

Mögliche Fehlernummern für iErrorNumber sind:

0
alles in Ordnung
-1
Es gibt kein Haupt-Fib-Objekt.
-10
Ein Unterobjekt, das im Haupt-Fib-Objekt des root-Elements vorkommt, wird nicht im root-Element definiert.
-11
Ein Unterobjekte im Haupt-Fib-Objekt hat nicht die gleiche Anzahl von Ausgabevariablen, wie in seiner Definition im root-Element angegeben.
-12
Es werden nicht alle Unterobjekte, welche im root-Element definiert sind, auch im Haupt-Fib-Objekt verwendet.
-13
Es gibt Lücken bei der Nummerierung der Unterobjekte oder die Nummerierung beginnt nicht bei $1$.


Eingabeparameter:


Rückgabe: Zurückgegeben wird die Nummer des ersten fehlerhaften Unterobjekts des root-Elements oder $0$, wenn alle Unterobjekte in Ordnung sind.


next up previous contents index
Next: generateExternSubobjectsDefinitions Up: Schnittstellenbeschreibung Previous: getNumberOfExternSubobjects   Contents   Index
Betti Österholz 2013-02-13