itkArray.h

Go to the documentation of this file.

/*=========================================================================
 *
 *  Copyright Insight Software Consortium
 *
 *  Licensed under the Apache License, Version 2.0 (the "License");
 *  you may not use this file except in compliance with the License.
 *  You may obtain a copy of the License at
 *
 *         http://www.apache.org/licenses/LICENSE-2.0.txt
 *
 *  Unless required by applicable law or agreed to in writing, software
 *  distributed under the License is distributed on an "AS IS" BASIS,
 *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 *  See the License for the specific language governing permissions and
 *  limitations under the License.
 *
 *=========================================================================*/
#ifndef itkArray_h
#define itkArray_h

#include "itkMacro.h"

#include "vxl_version.h"
#if VXL_VERSION_DATE_FULL < 20110428
#error "System installed VXL version is too old. Please make sure the version date is later than 2011-04-28."
#endif

#include "vnl/vnl_vector.h"

namespace itk
{
template< typename TValue >
class ITK_TEMPLATE_EXPORT Array : public vnl_vector< TValue >
{
public:

  typedef TValue                                  ValueType;
  typedef Array                                   Self;
  typedef vnl_vector< TValue >                    VnlVectorType;
  typedef typename vnl_vector< TValue>::size_type SizeValueType;

public:

  Array();

  Array(const Array&);

  explicit Array(SizeValueType dimension);

  Array(ValueType *data, SizeValueType sz, bool LetArrayManageMemory = false);

#if defined ( ITK_FUTURE_LEGACY_REMOVE )

  Array(const ValueType *datain, SizeValueType sz);

#else // defined ( ITK_FUTURE_LEGACY_REMOVE )

  Array(const ValueType *data, SizeValueType sz,
        bool LetArrayManageMemory = false);
#endif

  template< typename TArrayValue >
  Array(const Array< TArrayValue > & r)
  {
    this->m_LetArrayManageMemory = true;
    this->SetSize( r.GetSize() );
    for( SizeValueType i=0; i<r.GetSize(); i++ )
      {
      this->operator[](i) = static_cast< TValue >( r[i] );
      }
  }

  void Fill(TValue const & v)
    {
    this->fill(v);
    }

  const Self & operator=(const Self & rhs);

  const Self & operator=(const VnlVectorType & rhs);

  SizeValueType Size(void) const
  { return static_cast<SizeValueType >( this->size() ); }
  unsigned int GetNumberOfElements(void) const
  { return static_cast<SizeValueType >( this->size() ); }

  const TValue & GetElement(SizeValueType i) const
  { return this->operator[](i); }

  void SetElement(SizeValueType i, const TValue & value)
  { this->operator[](i) = value; }

  void SetSize(SizeValueType sz);

  SizeValueType GetSize(void) const
  { return static_cast< SizeValueType >( this->size() ); }

  void SetDataSameSize(TValue *data, bool LetArrayManageMemory = false);

  void SetData(TValue *data, SizeValueType sz, bool LetArrayManageMemory = false);

#ifdef __INTEL_COMPILER
#pragma warning disable 444 //destructor for base class "itk::Array<>" is not virtual
#endif

  ~Array();

#if ! defined ( ITK_FUTURE_LEGACY_REMOVE )
  void swap(Array &other)
    {
      this->Swap(other);
    }
#endif

  void Swap(Array &other)
    {
      using std::swap;
      this->VnlVectorType::swap(other);
      swap(this->m_LetArrayManageMemory, other.m_LetArrayManageMemory);
    }

private:

  bool m_LetArrayManageMemory;
};

template< typename TValue >
std::ostream & operator<<(std::ostream & os, const Array< TValue > & arr)
{
  os << "[";
  const unsigned int length = arr.size();
  if ( length >= 1 )
    {
    const unsigned int   last   = length - 1;
    for ( unsigned int i = 0; i < last; ++i )
      {
      os << arr[i] << ", ";
      }
      os << arr[last];
    }
  os << "]";
  return os;
}

// declaration of specialization
template<> ITKCommon_EXPORT std::ostream & operator<< <double> (std::ostream & os, const Array< double > & arr);
template<> ITKCommon_EXPORT std::ostream & operator<< <float> (std::ostream & os, const Array< float > & arr);


template<typename T>
inline void swap( Array<T> &a, Array<T> &b )
{
  a.Swap(b);
}

} // namespace itk

#ifndef ITK_MANUAL_INSTANTIATION
#include "itkArray.hxx"
#endif

#endif