Man Linux: Main Page and Category List

NAME

       write_reading,  fwrite_reading  -  Write  a Read structure into a trace
       file.

SYNOPSIS

       #include <Read.h>

       int write_reading(
            char *filename,
            Read *read,
            int format);

       int fwrite_reading(
            FILE *fp,
            Read *read,
            int format);

DESCRIPTION

       These functions write a Read structure into a trace file. The principle
       format support is the SCF format. Although reading is supported for ABI
       and ALF, writing is not. Additionally, it is possible  to  write  using
       the  plain  (old)  staden  format files or as Experiment files. In both
       these cases only the sequence component  of  the  trace  file  will  be
       written.

       When  writing  as  an  experiment  file  the  QL,  QR and SQ fields are
       generated from the Read structure. If we previously  created  the  Read
       structure  from reading an experiment file then the original experiment
       file data is also written. Otherwise EN, ID, LN and LT lines  are  also
       generated.

       write_reading()  writes  a  Read structure to the specified filename in
       the specified format. Formats available are TT_SCF,  TT_PLNand  TT_EXP.
       Specifying format TT_ANY will be treated as TT_SCF.

       fwrite_reading()  writes a Read structure to the specified FILE pointer
       in the specified format. Apart from writing to FILE pointer instead  of
       a filename, the function is identical to write_reading().

RETURN VALUES

       On  successful  completion,  the  write_reading()  and fwrite_reading()
       functions return 0. Otherwise these functions return -1.

SEE ALSO

       read_reading(3), fread_reading(3), deallocate_reading(3), scf(4),
       ExperimentFile(4)

                                                              write_reading(3)