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 CopyColumnFrom
See also: CopyDataColumnFromArray 

CopyColumnFrom

Unit:SDL_datatable
Class: TDataTable
Declaration: function CopyColumnFrom (ExtTab: TDataTable; SrcCol, DestCol: integer): integer;

The function CopyColumnFrom copies the column SrcCol of the external table ExtTab into the column DestCol. Please note that CopyColumnFrom transfers the entire information of the external column (including the cell states, the column name, the column attribute and the definition of any nominal values).

If the number of rows of the external data table does not match NrOfRows the function returns an error code of -3 (which is a warning only code). If the length of the external column SrcCol is less than the number of rows only the first values of column DestCol are filled, the remaining cells are left unchanged. If the length of the external column is greater than the number of rows then only the first NrOfRows values are copied, the rest is ignored.

The function returns the following error codes:

 0 ... everything is OK, data has been copied
-1 ... SrcCol is out of range
-2 ... DestCol is out of range
-3 ... numbers of rows do not match (warning only)
-4 ... ExtTab is not initialized

Last Update: 2023-Dec-14