NAME
aux_read_table -- read a text file
PROTOTYPE
void aux_read_table( FILE *fp, int iFirstRecord, int iMaxRecords, float **ppfData, int *piDim, int *piNum, char **ppcTitle, char **ppcHeader, float **ppfMin, float **ppfMax, int *piNumAxisLabels, char ***pppcAxisLabel, float **ppfAxisInfo, int **ppiBlockLen, char ***pppcRecordLabel, int iFlag, int (*pDiagnostics)(FILE*)
ARGUMENTS
- FILE *fp
- file to use
- int iFirstRecord
- record to start with
- int iMaxRecords
- max nr of records to read (0=all)
- float **ppfData
- adr of newly allocated array holding data that were read
- int *piDim
- dim of records read
- int *piNum
- actual nr of records read
- char **ppcTitle
- returns newly allocated title, "" if no title was read.
- char **ppcHeader
- returns newly allocated header text, "" if no header was read.
- float **ppfMin
- adr of ptr to vector of lower limits (one for each dimension)
- float **ppfMax
- adr of ptr to vector of upper limits (one for each dimension)
- int *piNumAxisLabels
- ptr to nr of axis labels read in header
- char ***pppcAxisLabel
- adr of newly allocated ptr array with axis labels ("#0", "#1" .) if no axis labels were read
- float **ppfAxisInfo
- if !NULL, adr of newly allocated ptr array holding the following three values for each axis: fMinRange: fMaxRange: lower/upper limit of range (returns fMin/fMax, if unspecified ) iNumBins : nr of discretization cells (returns 1, if unspecified)
- int **ppiBlockLen
- if specified, returns newly allocated array holding for each consecutive (ie., not interrupted by a blank line) block of data lines its nr of lines. El 0 will hold nr of blocks found.
- char ***pppcRecordLabel
- if specified, interprete column 0 not as data, but as record label field and returns adr of newly allocated ptr array holding record labels read from column 0
- int iFlag
- if 1, date order is days first, otherwise if -1, date order is months first
- int (*pDiagnostics)(FILE*
- - not documented in source --
FILE
/local/homes/rhaschke/nst7/man/../o.linx86//../foldersrc/aux_read_table.c