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 ImportASC
See also: ExportAsASC, ReadFromASC, ReadHeaderOfASC, Resize, OnResize, Format of ASC data file 

ImportASC


Unit:SDL_datatable
Class: TDataTable
Declaration: [1] function ImportASC (FName: string): integer;
[2] function ImportASC (InStream: TStream): integer;
[3] function ImportASC (ClipBd: TClipBoard): integer;
[4] function ImportASC (FName: string; var CustData: TStr2DArray): integer;

The method ImportASC reads the data from a specially formatted ASCII text into the internal data matrix. The size of the matrix is adjusted automatically to fit the data on the ASCII file. Version [1] reads the data from a file. The parameter FName specifies the name of the file to be read. Version [2] reads the data from the stream InStream. The OnResize event is triggered after successful import of the data. Version [3] reads the data from the Windows clipboard. The parameter ClipBd contains a pointer to the clipboard to be used. In addition to reading the data table version [4] also reads the custom data which have been stored using version [4] of ExportAsASC. The parameter CustData returns the custom data as a two-dimensional string array containing the names of the custom data in the first column and the corresponding values in the second column.

The function returns an error code with the following meaning:
0 no error
-1 error in specification of number of features
-2 error in specification of number of objects
-3 error in ClInf/NamFeat/NamObj flags
-5 invalid class information
-6 invalid numeric data
-7 invalid data on clipboard
-8 file not found

Example: This method is used in the following example programs (see http://www.lohninger.com/examples.html for downloading the code): kohmap, interpol3d, multilinreg, ntabedit, simplepca


Last Update: 2023-Dec-14