itk::Array< TValueType > Class Template Reference

#include <itkArray.h>

Inheritance diagram for itk::Array< TValueType >:

Collaboration diagram for itk::Array< TValueType >:

Detailed Description

template<typename TValueType>
class itk::Array< TValueType >

Array class with size defined at construction time.

This class derives from the vnl_vector<> class. Its size is assigned at construction time (run time) and can not be changed afterwards except by using assignment to another Array.

The class is templated over the type of the elements.

Template parameters for class Array:

• TValueType = Element type stored at each location in the array.

Definition at line 50 of file itkArray.h.

Public Types
typedef Array	Self
typedef vnl_vector< TValueType > ::size_type	SizeValueType
typedef TValueType	ValueType
typedef vnl_vector< TValueType >	VnlVectorType

Public Member Functions
	Array ()
	Array (const Array &)
	Array (SizeValueType dimension)
	Array (ValueType *data, SizeValueType sz, bool LetArrayManageMemory=false)
	Array (const ValueType *data, SizeValueType sz, bool LetArrayManageMemory=false)
void	Fill (TValueType const &v)
const TValueType &	GetElement (SizeValueType i) const
SizeValueType	GetSize (void) const
const Self &	operator= (const Self &rhs)
const Self &	operator= (const VnlVectorType &rhs)
void	SetData (TValueType *data, bool LetArrayManageMemory=false)
void	SetData (TValueType *data, SizeValueType sz, bool LetArrayManageMemory=false)
void	SetElement (SizeValueType i, const TValueType &value)
void	SetSize (SizeValueType sz)
	~Array ()
template<class TArrayValue >
	Array (const Array< TArrayValue > &r)
SizeValueType	Size (void) const
unsigned int	GetNumberOfElements (void) const

Private Attributes
bool	m_LetArrayManageMemory

Member Typedef Documentation

template<typename TValueType>

typedef Array itk::Array< TValueType >::Self

Definition at line 56 of file itkArray.h.

template<typename TValueType>

typedef vnl_vector< TValueType>::size_type itk::Array< TValueType >::SizeValueType

Definition at line 58 of file itkArray.h.

template<typename TValueType>

typedef TValueType itk::Array< TValueType >::ValueType

The element type stored at each location in the Array.

Definition at line 55 of file itkArray.h.

template<typename TValueType>

typedef vnl_vector< TValueType > itk::Array< TValueType >::VnlVectorType

Definition at line 57 of file itkArray.h.

Constructor & Destructor Documentation

template<typename TValueType>

itk::Array< TValueType >::Array

(

)

Default constructor. It is created with an empty array it has to be allocated later by assignment

template<typename TValueType>

itk::Array< TValueType >::Array

(

const Array< TValueType > &

)

Copy constructor. Uses VNL copy construtor with correct setting for memory management.

template<typename TValueType>

itk::Array< TValueType >::Array ( SizeValueType  dimension )

explicit

Constructor with size. Size can only be changed by assignment

template<typename TValueType>

itk::Array< TValueType >::Array	(	ValueType *	data,
		SizeValueType	sz,
		bool	LetArrayManageMemory = false
	)

Constructor that initializes array with contents from a user supplied buffer. The pointer to the buffer and the length is specified. By default, the array does not manage the memory of the buffer. It merely points to that location and it is the user's responsibility to delete it. If "LetArrayManageMemory" is true, then this class will free the memory when this object is destroyed.

template<typename TValueType>

itk::Array< TValueType >::Array	(	const ValueType *	data,
		SizeValueType	sz,
		bool	LetArrayManageMemory = false
	)

Constructor that initializes array with contents from a user supplied buffer. The pointer to the buffer and the length is specified. By default, the array does not manage the memory of the buffer. It merely points to that location and it is the user's responsibility to delete it. If "LetArrayManageMemory" is true, then this class will free the memory when this object is destroyed.

template<typename TValueType>

template<class TArrayValue >

itk::Array< TValueType >::Array ( const Array< TArrayValue > &  r )

inline

Constructor to initialize an array from another of any data type

Definition at line 92 of file itkArray.h.

template<typename TValueType>

itk::Array< TValueType >::~Array

(

)

This destructor is not virtual for performance reasons. However, this means that subclasses cannot allocate memory.

Member Function Documentation

template<typename TValueType>

void itk::Array< TValueType >::Fill ( TValueType const &  v )

inline

Set the all the elements of the array to the specified value

Definition at line 104 of file itkArray.h.

