This function can be used to register a call-back function with a FitsChan. The registered function is called when-ever the FitsChan needs to read information from a binary table contained within a FITS file. This occurs if the astRead function is invoked to read a FrameSet from a set of FITS headers that use the " -TAB" algorithm to describe one or more axes. Such axes use a FITS binary table to store a look-up table of axis values. The FitsChan will fail to read such axes unless the " TabOK" attribute is set to a non-zero positive integer value. The table containing the axis values must be made available to the FitsChan either by storing the table contents in the FitsChan (using astPutTables or astPutTable) prior to invoking astRead or by registering a call-back function using astTableSource. The first method is possibly simpler, but requires that the name of the extension containing the table be known in advance. Since the table name is embedded in the FITS headers, the name is often not known in advance. If a call-back is registered, the FitsChan will determine the name of the required table and invoke the call-back function to supply the table at the point where it is needed (i.e. within the astRead method).

void astTableSource( AstFitsChan $\ast$this, void ($\ast$ tabsource)( AstFitsChan $\ast$, const char $\ast$, int, int, int $\ast$ ) )

this

tabsource

• Application code can pass arbitrary data (such as file descriptors, etc) to the table source function using the astPutChannelData function. The source function should use the astChannelData macro to retrieve this data.