MooseArray< T > Class Template Reference

forward declarations More...

#include <MooseArray.h>

Public Member Functions
	MooseArray ()
	Default constructor. More...
	MooseArray (const unsigned int size)
	MooseArray (const unsigned int size, const T &default_value)
void	setAllValues (const T &value)
	Sets all values of the array to the passed in value. More...
void	release ()
	Manually deallocates the data pointer. More...
void	clear ()
	Change the number of elements the array can store to zero. More...
void	resize (const unsigned int size)
	Change the number of elements the array can store. More...
void	resize (const unsigned int size, const T &default_value)
	Change the number of elements the array can store. More...
unsigned int	size () const
	The number of elements that can currently be stored in the array. More...
T &	operator[] (const unsigned int i)
	Get element i out of the array. More...
const T &	operator[] (const unsigned int i) const
	Get element i out of the array. More...
void	swap (MooseArray &rhs)
	Swap memory in this object with the 'rhs' object. More...
void	shallowCopy (const MooseArray &rhs)
	Doesn't actually make a copy of the data. More...
void	shallowCopy (std::vector< T > &rhs)
	Doesn't actually make a copy of the data. More...
MooseArray< T > &	operator= (const std::vector< T > &rhs)
	Actual operator=... More...
MooseArray< T > &	operator= (const MooseArray< T > &rhs)
	Actual operator=... More...
std::vector< T >	stdVector ()
	Extremely inefficient way to produce a std::vector from a MooseArray! More...

Private Attributes
T *	_data
	Actual data pointer. More...
unsigned int	_size
	The current number of elements the array can hold. More...
unsigned int	_allocated_size
	Number of allocated memory positions for storage. More...

Detailed Description

template<typename T>
class MooseArray< T >

forward declarations

Definition at line 17 of file MooseArray.h.

Constructor & Destructor Documentation

MooseArray() [1/3]

template<typename T>

MooseArray< T >::MooseArray ( )

inline

Default constructor.

Doesn't initialize anything.

Definition at line 23 of file MooseArray.h.

: _data(NULL), _size(0), _allocated_size(0) {}

MooseArray() [2/3]

template<typename T>

MooseArray< T >::MooseArray ( const unsigned int  size )

inlineexplicit

Parameters

size	The initial size of the array.

Definition at line 28 of file MooseArray.h.

: _data(NULL), _allocated_size(0) { resize(size); }

MooseArray() [3/3]

template<typename T>

MooseArray< T >::MooseArray ( const unsigned int  size, const T &  default_value  )

inlineexplicit

Parameters

size	The initial size of the array.
default_value	The default value to set.

Definition at line 34 of file MooseArray.h.

    : _data(NULL), _allocated_size(0)
  {
    resize(size);

    setAllValues(default_value);
  }

Member Function Documentation

clear()

template<typename T >

void MooseArray< T >::clear ( )

inline

Change the number of elements the array can store to zero.

Will destroy data currently in array!

Note that this does not free unused memory. This is done for speed.

Definition at line 193 of file MooseArray.h.

Referenced by MooseVariableScalar::reinit().

{
  _size = 0;
}

operator=() [1/2]

template<typename T>

MooseArray< T > & MooseArray< T >::operator= ( const std::vector< T > &  rhs )

inline

Actual operator=...

really does make a copy of the data

If you don't want a copy use shallowCopy()

Definition at line 297 of file MooseArray.h.

{
  unsigned int rhs_size = rhs.size();

  resize(rhs_size);

  for (unsigned int i = 0; i < rhs_size; i++)
    _data[i] = rhs[i];

  return *this;
}

operator=() [2/2]

template<typename T>

MooseArray< T > & MooseArray< T >::operator= ( const MooseArray< T > &  rhs )

inline

Actual operator=...

really does make a copy of the data

If you don't want a copy use shallowCopy()

Definition at line 311 of file MooseArray.h.

