DTatotime(3dm)							DTatotime(3dm)

NAME    [Toc]    [Back]

     DTatotime - convert ASCII string to timecode

SYNOPSIS    [Toc]    [Back]

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

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

PARAMETERS    [Toc]    [Back]

     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    [Toc]    [Back]

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

DESCRIPTION    [Toc]    [Back]

     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    [Toc]    [Back]

     DTintro(3dm), DTatohmsf(3dm), DTaddcallback(3dm), DTparseframe(3dm),
     datframe(4)







									Page 1






DTatotime(3dm)							DTatotime(3dm)



AUTHOR
     Mark Callow


									PPPPaaaaggggeeee 2222