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)