{
  //  mooseError("Shouldn't be doing this!");
  resize(rhs._size);
  //  memcpy(_data,rhs._data,sizeof(T)*_size);

  for (unsigned int i = 0; i < _size; i++)
    _data[i] = rhs._data[i];

  return *this;
}

operator[]() [1/2]

template<typename T >

T & MooseArray< T >::operator[] ( const unsigned int  i )

inline

Get element i out of the array.

Definition at line 251 of file MooseArray.h.

{
  mooseAssert(i < _size,
              "Access out of bounds in MooseArray (i: " << i << " size: " << _size << ")");

  return _data[i];
}

operator[]() [2/2]

template<typename T >

const T & MooseArray< T >::operator[] ( const unsigned int  i ) const

inline

Get element i out of the array.

Definition at line 260 of file MooseArray.h.

{
  mooseAssert(i < _size,
              "Access out of bounds in MooseArray (i: " << i << " size: " << _size << ")");

  return _data[i];
}

release()

template<typename T>

void MooseArray< T >::release ( )

inline

Manually deallocates the data pointer.

Definition at line 51 of file MooseArray.h.

Referenced by Assembly::modifyFaceWeightsDueToXFEM(), Assembly::modifyWeightsDueToXFEM(), TableOutput::outputScalarVariables(), Assembly::~Assembly(), Coupleable::~Coupleable(), MooseVariableScalar::~MooseVariableScalar(), NodeElemConstraint::~NodeElemConstraint(), and NodeFaceConstraint::~NodeFaceConstraint().

  {
    if (_data != NULL)
    {
      delete[] _data;
      _data = NULL;
      _allocated_size = _size = 0;
    }
  }

resize() [1/2]

template<typename T >

void MooseArray< T >::resize ( const unsigned int  size )

inline

Change the number of elements the array can store.

Will allocate more memory if necessary.

Can destroy data currently in array! Basically, data retention not guaranteed.

Note that this does not free unused memory. This is done for speed.

Definition at line 200 of file MooseArray.h.

Referenced by NodeElemConstraint::computeJacobian(), NodeFaceConstraint::computeJacobian(), MooseVariableConstMonomial::computeMonomialNeighborValuesHelper(), MooseVariableConstMonomial::computeMonomialValuesHelper(), NodeElemConstraint::computeOffDiagJacobian(), NodeFaceConstraint::computeOffDiagJacobian(), Coupleable::Coupleable(), EqualValueEmbeddedConstraint::getConnectedDofIndices(), MooseArray< Real >::MooseArray(), TableOutput::outputScalarVariables(), Nemesis::outputScalarVariables(), Exodus::outputScalarVariables(), MooseVariableScalar::reinit(), Assembly::reinitNeighbor(), Assembly::setCoordinateTransformation(), MooseVariableScalar::setValue(), and MooseVariableScalar::setValues().

{
  if (size <= _allocated_size)
    _size = size;
  else
  {
    T * new_pointer = new T[size];
    mooseAssert(new_pointer, "Failed to allocate MooseArray memory!");

    if (_data != NULL)
      delete[] _data;
    _data = new_pointer;
    _allocated_size = size;
    _size = size;
  }
}

resize() [2/2]

template<typename T>

void MooseArray< T >::resize ( const unsigned int  size, const T &  default_value  )

inline

Change the number of elements the array can store.

Will allocate more memory if necessary.

Can destroy data currently in array! Basically, data retention not guaranteed.

Note that this does not free unused memory. This is done for speed.

Also note that default_value is only applied to NEW entries.

Definition at line 219 of file MooseArray.h.

{
  if (size > _allocated_size)
  {
    T * new_pointer = new T[size];
    mooseAssert(new_pointer, "Failed to allocate MooseArray memory!");

    if (_data != NULL)
    {
      for (unsigned int i = 0; i < _size; i++)
        new_pointer[i] = _data[i];
      delete[] _data;
    }

    _data = new_pointer;
    _allocated_size = size;
  }

  for (unsigned int i = _size; i < size; i++)
    _data[i] = default_value;

  _size = size;
}

