tnt_array1d.h

Go to the documentation of this file.

/*
*
* Template Numerical Toolkit (TNT)
*
* Mathematical and Computational Sciences Division
* National Institute of Technology,
* Gaithersburg, MD USA
*
*
* This software was developed at the National Institute of Standards and
* Technology (NIST) by employees of the Federal Government in the course
* of their official duties. Pursuant to title 17 Section 105 of the
* United States Code, this software is not subject to copyright protection
* and is in the public domain. NIST assumes no responsibility whatsoever for
* its use by other parties, and makes no guarantees, expressed or implied,
* about its quality, reliability, or any other characteristic.
*
*/
 
 
 
#ifndef TNT_ARRAY1D_H
#define TNT_ARRAY1D_H
 
//#include <cstdlib>
#include <iostream>
 
#ifdef TNT_BOUNDS_CHECK
#include <assert.h>
#endif
 
 
#include "tnt_i_refvec.h"
 
namespace TNT
{
 
template <class T>
class Array1D
{
 
  private:
 
          /* ... */
    i_refvec<T> v_;
    int n_;
    T* data_;                           /* this normally points to v_.begin(), but
                             * could also point to a portion (subvector)
                                                         * of v_.
                            */
 
    void copy_(T* p, const T*  q, int len) const;
    void set_(T* begin,  T* end, const T& val);
 
 
  public:
 
    typedef         T   value_type;
 
 
                 Array1D();
        explicit Array1D(int n);
                 Array1D(int n, const T &a);
                 Array1D(int n,  T *a);
    inline   Array1D(const Array1D &A);
        inline   operator T*();
        inline   operator const T*();
        inline   Array1D & operator=(const T &a);
        inline   Array1D & operator=(const Array1D &A);
        inline   Array1D & ref(const Array1D &A);
                 Array1D copy() const;
                     Array1D & inject(const Array1D & A);
        inline   T& operator[](int i);
        inline   const T& operator[](int i) const;
        inline   int dim1() const;
        inline   int dim() const;
              ~Array1D();
 
 
        /* ... extended interface ... */
 
        inline int ref_count() const;
        inline Array1D<T> subarray(int i0, int i1);
 
};
 
 
 
 
template <class T>
Array1D<T>::Array1D() : v_(), n_(0), data_(0) {}
 
template <class T>
Array1D<T>::Array1D(const Array1D<T> &A) : v_(A.v_),  n_(A.n_),
                data_(A.data_)
{
#ifdef TNT_DEBUG
        std::cout << "Created Array1D(const Array1D<T> &A) \n";
#endif
 
}
 
 
template <class T>
Array1D<T>::Array1D(int n) : v_(n), n_(n), data_(v_.begin())
{
#ifdef TNT_DEBUG
        std::cout << "Created Array1D(int n) \n";
#endif
}
 
template <class T>
Array1D<T>::Array1D(int n, const T &val) : v_(n), n_(n), data_(v_.begin())
{
#ifdef TNT_DEBUG
        std::cout << "Created Array1D(int n, const T& val) \n";
#endif
        set_(data_, data_+ n, val);
 
}
 
template <class T>
Array1D<T>::Array1D(int n, T *a) : v_(a), n_(n) , data_(v_.begin())
{
#ifdef TNT_DEBUG
        std::cout << "Created Array1D(int n, T* a) \n";
#endif
}
 
template <class T>
inline Array1D<T>::operator T*()
{
        return &(v_[0]);
}
 
 
template <class T>
inline Array1D<T>::operator const T*()
{
        return &(v_[0]);
}
 
 
 
template <class T>
inline T& Array1D<T>::operator[](int i)
{
#ifdef TNT_BOUNDS_CHECK
        assert(i>= 0);
        assert(i < n_);
#endif
        return data_[i];
}
 
template <class T>
inline const T& Array1D<T>::operator[](int i) const
{
#ifdef TNT_BOUNDS_CHECK
        assert(i>= 0);
        assert(i < n_);
#endif
        return data_[i];
}
 
 
 
 
template <class T>
Array1D<T> & Array1D<T>::operator=(const T &a)
{
        set_(data_, data_+n_, a);
        return *this;
}
 
template <class T>
Array1D<T> Array1D<T>::copy() const
{
        Array1D A( n_);
        copy_(A.data_, data_, n_);
 
        return A;
}
 
 
template <class T>
Array1D<T> & Array1D<T>::inject(const Array1D &A)
{
        if (A.n_ == n_)
                copy_(data_, A.data_, n_);
 
        return *this;
}
 
 
 
 
 
template <class T>
Array1D<T> & Array1D<T>::ref(const Array1D<T> &A)
{
        if (this != &A)
        {
                v_ = A.v_;              /* operator= handles the reference counting. */
                n_ = A.n_;
                data_ = A.data_;
 
        }
        return *this;
}
 
template <class T>
Array1D<T> & Array1D<T>::operator=(const Array1D<T> &A)
{
        return ref(A);
}
 
template <class T>
inline int Array1D<T>::dim1() const { return n_; }
 
template <class T>
inline int Array1D<T>::dim() const { return n_; }
 
template <class T>
Array1D<T>::~Array1D() {}
 
 
/* ............................ exented interface ......................*/
 
template <class T>
inline int Array1D<T>::ref_count() const
{
        return v_.ref_count();
}
 
template <class T>
inline Array1D<T> Array1D<T>::subarray(int i0, int i1)
{
    if (((i0 > 0) && (i1 < n_)) || (i0 <= i1))
        {
                Array1D<T> X(*this);  /* create a new instance of this array. */
                X.n_ = i1-i0+1;
                X.data_ += i0;
 
                return X;
        }
        else
        {
                return Array1D<T>();
        }
}
 
 
/* private internal functions */
 
 
template <class T>
void Array1D<T>::set_(T* begin, T* end, const T& a)
{
        for (T* p=begin; p<end; p++)
                *p = a;
 
}
 
template <class T>
void Array1D<T>::copy_(T* p, const T* q, int len) const
{
        T *end = p + len;
        while (p<end )
                *p++ = *q++;
 
}
 
 
} /* namespace TNT */
 
#endif
/* TNT_ARRAY1D_H */