| 1 |
# @(#)AAREADME 19.1 (ESO-IPG) 02/25/03 13:57:57 |
| 2 |
******************* |
| 3 |
* Tables Version 3.0 |
| 4 |
* FO June 1990 |
| 5 |
******************* |
| 6 |
|
| 7 |
Table access routines |
| 8 |
|
| 9 |
TC - column access |
| 10 |
TD - descriptor access |
| 11 |
TE - element access |
| 12 |
TR - row access |
| 13 |
TT - table access |
| 14 |
TZx - (i = 1, ..., 8) low level routines, which are: |
| 15 |
|
| 16 |
TZ0 Deals with NULL values |
| 17 |
TZ1 Check of legal parameters (formats, etc), and compute position |
| 18 |
in buffer depending on table organisation (record / transposed) |
| 19 |
TZ2 Some string utilities |
| 20 |
TZ3 Conversions (ascii to binary and vice-versa) |
| 21 |
TZ4 error handler |
| 22 |
TZ5 Management of Table Structures |
| 23 |
TZ6 Low level Read / Write |
| 24 |
TZ8 Management of Overfolw Mechanism |
| 25 |
TZ9 Search algorithms |
| 26 |
|
| 27 |
Include files |
| 28 |
------------- |
| 29 |
tbldef.h required for applications using the tables |
| 30 |
tblsys.h only required for compilation of the above modules. |
| 31 |
Some parameters on this file may be adjusted |
| 32 |
|
| 33 |
New Features |
| 34 |
============ |
| 35 |
|
| 36 |
1. Each column may be an array. |
| 37 |
Syntax: CREA/COL table label type(n) "unit" format |
| 38 |
2. Options at TCTOPN / TCTINI : |
| 39 |
modifiers F_MAP_FORCE forces the mapping |
| 40 |
modifiers F_EIO_FORCE forces the elementary io's |
| 41 |
|
| 42 |
... + number of columns ! |
| 43 |
3. Sorting revisited |
| 44 |
4. Specify selection of lines as |
| 45 |
@a..b,c..d[,...] with ranges |
| 46 |
and selection of Columns as |
| 47 |
#1,4,3 or :x,y,.. |
| 48 |
5. New Formats available: |
| 49 |
A/ small letters generally ask for SIGNED number |
| 50 |
F12.5 applied on 12.5 results in " 12.50000" |
| 51 |
f12.5 applied on 12.5 results in " +12.50000" |
| 52 |
B/ Zero-filled values with |
| 53 |
Zx.y or zx.y |
| 54 |
C/ Sexagesimal values |
| 55 |
Sx.y or sx.y (e.g. declinations) |
| 56 |
Rx.y or rx.y (for right ascensions, factor of 15) |
| 57 |
D/ Date + Time |
| 58 |
|
| 59 |
New Entry Points |
| 60 |
================ |
| 61 |
TCBGET (tid, int column, &dtype, &items, &bytes); |
| 62 |
TCCSEL (tid, char *text, int max_cols, long &cols[], long &flags[]) |
| 63 |
TCEMAP (tid, int row, int column, &&addr, &isnull); |
| 64 |
TCOGET ("option_name", value) |
| 65 |
TCRSEL (tid, char *text, int max_ranges, long &lower[], long &upper[]) |