Syntax: cFibElement * cutElement( const char cType='u',
const unsignedIntFib elementPoint=0,
bool bAbsolute=false )
Diese Methode entfernt das Fib-Element vom Typ cType
, welches die Nummer elementPoint
in der Ordnung der Fib-Element vom angegebenen Typ cType
hat, aus dem Fib-Objekt und gibt es zurück. An der Stelle des Fib-Elements steht nach der Operation, das Fib-Element (Unterobjekt), welches das entfernt Fib-Element enthalten hat. Es wird also das Fib-Element, das entfernt werden soll, durch das Fib-Element, welches es enthält, ersetzt und dann das entfernte Fib-Element zurückgegeben. Das Fib-Element kann nicht entfernt werden, wenn dadurch ein ungültiges Fib-Objekt entstehen würde.
Wenn das Fib-Element vom Typ cType
, mit der Nummer elementPoint
in der Ordnung der Fib-Element vom angegebenen Typ cType
, entfernt wurde, wird es bzw. ein Zeiger auf es zurückgegeben, sonst wird NULL
zurückgegeben. Sollte beispielsweise versucht werden ein Listenelement zu entfernen, schlägt die Operation fehl und es wird NULL
zurückgegeben, da Listenelemente mindestens zwei Unterobjekte haben, aber nur eins das Listenelement ersetzen könnte. Des weiteren können auch keine Fib-Elemente entfernt werden, welche Variablen definieren, die noch benötigt werden.
Eingabeparameter:
cType
: Der Typ des Fib-Elements, welches entfernt werden soll. Standardmäßig ('u') 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 Fib-Element im aktuellem Fib-Element ausgeschnitten.
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 vom angegebenen Typ cType
, welches die Nummer elementPoint
in der Ordnung der Fib-Element vom angegebenen Typ cType
hat, entfernt wurde, wird es bzw. ein Zeiger auf es zurückgegeben, sonst wird NULL
zurückgegeben.