# @(#)AAREADME 17.1.1.1 (ESO-IPG) 01/25/02 17:36:43 ******************* * Tables Version 3.0 * FO June 1990 ******************* Table access routines TC - column access TD - descriptor access TE - element access TR - row access TT - table access TZx - (i = 1, ..., 8) low level routines, which are: TZ0 Deals with NULL values TZ1 Check of legal parameters (formats, etc), and compute position in buffer depending on table organisation (record / transposed) TZ2 Some string utilities TZ3 Conversions (ascii to binary and vice-versa) TZ4 error handler TZ5 Management of Table Structures TZ6 Low level Read / Write TZ8 Management of Overfolw Mechanism TZ9 Search algorithms Include files ------------- tbldef.h required for applications using the tables tblsys.h only required for compilation of the above modules. Some parameters on this file may be adjusted New Features ============ 1. Each column may be an array. Syntax: CREA/COL table label type(n) "unit" format 2. Options at TCTOPN / TCTINI : modifiers F_MAP_FORCE forces the mapping modifiers F_EIO_FORCE forces the elementary io's ... + number of columns ! 3. Sorting revisited 4. Specify selection of lines as @a..b,c..d[,...] with ranges and selection of Columns as #1,4,3 or :x,y,.. 5. New Formats available: A/ small letters generally ask for SIGNED number F12.5 applied on 12.5 results in " 12.50000" f12.5 applied on 12.5 results in " +12.50000" B/ Zero-filled values with Zx.y or zx.y C/ Sexagesimal values Sx.y or sx.y (e.g. declinations) Rx.y or rx.y (for right ascensions, factor of 15) D/ Date + Time New Entry Points ================ TCBGET (tid, int column, &dtype, &items, &bytes); TCCSEL (tid, char *text, int max_cols, long &cols[], long &flags[]) TCEMAP (tid, int row, int column, &&addr, &isnull); TCOGET ("option_name", value) TCRSEL (tid, char *text, int max_ranges, long &lower[], long &upper[])