DTtimetoa(3dm)

NAME
     DTtimetoa - convert timecode to ASCII string

SYNOPSIS
     #include <sys/types.h>
     #include <dmedia/dataudio.h>

     void DTtimetoa(char* s, struct dttimecode *tc)

PARAMETERS
     s    A pointer to a string to store the converted value.  The string
          pointed at by s must be at least 11 bytes long not counting the
          terminating null.

     tc   A pointer to the struct dttimecode to be converted.

DESCRIPTION
     DTtimetoa converts a struct dttimecode into a printable ASCII string.  A
     struct dttimecode is defined as follows in dataudio.h :

              struct dttimecode {
                  unchar hhi:4, hlo:4;
                  unchar mhi:4, mlo:4;
                  unchar shi:4, slo:4;
                  unchar fhi:4, flo:4;
              };


     DTtimetoa converts the BCD digits into four fields in the output string
     with a one character separator between them.  DTtimetoa does not write
     the separator character.  The caller should pass DTtimetoa a string with
     the desired separators already loaded.  For example the following code
     fragment will print the time with the fields separated by a ``:''.

              char *atime = "--:--:--:--";

              DTtimetoa(atime, timecode);
              printf(atime);


SEE ALSO
     DTintro(3dm), DTatotime(3dm), DTaddcallback(3dm), DTparseframe(3dm),
     datframe(4)

AUTHOR
     Mark Callow