Syntax: bool insertObjectInElement(
cFibElement * fibObject,
const char cType='u', unsignedIntFib elementPoint=0,
bool first=true, bool bAbsolute=false )
Diese Methode fügt das übergebene fibObject
unter dem Fib-Element an der angegeben Stelle ein. Das Fib-Element unter dem das Fib-Objekt fibObject
eingefügt wird, ist das elementPoint
'te Fib-Element vom angegebenen Typ cType
. In diesem Fib-Element wird ein neues Listenelement eingefügt. Wenn first=true
(wahr), wird das übergebene Fib-Objekt fibObject
als erstes Teilobjekt im Listenelement eingesetzt, sonst als zweite. Das andere Teilobjekt im neuem Listenelement ist das Objekt, welches durch das Listenelement ersetzt wurde bzw. das Objekt was ursprünglich im Fib-Element zu Position stand. Auf diese Weise enthält des Fib-Element nach der Operation sowohl das ursprünglich enthaltende Fib-Objekt wie auch das neue fibObject
.
Ist das Fib-Element an der angegeben Stelle schon Unterobjekt eines Listenelements, wird das fibObject
einfach in dieses Listelement eingefügt. Wobei es bei first=true
an der Stelle des Fib-Elements eingefügt wird und sonst (first=false
) im Listelement direkt hinter der Stelle des Fib-Elements.
Steht an der angegeben Stelle (elementPoint=0
) bisher kein Unterobjekt, wird das fibObject
als Unterobjekt eingefühgt, ohne ein weiteres Listenelement.
Zurückgegeben wird, ob die Operation erfolgreich war. Diese Operation ist beispielsweise niemals auf Punktelementen, als Fib-Element in denen das Fib-Objekt eingefügt werden soll, erfolgreich, da diese keine Fib-Objekte enthalten können.
Das übergebene fibObject
wird für das Einfügen nicht kopiert und darf daher nicht einfach gelöscht werden (z. B. mit delete fibObject
).
Im Bild 15 ist ein Beispielaufruf dargestellt.
Eingabeparameter:
fibObject
: Das Fib-Objekt, welches neu unter dem Fib-Element an der angegebenen Position eingefügt werden soll.
cType
: Der Typ des Fib-Elements unter dem das Fib-Objekt fibObject
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 belegt und damit das fibObject
im aktuellem Fib-Element eingefügt.
first
: Wenn first
gleich true
(=wahr) ist, wird das fibObject
als erstes Unterobjekt im (neuem) Listenelement eingesetzt, und damit die anderen Unterobjekte des Listenelements eventuell überdeckt. Sonst, wenn first
gleich false
(=falsch) ist, wird das fibObject
als letztes Unterobjekt im Listenelement eingesetzt, und damit eventuell selbst überdeckt werden.
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. Der Standardwert ist false
.
Rückgabe: Wenn das Fib-Objekt fibObject
eingefügt wurde wird true
(=wahr) zurückgegeben, sonst false
(=falsch).