IniFile
|
Eine Void-Pointer Listen. Mehr ...
#include <PtlVDVList.h>
Öffentliche Methoden | |
VDVList (ListMode eMode=DEFAULT) | |
virtual | ~VDVList () |
VDVList (const VDVList &rList) | |
virtual int | addElementFrom (const VDVList &rList) |
virtual void * | get (ElementPosition eElementPos=FIRST_POS) override |
int | get (void *&prRetVal, std::size_t nPosition, SeekMode eMode) |
int | get (void *&prRetVal, std::size_t nPosition, DVElement *pRefElement) |
virtual int | insert (void *pDataObject, InsertPosition eWhere=InsertLAST, VH eBeforeBehind=BEHIND) override |
int | remove (ElementPosition eElementPos=CURRENT_POS) |
virtual void | removeAll () override |
int | currentElementCache (ElementCache eWhich) |
int | setCurrentPosition (void *pDataObject) |
VDVList & | operator= (const VDVList &rList) |
Öffentliche Methoden geerbt von ptl::AVDVList | |
AVDVList (ListMode eMode=DEFAULT) | |
virtual | ~AVDVList () |
AVDVList (const AVDVList &rList) | |
std::size_t | getSize () |
std::size_t | getNumberDataObjects (void *pDataObject) |
int | getErrorCode () |
ListMode | getListMode () |
AVDVList & | operator= (const AVDVList &rList) |
Geschützte Attribute | |
DVElement * | m_pCurrentDVElement |
DVElement * | m_pTempCurrentDVElement |
Geschützte Attribute geerbt von ptl::AVDVList | |
ListMode | m_eListMode |
int | m_iErrorCode |
DVElement * | m_pFirstDVElement |
DVElement * | m_pLastDVElement |
std::size_t | m_nSize |
Weitere Geerbte Elemente | |
Geschützte Methoden geerbt von ptl::AVDVList | |
virtual int | _addElementFrom (const AVDVList &rList) |
DVElement * | insertSrc (void *pDataObject, DVElement *pReferenceDVElement, VH eBeforeBehind) |
DVElement * | removeSrc (DVElement *pDeadDVElement) |
Eine Void-Pointer Listen.
Eine VDVList besteht aus Listen-Elementen des Typs DVElement, welchen Pointer auf die zu verwaltenden Objekte haben. Es können das erste, letzte und aktuelle Element erfragt werden. Zusätzlich kann nach einem nachfolgenden, bzw. vorherigen Element (bezüglich dem aktuellen Element) selektiert werden.
Ein Element kann vor oder hinter dem ersten, letzten und aktuellen Element eingefügt werden. Dieses kann durch Einstellung einer UNIQUE Liste in der Weise eingeschränkt werden, daß Objekte nur einmalig in der Liste vorkommen dürfen.
Konstruktor mit optionaler Parameterübergabe. Die Liste ist erst einmal leer. Es kann mit dem Parameter UNIQUE eine Liste erstellt werden, welche ein Datenobjekt nur einmal aufnimmt.
[in] | eMode | Der Listenmodus |
|
virtual |
Destruktor.
Copy-Konstruktor.
[in] | rList | Die zu kopierende VDVList. |
eut::ErrorNException | Bei einem Fehler wird eine Exception geworfen. |
Kopiert alle Listenelemente vom Typ DVElement von rList zu dieser Liste hinzu. Wird auch von VDVList::operator= genutzt.
[in] | rList | Die Liste, aus der die Objekte übernommen werden. |
int ptl::VDVList::currentElementCache | ( | ElementCache | eWhich | ) |
Diese Methode ermöglicht das Zwischenspeichern oder Restaurieren des aktuellen Zeigers.
[in] | eWhich | Gibt an, ob der Zeiger auf das aktuelle Element zwischengespeichert (M) oder restauriert (RM) wird. |
|
overridevirtual |
Liefert einen rohen Zeiger auf die Daten aus der im Parameter angegebenen Position.
Wenn ein Element geliefert wurde, wird dieses zum aktuellen Element, ansonsten bleibt das aktuelle Element das was es war.
[in] | eElementPos | Welche Daten sollen geliefert werden? Mögliche Werte sind FIRST_POS, LAST_POS, CURRENT_POS, NEXT_POS oder PREVIOUS_POS. |
Erneute Implementation von ptl::AVDVList.
Liefert einen rohen Zeiger auf ein Objekt in prRetVal aus übergebener Position in Bezug auf übergebenen Zeiger auf ein Element.
[in,out] | prRetVal | Im übergebenen rohen Pointer wird ein gefundenes Objekt geliefert. |
[in] | nPosition | Die Position rellativ zum übergebenen pRefElement |
[in] | pRefElement | Das Referenzelement |
Liefert einen rohen Zeiger auf ein Objekt in prRetVal aus der Liste in Bezug auf die Übergabe-Parameter.
Mit dieser Methode kann durch die Liste iteriert werden.
[in,out] | prRetVal | Im übergebenen Zeiger wird ein gefundenes Objekt geliefert. |
[in] | nPosition | Die Position rellativ zum Suchmodus. |
[in] | eMode | Der Suchmodus. |
Parameterbeispiele:
|
overridevirtual |
Diese Methode fügt den rohen Zeiger auf ein Datenobjekt in die Liste ein. Das aktuelle Element wird auf das neue Element gesetzt.
Sollte die Liste mit Parameter UNIQUE instanziiert worden sein und das Datenobjekt schon in der Liste sein, wird es nicht eingefügt.
[in] | pDataObject | Ist der rohe Zeiger auf das Datenobjekt. |
[in] | eWhere | Zeigt an, wohin das Datenobjekt in die Liste eingefügt werden soll. Mögliche Parameter sind InsertHEAD, InsertLAST und InsertCURRENT . |
[in] | eBeforeBehind | Gibt an, ob das neue Element vor oder hinter das, im Parameter eWhere angegebene Element, gesetzt wird. Mögliche Parameter sind BEFORE und BEHIND. |
Erneute Implementation von ptl::AVDVList.
Zuweisungsoperator=
Bei einer Zuweisung werden alle DVElement entfernt und dann alle Datenobjekte aus der zuweisenden VDVList in neue eigene DVElement übernommen.
[in] | rList | Die zuzuweisende Liste. |
Es sollte nach Aufruf getErrorCode() aufgerufen werden.
int ptl::VDVList::remove | ( | ElementPosition | eElementPos = CURRENT_POS | ) |
Entfernt das Element, welches als Parameter angegeben ist, aus der Liste.
Wenn ein nachfolgendes Element vorhanden ist, wird dieses zum aktuellen Element, ansonsten das vorherige Element, wenn dieses vorhanden ist.
Entfernt alle Elemente aus Liste.
Erneute Implementation von ptl::AVDVList.
|
protected |
Die Referenz auf das aktuelle Element in der Liste. Wenn die Liste leer ist, ist das aktuelle Element gleich NULL_PTR.
|
protected |
Dieses Attribut ist ein Zwischenspeicher des aktuellen Elements. Wird in der Methode currentElementCache (...) gesetzt.