TemplateTNT::Array3D class Reference
Main Page Namespace List Compound List File List Namespace Members Compound Members File Members
Copyright By PowCoder代写 加微信 powcoder
TNT::Array3D Class Template Reference
#include
List of all members.
Public Types
typedef T value_type
Public Methods
Array3D ()
Array3D (int m, int n, int k)
Array3D (int m, int n, int k, T *a)
Array3D (int m, int n, int k, const T &a)
Array3D (const Array3D &A)
Array3D& operator= (const T &a)
Array3D& operator= (const Array3D &A)
Array3D& ref (const Array3D &A)
Array3D copy () const
Array3D& inject (const Array3D &A)
T** operator[] (int i)
const T* const* operator[] (int i) const
int dim1 () const
int dim2 () const
int dim3 () const
~Array3D ()
Detailed Description
template
Tempplated three-dimensional, numerical array which looks like a conventional C multiarray. Storage corresponds to conventional C ordering. That is the right-most dimension has contiguous elements. Indexing is via the A[i][j][k] notation.
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.
The indexing and layout of this array object makes it compatible with C and C++ algorithms that utilize the familiar C[i][j][k] notation. This includes numerous textbooks, such as Numercial Recipes, and various public domain codes.
Member Typedef Documentation
template
typedef T TNT::Array3D
Constructor & Destructor Documentation
template
TNT::Array3D< T >::Array3D
Create a null (0x0x0) array.
template
TNT::Array3D< T >::Array3D
Create a new (m x n x k) array, WIHOUT initializing array elements. To create an initialized array of constants, see Array3D(m,n,k, value).
This version avoids the O(m*n*k) initialization overhead and is used just before manual assignment.
Parameters:
the first dimension of the new matrix.
the second dimension of the new matrix.
the third dimension of the new matrix.
template
TNT::Array3D< T >::Array3D
Create a new (m x n x k) array, as a view of an existing one-dimensional array stored in C order, i.e. right-most dimension varying fastest. (Often referred to as “row-major” ordering.) Note that the storage for this pre-existing array will never be garbage collected by the Array3D class.
Parameters:
the first dimension of the new matrix.
the second dimension of the new matrix.
the third dimension of the new matrix.
the one dimensional C array to use as data storage for the array.
template
TNT::Array3D< T >::Array3D
const T & val )
Create a new (m x n x k) array, initializing array elements to constant specified by argument. Most often used to create an array of zeros, as in A(m, n, k, 0.0).
Parameters:
the first dimension of the new matrix.
the second dimension of the new matrix.
the third dimension of the new matrix.
the constant value to set all elements of the new array to.
template
TNT::Array3D< T >::Array3D
const Array3D
Copy constructor. Array data is NOT copied, but shared. Thus, in Array3D B(A), subsequent changes to A will be reflected in B. For an indepent copy of A, use Array3D B(A.copy()), or B = A.copy(), instead.
template
TNT::Array3D
Member Function Documentation
template
Array3D< T > TNT::Array3D< T >::copy (
Create a new of existing matrix. Used in B = A.copy() or in the construction of B, e.g. Array3D B(A.copy()), to create a new array that does not share data.
template
int TNT::Array3D< T >::dim1 (
) const [inline]
the size of the first dimension of the array.
template
int TNT::Array3D< T >::dim2 (
) const [inline]
the size of the second dimension of the array.
template
int TNT::Array3D< T >::dim3 (
) const [inline]
the size of the third (right-most) dimension of the array.
template
Array3D< T > & TNT::Array3D< T >::inject (
const Array3D
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
Array3D A(m,n,k);
Array3D C(m,n,k);
Array3D 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:
the array from elements will be copied
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
Array3D< T > & TNT::Array3D< T >::operator= (
const Array3D
B = A is shorthand notation for B.ref(A).
template
Array3D< T > & TNT::Array3D< T >::operator= (
const T & a ) [inline]
Assign all elemnts of A to a constant scalar.
template
const T *const * TNT::Array3D< T >::operator[] (
int i ) const [inline]
template
T ** TNT::Array3D< T >::operator[] (
int i ) [inline]
Used for A[i][j][k] indexing. The first [] operator returns a conventional pointer which can be dereferenced using the same [] notation.
If TNT_BOUNDS_CHECK macro is define, the left-most index is checked that it falls within the array bounds (via the assert() macro.)
template
Array3D< T > & TNT::Array3D< T >::ref (
const Array3D
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.
The new referenced array: in B.ref(A), it returns B.
The documentation for this class was generated from the following file: tnt_array3d.h
Generated at Thu Jun 26 17:26:23 2003 for Template Numerical Toolkit (TNT) by
1.2.5 written by Dimitri van Heesch,
© 1997-2001
程序代写 CS代考 加微信: powcoder QQ: 1823890830 Email: powcoder@163.com