Go to the first, previous, next, last section, table of contents.


getcal

int getcal(char *desc, char *units, DB_Calinfo *cal)

Return:

0
Success; *cal contains the requested data
-1
Failure: no match found

This function attempts to find calibration data for signals of type desc, having physical units as given by units. If successful, it fills in the contents of the DB_Calinfo structure (see section Calibration Information Structures) pointed to by cal. The caller must allocate storage for the DB_Calinfo structure, and must not modify the contents of the strings addressed by the sigtype and units fields of the DB_Calinfo structure after getcal returns. getcal returns data from the first entry in the calibration list that contains a sigtype field that is either an exact match or a prefix of desc, and a units field that is an exact match of units; if either desc or units is NULL, however, it is ignored for the purpose of finding a match. getcal cannot succeed unless the calibration list has been initialized by a previous invocation of calopen or putcal. (This function was first introduced in DB library version 6.0.)


Go to the first, previous, next, last section, table of contents.



George B. Moody (george@hstbme.mit.edu)