DTatohmsf(3dm)

NAME
     DTatohmsf - convert ASCII string to hours, minutes, seconds, frames

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

     int DTatohmsf(const char* str, int* h, int* m, int* s, int* f)

PARAMETERS
     str   A pointer to the ASCII string to be converted.

     h     A pointer to the location to store the hours value.

     m     A pointer to the location to store the minutes value.

     s     A pointer to the location to store the seconds value.

     f     A pointer to the location to store the frame value.

RETURNED VALUE
     DTatohmsf returns non-zero if the string represents a valid time
     otherwise it returns zero.

DESCRIPTION
     DTatohmsf converts an ASCII string of the form

              "00:00:00:00"


     representing a DAT time code, into four integers with an integer each for
     hours, minutes, seconds and frame number.  Any of the following
     separators may be used in the string: :-/#|,.;* DTatohmsf 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), DTaddcallback(3dm), DTatotime(3dm), DTframetohmsf(3dm),
     DTparseframe(3dm), datframe(4)

AUTHOR
     Doug Cook, Mark Callow