NAME

DtDtsBufferToAttributeList − get a list of data attributes for a byte stream

SYNOPSIS

#include <Dt/Dts.h>
DtDtsAttribute ∗∗DtDtsBufferToAttributeList(const void ∗buffer,
const int size,
const char ∗opt_name);

DESCRIPTION

The DtDtsBufferToAttributeList() function returns a list of data attributes for a given byte stream.

The buffer argument is a pointer to the buffer of the data to be typed. 

The size argument is the size of the buffer in bytes. 

The opt_name argument can be used to specify a name to be associated with the buffer.  If the opt_name argument is not NULL, it is used as a pseudo file name in typing; otherwise, certain attributes may be returned as NULL because the filename components could not be determined. 

RETURN VALUE

Upon successful completion, the DtDtsBufferToAttributeList() function returns a NULL-terminated array of pointers of ∗DtDtsAttribute.  If no value could be determined, it returns NULL. 

APPLICATION USAGE

The application should use the DtDtsFreeAttributeList(3) function to release the memory for the returned value. 

SEE ALSO

DtDts(5), DtDtsLoadDataTypes(3), DtDtsFreeAttributeList(3). 

  —  15 Jun 1994