this is a resizable array. More...

Public Types
typedef T	value_type
	the type of elements that this OFVector stores

typedef size_t	size_type
	the type used for sizes and indexes

typedef T *	iterator
	the type of mutable iterators on this object

typedef const T *	const_iterator
	the type of constant iterators on this object

typedef T &	reference
	the type of mutable references on this object

typedef const T &	const_reference
	the type of constant references on this object

Public Member Functions
	OFVector ()
	default constructor. More...

	OFVector (const OFVector &other)
	copy constructor. More...

	OFVector (size_type n, const T &v=T())
	construct an OFVector with predefined content. More...

	OFVector (const_iterator from, const_iterator to)
	construct an OFVector from a range of iterators. More...

	~OFVector ()
	destructor. More...

OFVector &	operator= (const OFVector &other)
	assignment operator. More...

void	swap (OFVector &other)
	swap this vector's content with some other vector. More...

iterator	begin ()
	get an iterator for the first element in this object. More...

const_iterator	begin () const
	get an iterator for the first element in this object. More...

iterator	end ()
	get an iterator that points past the last valid object. More...

const_iterator	end () const
	get an iterator that points past the last valid object. More...

size_type	size () const
	get the size of this OFVector. More...

OFBool	empty () const
	check wether this OFVector is empty. More...

void	clear ()
	clear this OFVector. More...

void	erase (iterator it)
	removes an entry from this OFVector. More...

iterator	insert (iterator it, const T &v)
	insert an entry in this OFVector. More...

template<class InputIterator >
void	insert (iterator it, InputIterator from, InputIterator to)
	insert a range of elements in this OFVector. More...

T &	front ()
	get a reference to the first element of this vector. More...

const T &	front () const
	get a reference to the first element of this vector. More...

T &	back ()
	get a reference to the last element of this vector. More...

const T &	back () const
	get a reference to the last element of this vector. More...

void	push_back (const T &v)
	insert an entry at the end of this object More...

void	pop_back ()
	remove the last entry in this object

T &	operator[] (size_type i)
	access an entry by index. More...

const T &	operator[] (size_type i) const
	access an entry by index. More...

T &	at (size_type i)
	access an entry by index. More...

const T &	at (size_type i) const
	access an entry by index. More...

void	resize (size_type n, T v=T())
	resize this OFVector. More...

void	reserve (size_type n)
	reserves enough space for the given number of elements. More...

Protected Attributes
T *	values_
	array that is used for storing the entries in this OFVector

size_type	allocated_
	the size for which values_ was allocated

size_type	size_
	the number of valid entries in values_. More...

Detailed Description

template<typename T>
class OFVector< T >

this is a resizable array.

You can add and remove elements after it was created and this class will handle all the memory management needed. This implements parts of std::vector's features.

Constructor & Destructor Documentation

template<typename T>

OFVector< T >::OFVector ( )

inline

default constructor.

This creates an empty OFVector.

template<typename T>

OFVector< T >::OFVector ( const OFVector< T > & other )

inline

copy constructor.

Parameters

other OFVector from which all elements are copied

template<typename T>

OFVector< T >::OFVector	(	size_type	n,
		const T &	v = `T()`
	)

inlineexplicit

construct an OFVector with predefined content.

Parameters

n	number of elements that this OFVector should have.
v	The value used for all elements.

template<typename T>

OFVector< T >::OFVector	(	const_iterator	from,
		const_iterator	to
	)

inline

construct an OFVector from a range of iterators.

Parameters

from	first iterator to include
to	first iterator that should not be included anymore

template<typename T>

OFVector< T >::~OFVector ( )

inline

destructor.

Frees all memory used by this object.

Member Function Documentation

template<typename T>

T& OFVector< T >::at ( size_type i )

inline

access an entry by index.

Parameters

i	index of the element to return

Returns: reference to the element.

template<typename T>

const T& OFVector< T >::at ( size_type i ) const

inline

access an entry by index.

Parameters

i	index of the element to return

Returns: reference to the element.

template<typename T>

T& OFVector< T >::back ( )

inline

get a reference to the last element of this vector.

Returns: reference to the last element.

template<typename T>

const T& OFVector< T >::back ( ) const

inline

get a reference to the last element of this vector.

Returns: reference to the last element.

template<typename T>

iterator OFVector< T >::begin ( )

inline

get an iterator for the first element in this object.

Returns: iterator that points to the first element.

Referenced by DSRListOfItems< DSRWaveformChannelItem >::addItems(), OFVector< SOPInstanceReferenceMacro * >::erase(), OFVector< SOPInstanceReferenceMacro * >::insert(), OFVector< SOPInstanceReferenceMacro * >::OFVector(), and OFVector< SOPInstanceReferenceMacro * >::operator=().

template<typename T>

const_iterator OFVector< T >::begin ( ) const

inline

get an iterator for the first element in this object.

Returns: iterator that points to the first element.

template<typename T>

void OFVector< T >::clear ( )

inline

clear this OFVector.

The existing content will be freed and all iterators become invalid.

Referenced by DSRListOfItems< DSRWaveformChannelItem >::getItems(), and OFVector< SOPInstanceReferenceMacro * >::operator=().

template<typename T>

OFBool OFVector< T >::empty ( void ) const

inline

check wether this OFVector is empty.

Returns: true if this OFVector is empty.

template<typename T>

iterator OFVector< T >::end ( )

