The SDL Component Suite is an industry leading collection of components supporting scientific and engineering computing. Please visit the SDL Web site for more information....


Home MathPack DataTable Methods CopyDataColumnToVector
See also: CopyDataColumnFromVector, CopyDataColumnToArray, CopyDataRowToVector, CopyFrom (Vector) 

CopyDataColumnToVector

Unit:SDL_datatable
Class: TDataTable
Declaration: [1] function CopyDataColumnToVector (Col: integer; Dest: TVector): integer;
[2] function CopyDataColumnToVector (Dest: TVector; Col, FirstRow, LastRow, DestElem: integer): integer;
[3] function CopyDataColumnToVector (Dest: TIntVector; Col, FirstRow, LastRow, DestElem: integer): integer;

The function CopyDataColumnToVector copies the numeric data of the column Col to the vector Dest. Version [1] works a differently than the other versions in that it always copies the entire column and automatically resizes the target vector Dest. The other versions allow to copy parts of a column and do not adjust the size of the target vector. Version [3] rounds the values before copying them to the target vector.

Nominal data values of the data table are replaced by their ordinals when copying them to Dest. The parameter Col specifies the column to be copied, the parameters FirstRow and LastRow define the range of the cells in column Col, and the parameter DestElem specifies the target position of the first cell.

The function returns the following error codes:

 0 ... everything is OK, data has been copied
-1 ... invalid parameter Col (valid range is 1 ... NrOfColumns)
-2 ... FirstRow and/or LastRow are out of range (valid range: 1 ... NrOfRows)
-3 ... the parameter DestElem is out of range (valid range: 1 ... Dest.NrOfElem)
-4 ... the target vector Dest is not instantiated

Hint: Setting both FirstRow and LastRow to zero values is a shortcut for copying all cells of the specified column.


Last Update: 2023-Dec-14