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)