DTatotime(3dm)DTatotime(3dm)NAMEDTatotime - 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 VALUEDTatotime returns non-zero if the string represents a valid timecode
otherwise it returns zero.
DESCRIPTIONDTatotime 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 ALSODTintro(3dm), DTatohmsf(3dm), DTaddcallback(3dm), DTparseframe(3dm),
datframe(4)
Page 1
DTatotime(3dm)DTatotime(3dm)AUTHOR
Mark Callow
Page 2