setAllValues()

template<typename T>

void MooseArray< T >::setAllValues ( const T &  value )

inline

Sets all values of the array to the passed in value.

Parameters

value

The value every entry of the array will be set to.

Definition at line 185 of file MooseArray.h.

Referenced by MooseArray< Real >::MooseArray().

{
  for (unsigned int i = 0; i < _size; i++)
    _data[i] = value;
}

shallowCopy() [1/2]

template<typename T >

void MooseArray< T >::shallowCopy ( const MooseArray< T > &  rhs )

inline

Doesn't actually make a copy of the data.

Just makes this object operate on the same data.

Note! You can leak memory with this function if you don't take care to have a copy of this array somewhere else. This is because the data pointer will get overridden here.

Definition at line 279 of file MooseArray.h.

Referenced by Assembly::copyFaceShapes(), Assembly::copyNeighborShapes(), Assembly::copyShapes(), Assembly::reinitFE(), Assembly::reinitFEFace(), Assembly::reinitFEFaceNeighbor(), Assembly::reinitFENeighbor(), and Assembly::reinitNeighborAtPhysical().

{
  _data = rhs._data;
  _size = rhs._size;
  _allocated_size = rhs._allocated_size;
}

shallowCopy() [2/2]

template<typename T>

void MooseArray< T >::shallowCopy ( std::vector< T > &  rhs )

inline

Doesn't actually make a copy of the data.

Just makes this object operate on the same data.

Note! You can leak memory with this function if you don't take care to have a copy of this array somewhere else. This is because the data pointer will get overridden here.

I repeat! This is an extremely dangerous function!

DO NOT USE UNLESS YOU KNOW WHAT YOU ARE DOING!

YOU HAVE BEEN WARNED!

Definition at line 288 of file MooseArray.h.

{
  _data = &rhs[0];
  _size = rhs.size();
  _allocated_size = rhs.size();
}

size()

template<typename T >

unsigned int MooseArray< T >::size ( ) const

inline

The number of elements that can currently be stored in the array.

Definition at line 245 of file MooseArray.h.

