Detailed Description

template<typename Data>
class Util::GPArray< Data >

An automatically growable PArray.

An GPArray is a PArray that grows as needed as objects are appended. Like any PArray, it holds pointers to objects, rather than objects. The associated objects are not destroyed when a PArray is deallocated or destroyed.

Definition at line 28 of file GPArray.h.

#include <GPArray.h>

Inheritance diagram for Util::GPArray< Data >:

Public Member Functions
	GPArray ()
	Constructor. More...

	GPArray (const GPArray< Data > &other)
	Copy constructor, copy pointers. More...

GPArray< Data > &	operator= (const GPArray< Data > &other)
	Assignment, element by element. More...

virtual	~GPArray ()
	Destructor. More...

void	append (Data &data)
	Append an element to the end of the sequence. More...

void	reserve (int capacity)
	Reserve memory for specified number of elements. More...

void	deallocate ()
	Deallocate (delete) underlying array of pointers. More...

void	clear ()
	Reset to empty state. More...

bool	isAllocated () const
	Is this GPArray allocated? More...

Public Member Functions inherited from Util::PArray< Data >
virtual	~PArray ()
	Destructor. More...

int	capacity () const
	Return allocated size. More...

int	size () const
	Return logical size. More...

void	begin (PArrayIterator< Data > &iterator) const
	Set a PArrayIterator to the beginning of this PArray. More...

void	begin (ConstPArrayIterator< Data > &iterator) const
	Set a ConstPArrayIterator to the beginning of this PArray. More...

Data &	operator[] (int i) const
	Mimic C array subscripting. More...

Additional Inherited Members
Protected Member Functions inherited from Util::PArray< Data >
	PArray ()
	Constructor (protected to prevent instantiation). More...

Protected Attributes inherited from Util::PArray< Data >
Data **	ptrs_
	PArray of of pointers to Data objects. More...

int	capacity_
	Allocated size of ptrs_ array. More...

int	size_
	Logical size (number of elements with initialized data). More...

Constructor & Destructor Documentation

template<typename Data >

Util::GPArray< Data >::GPArray ( )

inline

Constructor.

Definition at line 113 of file GPArray.h.

template<typename Data>

Util::GPArray< Data >::GPArray ( const GPArray< Data > & other )

Copy constructor, copy pointers.

Allocates new Data* array and copies pointers to Data objects.

Parameters

other the GPArray to be copied.

Allocates a new Data* array and copies all pointer values.

Parameters

other the GPArray to be copied.

Definition at line 125 of file GPArray.h.

References Util::PArray< Data >::capacity_, Util::PArray< Data >::ptrs_, and Util::PArray< Data >::size_.

template<typename Data >

Util::GPArray< Data >::~GPArray ( )

virtual

Destructor.

Deletes array of pointers, if allocated previously. Does not delete the associated Data objects.

Definition at line 176 of file GPArray.h.

References Util::PArray< Data >::capacity_, Util::Memory::deallocate(), Util::GPArray< Data >::isAllocated(), Util::PArray< Data >::ptrs_, and Util::PArray< Data >::size_.

Member Function Documentation

template<typename Data>

GPArray< Data > & Util::GPArray< Data >::operator= ( const GPArray< Data > & other )

Assignment, element by element.

Preconditions:

Both this and other GPArrays must be allocated.
Capacity of this GPArray must be >= size of RHS GPArray.

Parameters

other the rhs GPArray

Definition at line 160 of file GPArray.h.

References Util::GPArray< Data >::append(), Util::GPArray< Data >::clear(), and Util::PArray< Data >::size_.

template<typename Data>

void Util::GPArray< Data >::append ( Data & data )

Append an element to the end of the sequence.

Resizes array if space is inadequate.

Parameters

data	Data object to be appended

Definition at line 235 of file GPArray.h.

References Util::PArray< Data >::capacity_, Util::GPArray< Data >::isAllocated(), Util::PArray< Data >::ptrs_, and Util::PArray< Data >::size_.

Referenced by Util::GPArray< Data >::operator=().

template<typename Data >

void Util::GPArray< Data >::reserve ( int capacity )

Reserve memory for specified number of elements.

Resizes and copies array if requested capacity is less than the current capacity. Does nothing if requested capacity is greater than current capacity.

Parameters

capacity number of elements for which to reserve space.

Definition at line 189 of file GPArray.h.

References Util::PArray< Data >::capacity(), Util::PArray< Data >::capacity_, Util::PArray< Data >::ptrs_, Util::PArray< Data >::size_, and UTIL_THROW.

template<typename Data >

void Util::GPArray< Data >::deallocate ( )

Deallocate (delete) underlying array of pointers.

Definition at line 221 of file GPArray.h.

References Util::PArray< Data >::capacity_, Util::GPArray< Data >::isAllocated(), Util::PArray< Data >::ptrs_, and Util::PArray< Data >::size_.

template<typename Data >

void Util::GPArray< Data >::clear ( )

inline