F ALPHABETICAL LIST OF C FUNCTIONS

This section gives a complete list of the functions available via the C interface to the NDF_ library, in the form of ANSI C function prototypes. For details of each function, see the Fortran routine description in Appendix D.

For general information about the C interface, see Appendix E.

      void ndfAcget( int indf, const char $\ast$comp, int iaxis, char $\ast$value, int value_length,
 int $\ast$status );     Obtain the value of an NDF axis character component
      void ndfAclen( int indf, const char $\ast$comp, int iaxis, int $\ast$length, int $\ast$status );     Determine the length of an NDF axis character component
      void ndfAcmsg( const char $\ast$token, int indf, const char $\ast$comp, int iaxis, int $\ast$status );     Assign the value of an NDF axis character component to a message token
      void ndfAcput( const char $\ast$value, int indf, const char $\ast$comp, int iaxis, int $\ast$status );     Assign a value to an NDF axis character component
      void ndfAcre( int indf, int $\ast$status );     Ensure that an axis coordinate system exists for an NDF
      void ndfAform( int indf, const char $\ast$comp, int iaxis, char $\ast$form, int form_length,
 int $\ast$status );     Obtain the storage form of an NDF axis array
      void ndfAmap( int indf, const char $\ast$comp, int iaxis, const char $\ast$type, const char $\ast$mmod,
 void $\ast$pntr[ ], int $\ast$el, int $\ast$status );     Obtain mapped access to an NDF axis array
      void ndfAnnul( int $\ast$indf, int $\ast$status );     Annul an NDF identifier
      void ndfAnorm( int indf, int iaxis, int $\ast$norm, int $\ast$status );     Obtain the logical value of an NDF axis normalisation flag
      void ndfArest( int indf, const char $\ast$comp, int iaxis, int $\ast$status );     Reset an NDF axis component to an undefined state
      void ndfAsnrm( int norm, int indf, int iaxis, int $\ast$status );     Set a new value for an NDF axis normalisation flag
      void ndfAssoc( const char $\ast$param, const char $\ast$mode, int $\ast$indf, int $\ast$status );     Associate an existing NDF with an ADAM parameter
      void ndfAstat( int indf, const char $\ast$comp, int iaxis, int $\ast$state, int $\ast$status );     Determine the state of an NDF axis component (defined or undefined)
      void ndfAstyp( const char $\ast$type, int indf, const char $\ast$comp, int iaxis, int $\ast$status );     Set a new numeric type for an NDF axis array
      void ndfAtype( int indf, const char $\ast$comp, int iaxis, char $\ast$type, int type_length,
 int $\ast$status );     Obtain the numeric type of an NDF axis array

      void ndfAunmp( int indf, const char $\ast$comp, int iaxis, int $\ast$status );     Unmap an NDF axis array component
      void ndfBad( int indf, const char $\ast$comp, int check, int $\ast$bad, int $\ast$status );     Determine if an NDF array component may contain bad pixels
      void ndfBase( int indf1, int $\ast$indf2, int $\ast$status );     Obtain an identifier for a base NDF
      void ndfBb( int indf, unsigned char $\ast$badbit, int $\ast$status );     Obtain the bad-bits mask value for the quality component of an NDF
      void ndfBegin( void );     Begin a new NDF context
      void ndfBlock( int indf1, int ndim, const int mxdim[ ], int iblock, int $\ast$indf2, int $\ast$status );     Obtain an NDF section containing a block of adjacent pixels
      void ndfBound( int indf, int ndimx, int lbnd[ ], int ubnd[ ], int $\ast$ndim, int $\ast$status );     Enquire the pixel-index bounds of an NDF
      void ndfCancl( const char $\ast$param, int $\ast$status );     Cancel the association of an NDF with an ADAM parameter
      void ndfCget( int indf, const char $\ast$comp, char $\ast$value, int value_length, int $\ast$status );     Obtain the value of an NDF character component
      void ndfChunk( int indf1, int mxpix, int ichunk, int $\ast$indf2, int $\ast$status );     Obtain an NDF section containing a chunk of contiguous pixels
      void ndfCinp( const char $\ast$param, int indf, const char $\ast$comp, int $\ast$status );     Obtain an NDF character component value via the ADAM parameter system
      void ndfClen( int indf, const char $\ast$comp, int $\ast$length, int $\ast$status );     Determine the length of an NDF character component
      void ndfClone( int indf1, int $\ast$indf2, int $\ast$status );     Clone an NDF identifier
      void ndfCmplx( int indf, const char $\ast$comp, int $\ast$cmplx, int $\ast$status );     Determine whether an NDF array component holds complex values
      void ndfCmsg( const char $\ast$token, int indf, const char $\ast$comp, int $\ast$status );     Assign the value of an NDF character component to a message token
      void ndfCopy( int indf1, int $\ast$place, int $\ast$indf2, int $\ast$status );     Copy an NDF to a new location
      void ndfCput( const char $\ast$value, int indf, const char $\ast$comp, int $\ast$status );     Assign a value to an NDF character component
      void ndfCreat( const char $\ast$param, const char $\ast$ftype, int ndim, const int lbnd[ ],
 const int ubnd[ ], int $\ast$indf, int $\ast$status );     Create a new simple NDF via the ADAM parameter system
      void ndfCrep( const char $\ast$param, const char $\ast$ftype, int ndim, const int ubnd[ ], int $\ast$indf,
 int $\ast$status );     Create a new primitive NDF via the ADAM parameter system

      void ndfCrepl( const char $\ast$param, int $\ast$place, int $\ast$status );     Create a new NDF placeholder via the ADAM parameter system
      void ndfDelet( int $\ast$indf, int $\ast$status );     Delete an NDF
      void ndfDim( int indf, int ndimx, int dim[ ], int $\ast$ndim, int $\ast$status );     Enquire the dimension sizes of an NDF
      void ndfEnd( int $\ast$status );     End the current NDF context
      void ndfExist( const char $\ast$param, const char $\ast$mode, int $\ast$indf, int $\ast$status );     See if an existing NDF is associated with an ADAM parameter.
      void ndfFind( const char loc[ DAT__SZLOC ], const char $\ast$name, int $\ast$indf, int $\ast$status );     Find an NDF in an HDS structure and import it into the NDF_ system
      void ndfForm( int indf, const char $\ast$comp, char $\ast$form, int form_length, int $\ast$status );     Obtain the storage form of an NDF array component
      void ndfFtype( int indf, const char $\ast$comp, char $\ast$ftype, int ftype_length, int $\ast$status );     Obtain the full type of an NDF array component