Referenced by AuxKernel::compute(), NodalPatchRecovery::compute(), ElemElemConstraint::computeElemNeighJacobian(), InterfaceKernel::computeElemNeighJacobian(), DGKernel::computeElemNeighJacobian(), ElemElemConstraint::computeElemNeighResidual(), InterfaceKernel::computeElemNeighResidual(), DGKernel::computeElemNeighResidual(), TimeDerivative::computeJacobian(), MassLumpedTimeDerivative::computeJacobian(), Kernel::computeJacobian(), EigenKernel::computeJacobian(), IntegratedBC::computeJacobian(), VectorKernel::computeJacobian(), EqualValueEmbeddedConstraint::computeJacobian(), VectorIntegratedBC::computeJacobian(), NonlocalIntegratedBC::computeJacobian(), NonlocalKernel::computeJacobian(), KernelGrad::computeJacobian(), KernelValue::computeJacobian(), NodeElemConstraint::computeJacobian(), NodeFaceConstraint::computeJacobian(), DiracKernel::computeJacobian(), IntegratedBC::computeJacobianBlock(), NonlocalIntegratedBC::computeJacobianBlock(), VectorIntegratedBC::computeJacobianBlock(), IntegratedBC::computeJacobianBlockScalar(), VectorIntegratedBC::computeJacobianBlockScalar(), MortarConstraint::computeJacobianSide(), NonlocalKernel::computeNonlocalJacobian(), NonlocalIntegratedBC::computeNonlocalJacobian(), NonlocalIntegratedBC::computeNonlocalOffDiagJacobian(), NonlocalKernel::computeNonlocalOffDiagJacobian(), InterfaceKernel::computeOffDiagElemNeighJacobian(), DGKernel::computeOffDiagElemNeighJacobian(), Kernel::computeOffDiagJacobian(), EigenKernel::computeOffDiagJacobian(), EqualValueEmbeddedConstraint::computeOffDiagJacobian(), VectorKernel::computeOffDiagJacobian(), NonlocalKernel::computeOffDiagJacobian(), KernelGrad::computeOffDiagJacobian(), KernelValue::computeOffDiagJacobian(), NodeElemConstraint::computeOffDiagJacobian(), NodeFaceConstraint::computeOffDiagJacobian(), DiracKernel::computeOffDiagJacobian(), VectorKernel::computeOffDiagJacobianScalar(), Kernel::computeOffDiagJacobianScalar(), Kernel::computeResidual(), TimeKernel::computeResidual(), VectorKernel::computeResidual(), IntegratedBC::computeResidual(), EigenKernel::computeResidual(), VectorIntegratedBC::computeResidual(), KernelValue::computeResidual(), KernelGrad::computeResidual(), NodeElemConstraint::computeResidual(), NodeFaceConstraint::computeResidual(), DiracKernel::computeResidual(), MortarConstraint::computeResidualSide(), NodalValueSampler::execute(), MultiAppVariableValueSamplePostprocessorTransfer::execute(), MultiAppVariableValueSampleTransfer::execute(), MultiAppScalarToAuxScalarTransfer::execute(), MultiAppPostprocessorToAuxScalarTransfer::execute(), RankTwoTensorTempl< Real >::fillFromScalarVariable(), ConservativeAdvection::fullUpwind(), GeometricSearchData::generateMortarNodes(), GeometricSearchData::generateQuadratureNodes(), MaterialStdVectorAux::getRealValue(), ElementalVariableValue::getValue(), Assembly::modifyFaceWeightsDueToXFEM(), Assembly::modifyWeightsDueToXFEM(), MooseArray< Real >::MooseArray(), TableOutput::outputScalarVariables(), MooseVariableFE< Real >::phiFaceNeighborSize(), MooseVariableFE< Real >::phiFaceSize(), MooseVariableFE< Real >::phiNeighborSize(), MooseVariableFE< Real >::phiSize(), MooseVariableScalar::reinit(), MooseVariableScalar::setValue(), GeometricSearchData::updateMortarNodes(), and GeometricSearchData::updateQuadratureNodes().

{
  return _size;
}

stdVector()

template<class T >

std::vector< T > MooseArray< T >::stdVector

(

)

Extremely inefficient way to produce a std::vector from a MooseArray!

Returns

A copy of the MooseArray contents.

Definition at line 325 of file MooseArray.h.

Referenced by Assembly::reinitElemAndNeighbor().

{
  return std::vector<T>(_data, _data + _size);
}

swap()

template<typename T >

void MooseArray< T >::swap ( MooseArray< T > &  rhs )

inline

Swap memory in this object with the 'rhs' object.

Parameters

rhs	The object we are swapping with

Definition at line 270 of file MooseArray.h.

{
  std::swap(_data, rhs._data);
  std::swap(_size, rhs._size);
  std::swap(_allocated_size, rhs._allocated_size);
}

Member Data Documentation

_allocated_size

template<typename T>

unsigned int MooseArray< T >::_allocated_size

private

Number of allocated memory positions for storage.

Definition at line 180 of file MooseArray.h.

Referenced by MooseArray< Real >::release(), MooseArray< Real >::shallowCopy(), and MooseArray< Real >::swap().

_data

template<typename T>

T* MooseArray< T >::_data

private

Actual data pointer.

Definition at line 174 of file MooseArray.h.

Referenced by MooseArray< Real >::operator=(), MooseArray< Real >::release(), MooseArray< Real >::shallowCopy(), and MooseArray< Real >::swap().

_size

template<typename T>

unsigned int MooseArray< T >::_size

private

The current number of elements the array can hold.

Definition at line 177 of file MooseArray.h.

Referenced by MooseArray< Real >::operator=(), MooseArray< Real >::release(), MooseArray< Real >::shallowCopy(), and MooseArray< Real >::swap().

---

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

• include/utils/MooseArray.h