inline

get an iterator that points past the last valid object.

Returns: iterator that points to the end of this OFVector.

Referenced by DSRListOfItems< DSRWaveformChannelItem >::addItems(), OFVector< SOPInstanceReferenceMacro * >::OFVector(), OFVector< SOPInstanceReferenceMacro * >::operator=(), OFVector< SOPInstanceReferenceMacro * >::pop_back(), and OFVector< SOPInstanceReferenceMacro * >::push_back().

template<typename T>

const_iterator OFVector< T >::end ( ) const

inline

get an iterator that points past the last valid object.

Returns: iterator that points to the end of this OFVector.

template<typename T>

void OFVector< T >::erase ( iterator it )

inline

removes an entry from this OFVector.

All iterators pointing to the element removed or elements that come behind it in this OFVector will become invalid.

Parameters

it	iterator for the entry that should be removed.

Referenced by OFVector< SOPInstanceReferenceMacro * >::pop_back().

template<typename T>

T& OFVector< T >::front ( )

inline

get a reference to the first element of this vector.

Returns: reference to the first element.

template<typename T>

const T& OFVector< T >::front ( ) const

inline

get a reference to the first element of this vector.

Returns: reference to the first element.

template<typename T>

iterator OFVector< T >::insert	(	iterator	it,
		const T &	v
	)

inline

insert an entry in this OFVector.

All iterators for this OFVector become invalid.

Parameters

it	the new element will be inserted in front of the element to which this iterator points.
v	the element to insert

Returns: iterator for the newly inserted element.

Referenced by OFVector< SOPInstanceReferenceMacro * >::insert(), and OFVector< SOPInstanceReferenceMacro * >::push_back().

template<typename T>

template<class InputIterator >

void OFVector< T >::insert	(	iterator	it,
		InputIterator	from,
		InputIterator	to
	)

inline

insert a range of elements in this OFVector.

All iterators for this OFVector become invalid.

Parameters

it	the new elements will be inserted in front of the element to which this iterator points.
from	iterator to the beginning of the range to insert.
to	iterator past the end of the range to insert.

template<typename T>

OFVector& OFVector< T >::operator= ( const OFVector< T > & other )

inline

assignment operator.

All elements from this object are removed and then a copy of other is made. All iterators to this object will become invalid.

Parameters

other OFVector instance to copy elements from.

template<typename T>

T& OFVector< T >::operator[] ( size_type i )

inline

access an entry by index.

undefined behavior occurs when the index is out of bounds (bigger than the maximum allowed index).

Parameters

i	index of the element to return

Returns: reference to the element.

template<typename T>

const T& OFVector< T >::operator[] ( size_type i ) const

inline

access an entry by index.

undefined behavior occurs when the index is out of bounds (bigger than the maximum allowed index).

Parameters

i	index of the element to return

Returns: reference to the element.

template<typename T>

void OFVector< T >::push_back ( const T & v )

inline

insert an entry at the end of this object

Parameters

v	the value to insert

Referenced by DSRListOfItems< DSRWaveformChannelItem >::getItems(), OFVector< SOPInstanceReferenceMacro * >::OFVector(), and OFVector< SOPInstanceReferenceMacro * >::operator=().

template<typename T>

void OFVector< T >::reserve ( size_type n )

inline

reserves enough space for the given number of elements.

from now on, no memory allocations will occur as long as this OFVector's size stays below n and clear() is not called.

Parameters

n	the number of elements for which space should be reserved.

Referenced by OFVector< SOPInstanceReferenceMacro * >::clear(), DSRListOfItems< DSRWaveformChannelItem >::getItems(), OFVector< SOPInstanceReferenceMacro * >::insert(), OFVector< SOPInstanceReferenceMacro * >::OFVector(), OFVector< SOPInstanceReferenceMacro * >::operator=(), and OFVector< SOPInstanceReferenceMacro * >::resize().

template<typename T>

void OFVector< T >::resize	(	size_type	n,
		T	v = `T()`
	)

inline

resize this OFVector.

after this call, size() will be n.

Parameters

n	the new size that this object should use
v	if any new elements need to be inserted, they get this value.

Referenced by OFVector< SOPInstanceReferenceMacro * >::OFVector().

template<typename T>

size_type OFVector< T >::size ( ) const

inline

get the size of this OFVector.

Returns: number of elements in this instance.

Referenced by OFVector< SOPInstanceReferenceMacro * >::OFVector(), and OFVector< SOPInstanceReferenceMacro * >::operator=().

template<typename T>

void OFVector< T >::swap ( OFVector< T > & other )

inline

swap this vector's content with some other vector.

All iterators will stay valid.

Parameters

other object to swap with

Member Data Documentation

template<typename T>

size_type OFVector< T >::size_

protected

the number of valid entries in values_.

elements past this index have undefined content.

Referenced by OFVector< SOPInstanceReferenceMacro * >::end(), OFVector< SOPInstanceReferenceMacro * >::erase(), OFVector< SOPInstanceReferenceMacro * >::reserve(), OFVector< SOPInstanceReferenceMacro * >::size(), and OFVector< SOPInstanceReferenceMacro * >::swap().

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

ofstd/include/dcmtk/ofstd/ofvector.h

Public Types

Public Member Functions

Protected Attributes

Detailed Description

template<typename T> class OFVector< T >

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation

template<typename T>
class OFVector< T >