DTatotime(3dm)

NAME
     DTatotime - convert ASCII string to timecode

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

     int DTatotime(struct dttimecode* tc, const char* s)

PARAMETERS
     tc   A pointer to the struct dttimecode in which to place the result.

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

RETURNED VALUE
     DTatotime returns non-zero if the string represents a valid timecode
     otherwise it returns zero.

DESCRIPTION
     DTatotime converts an ASCII string of the form

              "00:00:00:00"


     representing a DAT time code into a struct dttimecode which 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;
              };


     Hours, minutes, seconds and frame number are each represented by 2 BCD
     digits.  This structure is the same as a struct mtaudtimecode and can be
     passed as an argument to the MTSETAUDIO ioctl used to search for time
     code locations on a tape.  Any of the following separators may be used in
     the string: :-/#|,.;* DTatotime sets as many values as there are fields
     in the string, starting with the hours value, up to the maximum of four.
     Values corresponding to unsupplied fields are set to zero.

SEE ALSO
     DTintro(3dm), DTatohmsf(3dm), DTaddcallback(3dm), DTparseframe(3dm),
     datframe(4)
AUTHOR
     Mark Callow