NAME

       FunFlush - flush data to output file

SYNOPSIS

         #include <funtools.h>

         void FunFlush(Fun fun, char *plist)

DESCRIPTION

       The  FunFlush  routine  will flush data to a FITS output file.  In particular, it can be called after all
       rows have been written (using the FunTableRowPut() routine) in order to add  the  null  padding  that  is
       required  to  complete  a  FITS  block.  It also should be called after completely writing an image using
       FunImagePut() or after writing the final row of an image using FunTableRowPut().

       The  plist  (i.e.,  parameter  list)  argument  is  a  string  containing  one  or  more  comma-delimited
       keyword=value  parameters.   If the plist string contains the parameter "copy=remainder" and the file was
       opened with a reference file, which, in turn, was opened for extension copying (i.e. the input  FunOpen()
       mode  also  was  "c"  or "C"), then FunFlush also will copy the remainder of the FITS extensions from the
       input reference file to the output file.  This normally would be done only at the end of processing.

       Note that FunFlush() is called with "copy=remainder" in the mode string by FunClose().  This  means  that
       if  you  close  the  output  file before the reference input file, it is not necessary to call FunFlush()
       explicitly, unless you are writing more than one extension.  See the evmerge example code. However, it is
       safe to call FunFlush() more than once without fear of  re-writing  either  the  padding  or  the  copied
       extensions.

       In  addition, if FunFlush() is called on an output file with the plist set to "copy=reference" and if the
       file was opened with a reference file, the reference extension is  written  to  the  output  file.   This
       mechanism provides a simple way to copy input extensions to an output file without processing the former.
       For  example,  in the code fragment below, an input extension is set to be the reference file for a newly
       opened output extension. If that reference extension is not a binary table, it is written to  the  output
       file:

         /* process each input extension in turn */
         for(ext=0; ;ext++){
           /* get new extension name */
           sprintf(tbuf, "%s[%d]", argv[1], ext);
           /* open input extension -- if we cannot open it, we are done */
           if( !(ifun=FunOpen(tbuf, "r", NULL)) )
             break;
           /* make the new extension the reference handle for the output file */
           FunInfoPut(ofun, FUN_IFUN, &ifun, 0);
           /* if its not a binary table, just write it out */
           if( !(s=FunParamGets(ifun, "XTENSION", 0, NULL, &got)) ⎪⎪
             strcmp(s, "BINTABLE")){
             if( s ) free(s);
             FunFlush(ofun, "copy=reference");
             FunClose(ifun);
             continue;
           }
           else{
             /* process binary table */
             ....
           }
         }

SEE ALSO

       See funtools(7) for a list of Funtools help pages

version 1.4.5                                    April 14, 2011                                      funflush(3)