DcmList Class Reference

double-linked list class that maintains pointers to DcmObject instances. More...

Public Member Functions
	DcmList ()
	constructor
	~DcmList ()
	destructor
DcmObject *	append (DcmObject *obj)
	insert object at end of list More...
DcmObject *	prepend (DcmObject *obj)
	insert object at start of list More...
DcmObject *	insert (DcmObject *obj, E_ListPos pos=ELP_next)
	insert object relative to current position and indicator More...
DcmObject *	remove ()
	remove current entry from list, return element More...
DcmObject *	get (E_ListPos pos=ELP_atpos)
	get pointer to element in list at given position More...
DcmObject *	seek (E_ListPos pos=ELP_next)
	seek within element in list to given position (i.e. More...
DcmObject *	seek_to (unsigned long absolute_position)
	seek within element in list to given element index (i.e. More...
void	deleteAllElements ()
	Remove and delete all elements from list. More...
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

Detailed Description

double-linked list class that maintains pointers to DcmObject instances.

The remove operation does not delete the object pointed to, however, the destructor will delete all elements pointed to

Member Function Documentation

append()

DcmObject* DcmList::append

(

DcmObject *

obj

)

insert object at end of list

Parameters

obj	pointer to object

Returns

pointer to object

deleteAllElements()

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.

get()

DcmObject* DcmList::get

(

E_ListPos

pos = ELP_atpos

)

get pointer to element in list at given position

Parameters

pos	position indicator

Returns

pointer to object

insert()

DcmObject* DcmList::insert	(	DcmObject *	obj,
		E_ListPos	pos = ELP_next
	)

insert object relative to current position and indicator

Parameters

obj	pointer to object
pos	position indicator

Returns

pointer to object

prepend()

DcmObject* DcmList::prepend

(

DcmObject *

obj

)

insert object at start of list

Parameters

obj	pointer to object

Returns

pointer to object

remove()

DcmObject* DcmList::remove

(

)

remove current entry from list, return element

Returns

pointer to removed element, which is not deleted

seek()

DcmObject* DcmList::seek

(

E_ListPos

pos = ELP_next

)

seek within element in list to given position (i.e.

set current element to given position)

Parameters

pos	position indicator

Returns

pointer to new current object

seek_to()

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)

Parameters

absolute_position

position index < card()

Returns

pointer to new current object

---

The documentation for this class was generated from the following file:

• dcmdata/include/dcmtk/dcmdata/dclist.h