Debian Codegraph @

libsrc/tbl/AAREADME

raw
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[])