insertElement

Syntax: bool insertElement( cFibElement *fibElement,
const char cType='u',
const unsignedIntFib elementPoint=0,
bool bAbsolute=false )

Diese Methode fügt das übergebene Fib-Element an der Stelle des Fib-Elements vom angegeben Typ cType ein, welches das elementPoint'te Fib-Element vom Typ cType ist. Das Fib-Element, welches vorher an der Position stand, wird in das übergebene Fib-Element eingefügt. Das einzufügende Fib-Element darf weder ein Fib-Element enthalten noch in einem enthalten sein.

Das Einfügen des Fib-Elements schlägt fehl, wenn dadurch ein ungültiges Fib-Objekt entstehen würde. Insbesondere müssen alle Variablen die im einzufügenden Fib-Element verwendet werden, an der Position, wo es eingefügt wird, definiert sein.

Alle Fib-Baum Blattelemente, wie Punktelemente, externe Objekte oder externe Unterobjekt, können nur mit dieser Methode in ein Fib-Element eingefügt werden, wenn elementPoint=0 und das im aktuellen Fib-Element enthaltende Unterobjekt NULL ist bzw. nicht existiert, da sie keine Unterobjekte enthalten und damit auch keine aufnehmen können. Sonst müssen sie mit der Methode insertObjectInElement eingefügt werden, da sie, wenn sie als Fib-Element korrekt sind, schon ein korrektes Fib-Objekt sind.

Listenelement können niemals mit der Methode eingefügt werden, da sie zwei Unterobjekt benötigen, aber nur eins zur Verfügung steht. Listenelement sind mit der Methode insertObjectInElement zu erzeugen.

Eingabeparameter:

• fibElement: Das einzufügende Fib-Element.
• cType: Der Typ des Fib-Elements, an wessen Stelle das übergebene Fib-Element eingefügt werden soll. Standardmäßig werden Fib-Elemente aller Typen betrachtet/ gezählt.
• elementPoint: Die Nummer des Fib-Elements, die es unter den Fib-Elementen vom cType haben soll. Standardmäßig wird diese mit $0$ belegt und damit das fibElement im aktuellem Fib-Element eingefügt (bei Verzweigungselement cFibBranch (siehe Abschnitt 39 auf Seite ) im ersten Teilobjekt).
• bAbsolute: Wenn bAbsolute gleich true (=wahr) ist, bezieht sich die Ordnung auf das gesamte Fib-Objekt. Ansonsten, wenn bAbsolute gleich false (=falsch) ist, bezieht sich Ordnung auf das Fib-Element, von dem aus die Methode aufgerufen wurde. Standardwert ist false.

Rückgabe: Wenn das Fib-Element eingefügt wurde, wird true (=wahr) zurückgegeben, sonst false (=falsch).