DtDtsBufferToAttributeList(library cDatlDlt)sBufferToAttributeList(library call)




 NAME    [Toc]    [Back]
      DtDtsBufferToAttributeList - get a list of data attributes for a byte
      stream

 SYNOPSIS    [Toc]    [Back]
      #include <Dt/Dts.h>
      DtDtsAttribute **DtDtsBufferToAttributeList(
      const void *buffer,
      const int size,
      const char *opt_name);

 DESCRIPTION    [Toc]    [Back]
      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    [Toc]    [Back]
      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    [Toc]    [Back]
      The application should use the DtDtsFreeAttributeList(3) function to
      release the memory for the returned value.

      The DtDtsBufferToAttributeList function assumes that the buffer is
      readable and writable by the user, group and other file classes and
      selects a type accordingly.  An application requiring a type based on
      read-only permissions should use DtDtsDataToDataType.

 SEE ALSO    [Toc]    [Back]
      Dt/Dts.h, DtDtsDataToDataType(3), DtDtsLoadDataTypes(3),
      DtDtsFreeAttributeList(3).


                                    - 1 -       Formatted:  January 24, 2005