Main Page   Namespace List   Compound List   File List   Namespace Members   Compound Members   File Members  

TNT::Fortran_Array1D Class Template Reference

#include <tnt_fortran_array1d.h>

List of all members.

Public Types

typedef T value_type

Public Methods

 Fortran_Array1D ()
 Fortran_Array1D (int n)
 Fortran_Array1D (int n, T *a)
 Fortran_Array1D (int n, const T &a)
 Fortran_Array1D (const Fortran_Array1D &A)
Fortran_Array1D& operator= (const T &a)
Fortran_Array1D& operator= (const Fortran_Array1D &A)
Fortran_Array1D& ref (const Fortran_Array1D &A)
Fortran_Array1D copy () const
Fortran_Array1D& inject (const Fortran_Array1D &A)
T& operator() (int i)
const T& operator() (int i) const
int dim () const
int dim1 () const
int ref_count () const
 ~Fortran_Array1D ()


Detailed Description

template<class T> class TNT::Fortran_Array1D

Templated one-dimensional, numerical array which looks like a conventional Fortran array. This is useful when integrating with C/C++ codes translated from Fortran. Indexing is via the A(i) notation and A(1) is the first element.

Array assignment is by reference (i.e. shallow assignment). That is, B=A implies that the A and B point to the same array, so modifications to the elements of A will be reflected in B. If an independent copy is required, then B = A.copy() can be used. Note that this facilitates returning arrays from functions without relying on compiler optimizations to eliminate extensive data copying.

This class employs its own garbage collection via the use of reference counts. That is, whenever an internal array storage no longer has any references to it, it is destoryed.


Member Typedef Documentation

template<class T>
typedef T TNT::Fortran_Array1D<T>::value_type
 


Constructor & Destructor Documentation

template<class T>
TNT::Fortran_Array1D< T >::Fortran_Array1D<T> ( )
 

Create a null (0-length) array.

template<class T>
TNT::Fortran_Array1D< T >::Fortran_Array1D<T> ( int n )
 

Create a new (n) array, WIHOUT initializing array elements. To create an initialized array of constants, see Fortran_Array1D(n, value).

This version avoids the O(n) initialization overhead and is used just before manual assignment.

Parameters:
m   the dimension of the new matrix.

template<class T>
TNT::Fortran_Array1D< T >::Fortran_Array1D<T> ( int n,
T * a )
 

Create a new n-length array, as a view of an existing one-dimensional C array. (Note that the storage for this pre-existing array will never be garbage collected by the Fortran_Array1D class.)

Parameters:
m   the first dimension of the new matrix.
n   the second dimension of the new matrix.
a   the one dimensional C array to use as data storage for the array.

template<class T>
TNT::Fortran_Array1D< T >::Fortran_Array1D<T> ( int n,
const T & val )
 

Create a new n-length array, initializing array elements to constant specified by argument. Most often used to create an array of zeros, as in A(n, 0.0).

Parameters:
m   the dimension of the new matrix.
val   the constant value to set all elements of the new array to.

template<class T>
TNT::Fortran_Array1D< T >::Fortran_Array1D<T> ( const Fortran_Array1D<T> & A ) [inline]
 

Copy constructor. Array data is NOT copied, but shared. Thus, in Fortran_Array1D B(A), subsequent changes to A will be reflected in B. For an indepent copy of A, use Fortran_Array1D B(A.copy()), or B = A.copy(), instead.

template<class T>
TNT::Fortran_Array1D<T>::~Fortran_Array1D<T> ( )
 


Member Function Documentation

template<class T>
Fortran_Array1D< T > TNT::Fortran_Array1D< T >::copy ( ) const
 

Create a new of existing matrix. Used in B = A.copy() or in the construction of B, e.g. Fortran_Array1D B(A.copy()), to create a new array that does not share data.

template<class T>
int TNT::Fortran_Array1D< T >::dim ( ) const [inline]
 

Returns:
the size (dimension of) the array.

template<class T>
int TNT::Fortran_Array1D< T >::dim1 ( ) const [inline]
 

Returns:
the size (dimension of) the array.

template<class T>
Fortran_Array1D< T > & TNT::Fortran_Array1D< T >::inject ( const Fortran_Array1D<T> & A )
 

Copy the elements to from one array to another, in place. That is B.inject(A), both A and B must conform (i.e. have identical dimensions).

This differs from B = A.copy() in that references to B before this assignment are also affected. That is, if we have

	Fortran_Array1D A(n);
	Fortran_Array1D C(n);
	Fortran_Array1D B(C);        // elements of B and C are shared. 

then B.inject(A) affects both and C, while B=A.copy() creates a new array B which shares no data with C or A.
Parameters:
A   the array from elements will be copied
Returns:
an instance of the modifed array. That is, in B.inject(A), it returns B. If A and B are not conformat, no modifications to B are made.

template<class T>
const T & TNT::Fortran_Array1D< T >::operator() ( int i ) const [inline]
 

Read-only version of A(i,j) indexing.

If TNT_BOUNDS_CHECK macro is defined, the indices are checked that they falls within the array bounds (via the assert() macro.)

template<class T>
T & TNT::Fortran_Array1D< T >::operator() ( int i ) [inline]
 

Elements are accessed via A(i) indexing.

If TNT_BOUNDS_CHECK macro is defined, the indices are checked that they falls within the array bounds (via the assert() macro.)

template<class T>
Fortran_Array1D< T > & TNT::Fortran_Array1D< T >::operator= ( const Fortran_Array1D<T> & A ) [inline]
 

B = A is shorthand notation for B.ref(A).

template<class T>
Fortran_Array1D< T > & TNT::Fortran_Array1D< T >::operator= ( const T & a ) [inline]
 

Assign all elemnts of A to a constant scalar.

template<class T>
Fortran_Array1D< T > & TNT::Fortran_Array1D< T >::ref ( const Fortran_Array1D<T> & A ) [inline]
 

Create a reference (shallow assignment) to another existing array. In B.ref(A), B and A shared the same data and subsequent changes to the array elements of one will be reflected in the other.

This is what operator= calls, and B=A and B.ref(A) are equivalent operations.

Returns:
The new referenced array: in B.ref(A), it returns B.

template<class T>
int TNT::Fortran_Array1D<T>::ref_count ( ) const [inline]
 


The documentation for this class was generated from the following file:
Generated at Thu Jun 26 17:26:23 2003 for Template Numerical Toolkit (TNT) by doxygen1.2.5 written by Dimitri van Heesch, © 1997-2001