[svn-r6127] Purpose:

Added description of API testing for H5Tget_native_type().
author: Quincey Koziol <koziol@hdfgroup.org> 2002-11-20 18:19:56 (GMT)
committer: Quincey Koziol <koziol@hdfgroup.org> 2002-11-20 18:19:56 (GMT)
commit: 6d83499230308dd88854a8e1a0fd31fd2783ff39 (patch)
tree: 7937d3c8f1bb1dfad1505177547f1f937e20b0fc /doc
parent: 71d1ebea7a8a8cdfb33f1c963493a77c2a978d6b (diff)
download: hdf5-6d83499230308dd88854a8e1a0fd31fd2783ff39.zip
hdf5-6d83499230308dd88854a8e1a0fd31fd2783ff39.tar.gz
hdf5-6d83499230308dd88854a8e1a0fd31fd2783ff39.tar.bz2
1 files changed, 522 insertions, 0 deletions
diff --git a/doc/html/TechNotes/TestReview/H5Tget_native_type.html b/doc/html/TechNotes/TestReview/H5Tget_native_type.html
new file mode 100644
index 0000000..1c6409d
--- /dev/null
+++ b/doc/html/TechNotes/TestReview/H5Tget_native_type.html
@@ -0,0 +1,522 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<HTML>
+<HEAD>
+  <TITLE>H5Dget_native_type Test Review</TITLE>
+  <META http-equiv="content-type" content="text/html; charset=ISO-8859-1">
+  <META name="author" content="Quincey Koziol">
+</HEAD>
+<body text="#000000" bgcolor="#FFFFFF">
+<STYLE type="text/css">
+OL.loweralpha { list-style-type: lower-alpha }
+OL.upperroman { list-style-type: upper-roman }
+</STYLE>
+       
+<CENTER><H1>H5Dget_native_type Test Review</H1></CENTER>
+
+<OL class="upperroman">
+
+<LI><H3><U>Purpose:</U></H3>
+<P>This document describes the API test review results for <a href="../../RM_H5T.html#Datatype-GetNativeType">H5Dget_native_type</a>().
+</P>
+
+<LI><H3><U>Serial Review:</U></H3>
+<TABLE border="1">
+<TR>
+<TH>Test case
+</TH>
+
+<TH>Test source file
+</TH>
+
+<TH>Test method
+</TH>
+
+<TH>Expected test results
+</TH>
+
+<TH>Notes
+</TH>
+
+<TR>
+<TD>Native int datatype
+</TD>
+
+<TD>native.c
+</TD>
+
+<TD>
+<OL>
+<LI>Create dataset with I32BE datatype
+<LI>Query dataset's datatype
+<LI>Create native datatype from dataset datatype
+<LI>Compare order, class & size of native datatype to known results
+</OL>
+</TD>
+
+<TD>Check that type's size, order and class are correct.
+</TD>
+
+<TD>
+<P>Data is written & read back in for this test.
+</P>
+<P>It would be convenient to have a function in the test module for choosing
+the correct atomic datatype based on the particular platform settings.  This
+should use the H5_SIZEOF_<foo> macros.
+</P>
+</TD>
+
+</TR>
+
+<TR>
+<TD>Native long long datatype
+</TD>
+
+<TD>native.c
+</TD>
+
+<TD>
+<OL>
+<LI>Create dataset with I64LE datatype
+<LI>Query dataset's datatype
+<LI>Create native datatype from dataset datatype
+<LI>Compare order, class & size of native datatype to known results
+</OL>
+</TD>
+
+<TD>Check that type's size, order and class are correct.
+</TD>
+
+<TD>
+<P>Data is NOT written & read back in for this test.
+</P>
+</TD>
+
+</TR>
+
+<TR>
+<TD>Native char datatype
+</TD>
+
+<TD>native.c
+</TD>
+
+<TD>
+<OL>
+<LI>Create dataset with I8LE datatype
+<LI>Query dataset's datatype
+<LI>Create native datatype from dataset datatype
+<LI>Compare order, class & size of native datatype to known results
+</OL>
+</TD>
+
+<TD>Check that type's size, order and class are correct.
+</TD>
+
+<TD>
+<P>Data is NOT written & read back in for this test.
+</P>
+</TD>
+
+</TR>
+
+<TR>
+<TD>Native float datatype
+</TD>
+
+<TD>native.c
+</TD>
+
+<TD>
+<OL>
+<LI>Create dataset with F32BE datatype
+<LI>Query dataset's datatype
+<LI>Create native datatype from dataset datatype
+<LI>Compare order, class & size of native datatype to known results
+</OL>
+</TD>
+
+<TD>Check that type's size, order and class are correct.
+</TD>
+
+<TD>
+<P>Data is NOT written & read back in for this test.
+</P>
+<P>Need test for native double datatype (stored as 32-bit floating-point
+datatype in file).  This will probably require using an "epsilon" if the data
+is compared for this test.
+</P>
+</TD>
+
+</TR>
+
+<TR>
+<TD>Compound datatype with atomic fields
+</TD>
+
+<TD>native.c
+</TD>
+
+<TD>
+<OL>
+<LI>Create datatype describing native (unpacked) struct in memory
+<LI>Create datatype describing packed struct for disk
+<LI>Create dataset with "packed" compound datatype
+<LI>Query dataset's datatype
+<LI>Get native datatype from dataset's datatype
+<LI>Use H5Tequal to verify that the native datatype is the same as the native,
+unpacked datatype.
+</OL>
+</TD>
+
+<TD>Check that native and unpacked datatypes are equal.
+</TD>
+
+<TD>
+<P>Data is written & read back in for this test.
+</P>
+</TD>
+
+</TR>
+
+<TR>
+<TD>Compound datatype with one compound field
+</TD>
+
+<TD>native.c
+</TD>
+
+<TD>
+<OL>
+<LI>Create datatype describing nested native (unpacked) structs in memory
+<LI>Create datatype describing nested packed structs for disk
+<LI>Create dataset with "packed" compound datatype
+<LI>Query dataset's datatype
+<LI>Get native datatype from dataset's datatype
+<LI>Use H5Tequal to verify that the native datatype is the same as the native,
+unpacked datatype.
+</OL>
+</TD>
+
+<TD>Check that native and unpacked datatypes are equal.
+</TD>
+
+<TD>
+<P>Data is written & read back in for this test.
+</P>
+<P>Could use test for compound datatype with multiple compound fields.
+</P>
+<P>Could use test for 3 or more nested deep compound datatype.
+</P>
+</TD>
+
+</TR>
+
+<TR>
+<TD>Enum datatype
+</TD>
+
+<TD>native.c
+</TD>
+
+<TD>
+<OL>
+<LI>Create enum datatype
+<LI>Create dataset with enum datatype
+<LI>Query dataset's datatype
+<LI>Get native datatype from dataset's datatype
+<LI>Use H5Tequal to verify that the native datatype is the same as the original
+enum datatype.
+</OL>
+</TD>
+
+<TD>Check that native and original datatypes are equal.
+</TD>
+
+<TD>
+<P>Data is written & read back in for this test.
+</P>
+</TD>
+
+</TR>
+
+<TR>
+<TD>Array datatype
+</TD>
+
+<TD>native.c
+</TD>
+
+<TD>
+<OL>
+<LI>Create array datatype
+<LI>Create dataset with array datatype
+<LI>Query dataset's datatype
+<LI>Get native datatype from dataset's datatype
+<LI>Use H5Tequal to verify that the native datatype is the same as the original
+array datatype.
+</OL>
+</TD>
+
+<TD>Check that native and original datatypes are equal.
+</TD>
+
+<TD>
+<P><EM>This is not tested currently.</EM>
+</P>
+</TD>
+
+</TR>
+
+<TR>
+<TD>Array of compound datatype
+</TD>
+
+<TD>native.c
+</TD>
+
+<TD>
+<OL>
+<LI>Create array of compound datatype
+<LI>Create dataset with array of compound datatype
+<LI>Query dataset's datatype
+<LI>Get native datatype from dataset's datatype
+<LI>Use H5Tequal to verify that the native datatype is the same as the original
+array of compound datatype.
+</OL>
+</TD>
+
+<TD>Check that native and original datatypes are equal.
+</TD>
+
+<TD>
+<P>Data is written & read back in for this test.
+</P>
+</TD>
+
+</TR>
+
+<TR>
+<TD>Compound datatype with array field
+</TD>
+
+<TD>native.c
+</TD>
+
+<TD>
+<OL>
+<LI>Create compound datatype with array field
+<LI>Create dataset with compound datatype
+<LI>Query dataset's datatype
+<LI>Get native datatype from dataset's datatype
+<LI>Use H5Tequal to verify that the native datatype is the same as the original
+compound datatype.
+</OL>
+</TD>
+
+<TD>Check that native and original datatypes are equal.
+</TD>
+
+<TD>
+<P><EM>This is not tested currently.</EM>
+</P>
+</TD>
+
+</TR>
+
+<TR>
+<TD>VL datatype with atomic base type
+</TD>
+
+<TD>native.c
+</TD>
+
+<TD>
+<OL>
+<LI>Create VL datatype
+<LI>Create dataset with VL datatype
+<LI>Query dataset's datatype
+<LI>Get native datatype from dataset's datatype
+<LI>Use H5Tequal to verify that the native datatype is the same as the original
+VL datatype.
+</OL>
+</TD>
+
+<TD>Check that native and original datatypes are equal.
+</TD>
+
+<TD>
+<P>Data is written & read back in for this test.
+</P>
+<P><EM>Combinations with VL datatypes in other composite types and with other
+datatypes for the base type of the VL datatype are not tested.</EM>
+</P>
+</TD>
+
+</TR>
+
+<TR>
+<TD>VL string datatype
+</TD>
+
+<TD>native.c
+</TD>
+
+<TD>
+<OL>
+<LI>Create VL string datatype
+<LI>Create dataset with VL string datatype
+<LI>Query dataset's datatype
+<LI>Get native datatype from dataset's datatype
+<LI>Use H5Tequal to verify that the native datatype is the same as the original
+VL string datatype.
+</OL>
+</TD>
+
+<TD>Check that native and original datatypes are equal.
+</TD>
+
+<TD>
+<P>Data is written & read back in for this test.
+</P>
+<P><EM>Combinations with VL string datatypes in composite types 
+are not tested.</EM>
+</P>
+</TD>
+
+</TR>
+
+<TR>
+<TD>Reference datatype
+</TD>
+
+<TD>native.c
+</TD>
+
+<TD>
+<OL>
+<LI>Create reference datatype
+<LI>Create dataset with reference datatype
+<LI>Query dataset's datatype
+<LI>Get native datatype from dataset's datatype
+<LI>Use H5Tequal to verify that the native datatype is the same as the original
+reference datatype.
+</OL>
+</TD>
+
+<TD>Check that native and original datatypes are equal.
+</TD>
+
+<TD>
+<P>Data is written & read back in for this test.
+</P>
+<P><EM>Combinations with reference datatypes in composite types 
+are not tested.</EM>
+</P>
+</TD>
+
+</TR>
+
+<TR>
+<TD>Opaque datatype
+</TD>
+
+<TD>native.c
+</TD>
+
+<TD>
+<OL>
+<LI>Create opaque datatype
+<LI>Create dataset with opaque datatype
+<LI>Query dataset's datatype
+<LI>Get native datatype from dataset's datatype
+<LI>Use H5Tequal to verify that the native datatype is the same as the original
+opaque datatype.
+</OL>
+</TD>
+
+<TD>Check that native and original datatypes are equal.
+</TD>
+
+<TD>
+<P>Data is written & read back in for this test.
+</P>
+<P><EM>Combinations with opaque datatypes in composite types 
+are not tested.</EM>
+</P>
+</TD>
+
+</TR>
+
+<TR>
+<TD>Bitfield datatype
+</TD>
+
+<TD>native.c
+</TD>
+
+<TD>
+<OL>
+<LI>Create bitfield datatype
+<LI>Create dataset with bitfield datatype
+<LI>Query dataset's datatype
+<LI>Get native datatype from dataset's datatype
+<LI>Use H5Tequal to verify that the native datatype is the same as the original
+bitfield datatype.
+</OL>
+</TD>
+
+<TD>Check that native and original datatypes are equal.
+</TD>
+
+<TD>
+<P>Data is written & read back in for this test.
+</P>
+<P><EM>Combinations with bitfield datatypes in composite types 
+are not tested.</EM>
+</P>
+</TD>
+
+</TR>
+
+<TR>
+<TD>Time datatype
+</TD>
+
+<TD>native.c
+</TD>
+
+<TD>
+<OL>
+<LI>Create time datatype
+<LI>Create dataset with time datatype
+<LI>Query dataset's datatype
+<LI>Get native datatype from dataset's datatype
+<LI>Use H5Tequal to verify that the native datatype is the same as the original
+time datatype.
+</OL>
+</TD>
+
+<TD>Check that native and original datatypes are equal.
+</TD>
+
+<TD>
+<P><EM>This is not tested currently.</EM>
+</P>
+</TD>
+
+</TR>
+
+</TABLE>
+<BR>
+
+<LI><H3><U>Parallel Review:</U></H3>
+<P>The H5Dget_native_type() function is not tested in parallel.  Currently,
+there does not appear to be a need for this.
+</P>
+
+         
+</OL>
+
+</BODY>
+</HTML>
+
author	Quincey Koziol <koziol@hdfgroup.org>	2002-11-20 18:19:56 (GMT)
committer	Quincey Koziol <koziol@hdfgroup.org>	2002-11-20 18:19:56 (GMT)
commit	6d83499230308dd88854a8e1a0fd31fd2783ff39 (patch)
tree	7937d3c8f1bb1dfad1505177547f1f937e20b0fc /doc
parent	71d1ebea7a8a8cdfb33f1c963493a77c2a978d6b (diff)
download	hdf5-6d83499230308dd88854a8e1a0fd31fd2783ff39.zip hdf5-6d83499230308dd88854a8e1a0fd31fd2783ff39.tar.gz hdf5-6d83499230308dd88854a8e1a0fd31fd2783ff39.tar.bz2