XLL+ Class Library

CXlArray::CXlArray

Constructs a CXlArray object

[C++]
CXlArray();
CXlArray(
   LPXLARRAY pxla
);
CXlArray(
   const CXlArray& xla
);
CXlArray(
   WORD cRows,
   WORD cCols
);
CXlArray(
   double* pd,
   USHORT cItems,
   BOOL bRow = FALSE
);
CXlArray(
   double* pd,
   USHORT cRows,
   USHORT cCols,
   BOOL bByRows = FALSE
);
CXlArray(
   double** apd,
   USHORT cRows,
   USHORT cCols,
   BOOL bByRows = FALSE
);
CXlArray(
   const xlp::matrix<double>& dmat,
   USHORT usIgnoreRows = 0,
   USHORT usIgnoreCols = 0,
   BOOL bTranspose = FALSE
);
CXlArray(
   const std::vector<double>& dvec,
   BOOL bRow,
   USHORT usIgnoreCols = 0
);

Parameters

pxla

A pointer to an XLARRAY structure, usually passed into an add-in function.

xla

An reference to an initialised CXlArray object, which will be copied.

cRows

The number of rows a newly created array object should contain.

cCols

The number of columns a newly created array object should contain.

pd

An array of double's, containing either cRows items, or (cRows x cCols) items, depending on the function variant used. For the latter type, the values should be arranged in the order specified by the bByRows parameter.

cItems

The number of rows contained in the supplied array of doubles.

bRow

If this is true, then a one-dimensional array will be created as a row; if FALSE, the array will be a column.

cCols

The number of columns contained in the supplied array of doubles.

bByRows

Storage order of arrays of double's. If TRUE, then values in the same row are stored contiguously, otherwise values in the same column are assumed to be stored contiguously.

apd

An array of pointers to double, containing either cRows arrays each of size cCols, or cCols arrays each of size cRows, depending on the order specified by the bByRows parameter.

dmat

A reference to a matrix of doubles. The array in the CXlArray will contain a copy of the matrix.

usIgnoreRows

The number of rows in the supplied matrix to be ignored. This feature is useful if the matrix has been populated by a function which uses 1-based arrays.

usIgnoreCols

The number of columns in the supplied matrix to be ignored. This feature is useful if the matrix has been populated by a function which uses 1-based arrays.

bTranspose

If TRUE, then the data in the matrix is transposed before it is placed in the CXlArray. If FALSE, it is not.

dvec

A reference to a vector of doubles. The array in the CXlArray will contain a copy of the matrix.

usIgnoreCols

The number of items in the supplied vector to be ignored. This feature is useful if the vector has been populated by a function which uses 1-based arrays.

Requirements

Header: xllplus.h

See Also

CXlArray Class | CXlArray Methods