Manipulations with database tables

The following functions implement the most typical operations with tables. Note that the table records are always treated as trace header entries. Thus the header data structures, and the styles of data storage and retrieval are essentially the same as for trace headers. 

• PDF_get_table () Returns pointer to the table with the name specified in the job file entry, and checks that the table has a specified number of arguments. If the table does not exist or does not have the necessary number of arguments, issues an error message. 
• SIA_add_table_record () Adds a new record into appropriate location in the table. The values of the new record must be stored in an argument and entry data records, according to the formats of the entries.
• SIA_copy_table () Copies the entire table into a new table. 
• SIA_define_header () Adds a new entry to the arguments or tto the entries of the table. 
• SIA_define_table () Creates a table with specified name. 
• SIA_get_header () Returns the pointer to the specified argument or dependent entry header structure. 
• SIA_get_table () Returns pointer to the table with specified name, or NULL, if the table does not exist. 
• SIA_next_table_record () Returns the pointer to the next dependent entry record in the specified table. The values of the arguments are returned in their corresponding fields aux. As with strtok (), supply the pointer to the table during the first call of 
• SIA_next_table_record (), and NULL during all subsequent calls. When the table is exhausted, the function returns NULL. 
• SIA_table_entry_value () Returns the value of the table entry, regardless whether the entry belongs to the arguments or to dependent entries. This value is returned as double. SIA_table_interp_error () Returns error status of table interpolation. 
• SIA_table_interpolate () Interpolation of a header entry value. To interpolate, put the values of all arguments into their corresponding aux.f fields. 
• SIA_table_interpolate () then returns the value of requesed dependent table entry. If the arguments lie beyond the range of the table arguments, the functions extrapolates the values. To check if this had happened, call SIA_table_interp_error (). 
• SIA_table_range() Returns the range of the values of a specified numeric argument of the table.