Referenced by itk::MatchCardinalityImageToImageMetric< TFixedImage, TMovingImage >::GetDerivative(), itk::NumericTraits< Array< T > >::max(), itk::NumericTraits< Array< T > >::min(), itk::NumericTraits< Array< T > >::NonpositiveMin(), itk::NumericTraits< Array< T > >::OneValue(), itk::NumericTraits< Array< T > >::SetLength(), and itk::NumericTraits< Array< T > >::ZeroValue().

template<typename TValueType>

const TValueType& itk::Array< TValueType >::GetElement ( SizeValueType  i ) const

inline

Get one element

Definition at line 122 of file itkArray.h.

template<typename TValueType>

unsigned int itk::Array< TValueType >::GetNumberOfElements ( void  ) const

inline

Return the number of elements in the Array

Definition at line 117 of file itkArray.h.

template<typename TValueType>

SizeValueType itk::Array< TValueType >::GetSize ( void  ) const

inline

Definition at line 132 of file itkArray.h.

Referenced by itk::Array< AccumulateType >::Array(), itk::NumericTraits< Array< T > >::GetLength(), itk::OptimizerParametersHelper< TValueType >::MoveDataPointer(), itk::MetaArrayWriter::SetMultiChannelInput(), and itk::Statistics::ProbabilityDistribution::SetParameters().

template<typename TValueType>

const Self& itk::Array< TValueType >::operator=

(

const Self &

rhs

)

Copy opertor

template<typename TValueType>

const Self& itk::Array< TValueType >::operator=

(

const VnlVectorType &

rhs

)

template<typename TValueType>

void itk::Array< TValueType >::SetData	(	TValueType *	data,
		bool	LetArrayManageMemory = false
	)

Set the pointer from which the data is imported. If "LetArrayManageMemory" is false, then the application retains the responsibility of freeing the memory for this data. If "LetArrayManageMemory" is true, then this class will free the memory when this object is destroyed.

Referenced by itk::MetaArrayReader::GetOutput(), and itk::OptimizerParametersHelper< TValueType >::MoveDataPointer().

template<typename TValueType>

void itk::Array< TValueType >::SetData	(	TValueType *	data,
		SizeValueType	sz,
		bool	LetArrayManageMemory = false
	)

Similar to the previous method. In the above method, the size must be separately set prior to using user-supplied data. This introduces an unnecessary allocation step to be performed. This method avoids it and should be used to import data wherever possible to avoid this. Set the pointer from which the data is imported. If "LetArrayManageMemory" is false, then the application retains the responsibility of freeing the memory for this data. If "LetArrayManageMemory" is true, then this class will free the memory when this object is destroyed.

template<typename TValueType>

void itk::Array< TValueType >::SetElement ( SizeValueType  i, const TValueType &  value  )

inline

Set one element

Definition at line 126 of file itkArray.h.

template<typename TValueType>

void itk::Array< TValueType >::SetSize

(

SizeValueType

sz

)

Destructively set the size to that given. Will lose data.

Referenced by itk::Array< AccumulateType >::Array(), itk::TranslationTransform< TScalarType, NDimensions >::GetFixedParameters(), itk::MetaArrayReader::GetMultiChannelOutput(), itk::LabelStatisticsImageFilter< TInputImage, TLabelImage >::LabelStatistics::LabelStatistics(), and itk::NumericTraits< Array< T > >::SetLength().

template<typename TValueType>

SizeValueType itk::Array< TValueType >::Size ( void  ) const

inline

Return the number of elements in the Array

Definition at line 115 of file itkArray.h.

Referenced by itk::Statistics::MeasurementVectorTraits::Assert(), itk::NumericTraits< Array< T > >::max(), itk::NumericTraits< Array< T > >::min(), itk::NumericTraits< Array< T > >::NonpositiveMin(), itk::NumericTraits< Array< T > >::OneValue(), itk::AutomaticTopologyMeshSource< TOutputMesh >::IdentifierArrayHashFunction::operator()(), itk::AutomaticTopologyMeshSource< TOutputMesh >::IdentifierArrayEqualsFunction::operator()(), itk::MetaArrayWriter::SetInput(), itk::DisplacementFieldTransform< TScalar, NDimensions >::SetParameters(), itk::MeshIOBase::SetPixelType(), itk::ImageRegistrationMethodv4< TFixedImage, TMovingImage, TOutputTransform >::SetShrinkFactorsPerLevel(), SimpleMultiResolutionImageRegistrationUI2< TRegistration >::StartNewLevel(), and itk::NumericTraits< Array< T > >::ZeroValue().

Member Data Documentation

template<typename TValueType>

bool itk::Array< TValueType >::m_LetArrayManageMemory

private

Definition at line 164 of file itkArray.h.

Referenced by itk::Array< AccumulateType >::Array().

---

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

• itkArray.h