void ndfGtdlt( int ndf, const char $\ast$comp, int $\ast$zaxis, char $\ast$ztype, int ztype_length, float $\ast$zratio, int $\ast$status );
    Get compression details for a DELTA compressed NDF array component
      void ndfGtszd( int indf, const char $\ast$comp, double $\ast$scale, double $\ast$zero, int $\ast$status );     Get scale and zero factors for a scaled array in an NDF
      void ndfGtszi( int indf, const char $\ast$comp, int $\ast$scale, int $\ast$zero, int $\ast$status );     Get scale and zero factors for a scaled array in an NDF
      void ndfGtszr( int indf, const char $\ast$comp, float $\ast$scale, float $\ast$zero, int $\ast$status );     Get scale and zero factors for a scaled array in an NDF
      void ndfGtune( const char $\ast$tpar, int $\ast$value, int $\ast$status );     Obtain the value of an NDF_ system tuning parameter
      void ndfGtwcs( int indf, AstFrameSet $\ast \ast$iwcs, int $\ast$status );     Obtain world coordinate system information from an NDF
      void ndfHappn( const char $\ast$appn, int $\ast$status );     Declare a new application name for NDF history recording
      void ndfHcopy( int indf1, int indf2, int $\ast$status );     Copy history information from one NDF to another
      void ndfHcre( int indf, int $\ast$status );     Ensure that a history component exists for an NDF
      void ndfHdef( int indf, const char $\ast$appn, int $\ast$status );     Write default history information to an NDF
      void ndfHecho( int nlines, char $\ast$const text[ ], int $\ast$status );     Write out lines of history text
      void ndfHend( int $\ast$status );     End NDF history recording for the current application
      void ndfHfind( int indf, const int ymdhm[ 5 ], float sec, int eq, int $\ast$irec, int $\ast$status );     Find an NDF history record by date and time
      void ndfHgmod( int indf, char $\ast$hmode, int $\ast$status );     Get the history update mode for an NDF
      void ndfHinfo( int indf, const char $\ast$item, int irec, char $\ast$value, int value_length,
 int $\ast$status );     Obtain information about an NDF’s history component
      void ndfHnrec( int indf, int $\ast$nrec, int $\ast$status );     Determine the number of NDF history records present
      void ndfHout( int indf, int irec, void ( $\ast$routin )( int, char $\ast$const [ ], int $\ast$ ), int $\ast$status );     Display text from an NDF history record

      void ndfHpurg( int indf, int irec1, int irec2, int $\ast$status );     Delete a range of records from an NDF history component
      void ndfHput( const char $\ast$hmode, const char $\ast$appn, int repl, int nlines,
 char $\ast$const text[ ], int trans, int wrap, int rjust, int indf, int $\ast$status );     Write history information to an NDF
      void ndfHsmod( const char $\ast$hmode, int indf, int $\ast$status );     Set the history update mode for an NDF
      void ndfHsdat(const char $\ast$datee, int indf, int $\ast$status );     Set the date and time for the next history record in an NDF
      void ndfIsacc( int indf, const char $\ast$access, int $\ast$isacc, int $\ast$status );     Determine whether a specified type of NDF access is available
      void ndfIsbas( int indf, int $\ast$isbas, int $\ast$status );     Enquire if an NDF is a base NDF
      void ndfIsin( int indf1, int indf2, int *isin, int $\ast$status );     Enquire if one NDF is contained within another NDF
      void ndfIstmp( int indf, int $\ast$istmp, int $\ast$status );     Determine if an NDF is temporary
      void ndfLoc( int indf, const char $\ast$mode, char loc[ DAT__SZLOC ], int $\ast$status );     Obtain an HDS locator for an NDF
      void ndfMap( int indf, const char $\ast$comp, const char $\ast$type, const char $\ast$mmod,
 void $\ast$pntr[ ], int $\ast$el, int $\ast$status );     Obtain mapped access to an array component of an NDF
      void ndfMapql( int indf, int $\ast \ast$pntr, int $\ast$el, int $\ast$bad, int $\ast$status );     Map the quality component of an NDF as an array of logical values
      void ndfMapz( int indf, const char $\ast$comp, const char $\ast$type, const char $\ast$mmod,
 void $\ast$rpntr[ ], void $\ast$ipntr[ ], int $\ast$el, int $\ast$status );     Obtain complex mapped access to an array component of an NDF
      void ndfMbad( int badok, int indf1, int indf2, const char $\ast$comp, int check, int $\ast$bad,
 int $\ast$status );     Merge the bad-pixel flags of the array components of a pair of NDFs
      void ndfMbadn( int badok, int n, const int ndfs[ ], const char $\ast$comp, int check, int $\ast$bad,
 int $\ast$status );     Merge the bad-pixel flags of the array components of a number of NDFs
      void ndfMbnd( const char $\ast$option, int $\ast$indf1, int $\ast$indf2, int $\ast$status );     Match the pixel-index bounds of a pair of NDFs
      void ndfMbndn( const char $\ast$option, int n, int ndfs[ ], int $\ast$status );     Match the pixel-index bounds of a number of NDFs
      void ndfMsg( const char $\ast$token, int indf );     Assign the name of an NDF to a message token
      void ndfMtype( const char $\ast$typlst, int indf1, int indf2, const char $\ast$comp, char $\ast$itype,
 int itype_length, char $\ast$dtype, int dtype_length, int $\ast$status );     Match the types of the array components of a pair of NDFs

      void ndfMtypn( const char $\ast$typlst, int n, const int ndfs[ ], const char $\ast$comp, char $\ast$itype,
 int itype_length, char $\ast$dtype, int dtype_length, int $\ast$status );     Match the types of the array components of a number of NDFs
      void ndfNbloc( int indf, int ndim, const int mxdim[ ], int $\ast$nblock, int $\ast$status );     Determine the number of blocks of adjacent pixels in an NDF
      void ndfNchnk( int indf, int mxpix, int $\ast$nchunk, int $\ast$status );     Determine the number of chunks of contiguous pixels in an NDF
      void ndfNew( const char $\ast$ftype, int ndim, const int lbnd[ ], const int ubnd[ ], int $\ast$place,
 int $\ast$indf, int $\ast$status );     Create a new simple NDF
      void ndfNewp( const char $\ast$ftype, int ndim, const int ubnd[ ], int $\ast$place, int $\ast$indf,
 int $\ast$status );     Create a new primitive NDF
      void ndfNoacc( const char $\ast$access, int indf, int $\ast$status );     Disable a specified type of access to an NDF
      void ndfOpen( const char loc[ DAT__SZLOC ], const char $\ast$name, const char $\ast$mode,
 const char $\ast$stat, int $\ast$indf, int $\ast$place, int $\ast$status );     Open an existing or new NDF
      void ndfPlace( const char loc[ DAT__SZLOC ], const char $\ast$name, int $\ast$place, int $\ast$status );     Obtain an NDF placeholder
      void ndfProp( int indf1, const char $\ast$clist, const char $\ast$param, int $\ast$indf2, int $\ast$status );     Propagate NDF information to create a new NDF via the ADAM parameter system
      void ndfPtszd( double scale, double zero, int indf, const char $\ast$comp, int $\ast$status );     Store new scale and zero factors for a scaled array in an NDF
      void ndfPtszi( int scale, int zero, int indf, const char $\ast$comp, int $\ast$status );     Store new scale and zero factors for a scaled array in an NDF
      void ndfPtszr( float scale, float zero, int indf, const char $\ast$comp, int $\ast$status );     Store new scale and zero factors for a scaled array in an NDF
      void ndfPtwcs( AstFrameSet $\ast$iwcs, int indf, int $\ast$status );     Store world coordinate system information in an NDF
      int ndfQmask( unsigned char qual, unsigned char badbit );     Combine an NDF quality value with a bad-bits mask to give a logical result
      void ndfQmf( int indf, int $\ast$qmf, int $\ast$status );     Obtain the value of an NDF’s quality masking flag
      void ndfReset( int indf, const char $\ast$comp, int $\ast$status );     Reset an NDF component to an undefined state
      void ndfSame( int indf1, int indf2, int $\ast$same, int $\ast$isect, int $\ast$status );     Enquire if two NDFs are part of the same base NDF
      void ndfSbad( int bad, int indf, const char $\ast$comp, int $\ast$status );     Set the bad-pixel flag for an NDF array component
      void ndfSbb( signed char badbit, int indf, int $\ast$status );     Set a bad-bits mask value for the quality component of an NDF
      void ndfSbnd( int ndim, const int lbnd[ ], const int ubnd[ ], int indf, int $\ast$status );     Set new pixel-index bounds for an NDF
      void ndfScopy( int indf1, const char $\ast$clist, int $\ast$place, int $\ast$indf2, int $\ast$status );     Selectively copy NDF components to a new location
      void ndfSctyp( int indf, const char $\ast$comp, char $\ast$type, int type_length, int $\ast$status );     Obtain the numeric type of a scaled NDF array component

      void ndfSect( int indf1, int ndim, const int lbnd[ ], const int ubnd[ ], int $\ast$indf2,
 int $\ast$status );     Create an NDF section
      void ndfShift( int nshift, const int shift[ ], int indf, int $\ast$status );     Apply pixel-index shifts to an NDF
      void ndfSize( int indf, int $\ast$npix, int $\ast$status );     Determine the size of an NDF
      void ndfSqmf( int qmf, int indf, int $\ast$status );     Set a new logical value for an NDF’s quality masking flag
      void ndfSsary( int iary1, int indf, int $\ast$iary2, int $\ast$status );     Create an array section, using an NDF section as a template
      void ndfState( int indf, const char $\ast$comp, int $\ast$state, int $\ast$status );     Determine the state of an NDF component (defined or undefined)
      void ndfStype( const char $\ast$ftype, int indf, const char $\ast$comp, int $\ast$status );     Set a new type for an NDF array component
      void ndfTemp( int $\ast$place, int $\ast$status );     Obtain a placeholder for a temporary NDF
      void ndfTune( int value, const char $\ast$tpar, int $\ast$status );     Set an NDF_ system tuning parameter
      void ndfType( int indf, const char $\ast$comp, char $\ast$type, int type_length, int $\ast$status );     Obtain the numeric type of an NDF array component
      void ndfUnmap( int indf, const char $\ast$comp, int $\ast$status );     Unmap an NDF or a mapped NDF array
      void ndfValid( int indf, int $\ast$valid, int $\ast$status );     Determine whether an NDF identifier is valid
      void ndfXdel( int indf, const char $\ast$xname, int $\ast$status );     Delete a specified NDF extension
      void ndfXgt0c( int indf, const char $\ast$xname, const char $\ast$cmpt, char $\ast$value, int value_length,
 int $\ast$status );     Read a scalar character string from a component within a named NDF extension
      void ndfXgt0d( int indf, const char $\ast$xname, const char $\ast$cmpt, double $\ast$value, int $\ast$status );     Read a scalar double precision value from a component within a named NDF extension
      void ndfXgt0i( int indf, const char $\ast$xname, const char $\ast$cmpt, int $\ast$value, int $\ast$status );     Read a scalar integer value from a component within a named NDF extension
      void ndfXgt0l( int indf, const char $\ast$xname, const char $\ast$cmpt, int $\ast$value, int $\ast$status );     Read a scalar logical value from a component within a named NDF extension
      void ndfXgt0r( int indf, const char $\ast$xname, const char $\ast$cmpt, float $\ast$value, int $\ast$status );     Read a scalar single precision value from a component within a named NDF extension

      void ndfXiary( int indf, const char $\ast$xname, const char $\ast$cmpt, const char $\ast$mode, int $\ast$iary,
 int $\ast$status );     Obtain access to an array stored in an NDF extension
      void ndfXloc( int indf, const char $\ast$xname, const char $\ast$mode, char loc[ DAT__SZLOC ],
 int $\ast$status );     Obtain access to a named NDF extension via an HDS locator
      void ndfXname( int indf, int n, char $\ast$xname, int xname_length, int $\ast$status );     Obtain the name of the N’th extension in an NDF
      void ndfXnew( int indf, const char $\ast$xname, const char $\ast$type, int ndim, const int dim[ ],
 char loc[ DAT__SZLOC ], int $\ast$status );     Create a new extension in an NDF
      void ndfXnumb( int indf, int $\ast$nextn, int $\ast$status );     Determine the number of extensions in an NDF
      void ndfXpt0c( const char $\ast$value, int indf, const char $\ast$xname, const char $\ast$cmpt,
 int $\ast$status );     Write a scalar character string to a component within a named NDF extension
      void ndfXpt0d( double value, int indf, const char $\ast$xname, const char $\ast$cmpt, int $\ast$status );     Write a scalar double precision value to a component within a named NDF extension
      void ndfXpt0i( int value, int indf, const char $\ast$xname, const char $\ast$cmpt, int $\ast$status );     Write a scalar integer value to a component within a named NDF extension
      void ndfXpt0l( int value, int indf, const char $\ast$xname, const char $\ast$cmpt, int $\ast$status );     Write a scalar logical value to a component within a named NDF extension
      void ndfXpt0r( float value, int indf, const char $\ast$xname, const char $\ast$cmpt, int $\ast$status );     Write a scalar single precision value to a component within a named NDF extension
      void ndfXstat( int indf, const char $\ast$xname, int $\ast$there, int $\ast$status );     Determine if a named NDF extension exists
      void ndfZscal( int indf1,const char $\ast$type, double scale[ 2 ], double zero[ 2 ], int $\ast$place, int $\ast$indf2, int *status );     Create a compressed copy of an NDF using SCALE compression