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)