Public Member Functions | |
| DcmList () | |
| constructor | |
| ~DcmList () | |
| destructor | |
| DcmObject * | append (DcmObject *obj) |
| insert object at end of list | |
| DcmObject * | prepend (DcmObject *obj) |
| insert object at start of list | |
| DcmObject * | insert (DcmObject *obj, E_ListPos pos=ELP_next) |
| insert object relative to current position and indicator | |
| DcmObject * | remove () |
| remove current entry from list, return element | |
| DcmObject * | get (E_ListPos pos=ELP_atpos) |
| get pointer to element in list at given position | |
| DcmObject * | seek (E_ListPos pos=ELP_next) |
| seek within element in list to given position (i.e. | |
| DcmObject * | seek_to (unsigned long absolute_position) |
| seek within element in list to given element index (i.e. | |
| void | deleteAllElements () |
| Remove and delete all elements from list. | |
| unsigned long | card () const |
| return cardinality of list | |
| OFBool | empty (void) const |
| return true if list is empty, false otherwise | |
| OFBool | valid (void) const |
| return true if current node exists, false otherwise | |
Private Member Functions | |
| DcmList & | operator= (const DcmList &) |
| private undefined copy constructor | |
| DcmList (const DcmList &newList) | |
| private undefined copy assignment operator | |
Private Attributes | |
| DcmListNode * | firstNode |
| pointer to first node in list | |
| DcmListNode * | lastNode |
| pointer to last node in list | |
| DcmListNode * | currentNode |
| pointer to current node in list | |
| unsigned long | cardinality |
| number of elements in list | |
The remove operation does not delete the object pointed to, however, the destructor will delete all elements pointed to
Definition at line 105 of file dclist.h.
insert object at end of list
| obj | pointer to object |
insert object at start of list
| obj | pointer to object |
insert object relative to current position and indicator
| obj | pointer to object | |
| pos | position indicator |
| DcmObject* DcmList::remove | ( | ) |
remove current entry from list, return element
| DcmObject* DcmList::get | ( | E_ListPos | pos = ELP_atpos |
) |
get pointer to element in list at given position
| pos | position indicator |
| DcmObject* DcmList::seek | ( | E_ListPos | pos = ELP_next |
) |
seek within element in list to given position (i.e.
set current element to given position)
| pos | position indicator |
| DcmObject* DcmList::seek_to | ( | unsigned long | absolute_position | ) |
seek within element in list to given element index (i.e.
set current element to given index)
| absolute_position | position index < card() |
| void DcmList::deleteAllElements | ( | ) |
Remove and delete all elements from list.
Thus, the elements' memory is also freed by this operation. The list is empty after calling this function.