[svn-r584] Changes since 19980806

----------------------

./doc/html/Datatypes.html
./doc/html/H5.format.html
./src/H5.c
./src/H5Odtype.c
./src/H5T.c
./src/H5Tconv.c
./src/H5Tpkg.h
./src/H5Tpublic.h
./test/dtypes.c
	Changed the values of the H5T_str_t type in order to make a
	distinction between C's null terminated strings and strings
	which are not null terminated.

	The string character set and padding method are saved to the
	hdf5 file instead of using defaults.

	Added conversion function from one fixed-length string type
	to another.

./test/chunk.c
	Fixed to work with new filter API

2 files changed, 104 insertions, 19 deletions

diff --git a/doc/html/Datatypes.html b/doc/html/Datatypes.html
index 75bc57e..50e0ab7 100644
--- a/doc/html/Datatypes.html
+++ b/doc/html/Datatypes.html
@@ -159,8 +159,8 @@
 	type may fail if the precesion must be decremented and the
 	data type is of the <code>H5T_OPAQUE</code> class or the
 	<code>H5T_FLOAT</code> bit fields would extend beyond the
-	significant part of the type.  Increasing the size of an
-	<code>H5T_STRING</code> automatically increases the precision
+	significant part of the type.  Adjusting the size of an
+	<code>H5T_STRING</code> automatically adjusts the precision
 	as well.  On error, <code>H5Tget_size()</code> returns zero
 	which is never a valid size.
 
@@ -388,9 +388,33 @@
 	programming language: C usually null terminates strings while
 	Fortran left-justifies and space-pads strings.  This property
 	defines the storage mechanism and can be
-	<code>H5T_STR_NULL</code> for C-style strings or
-	<code>H5T_STR_SPACE</code> for Fortran-style
-	strings. <code>H5Tget_strpad()</code> returns
+
+	<p>
+	<dl>
+	  <dt><code>H5T_STR_NULLTERM</code>
+	  <dd>A C-style string which is guaranteed to be null
+	    terminated.  When converting  from a longer string the
+	    value will be truncated and then a null character
+	    appended.
+
+	    <br><br>
+	  <dt><code>H5T_STR_NULLPAD</code>
+	  <dd>A C-style string which is padded with null characters
+	    but not necessarily null terminated.  Conversion from a
+	    long string to a shorter <code>H5T_STR_NULLPAD</code>
+	    string will truncate but not null terminate.  Conversion
+	    from a short value to a longer value will append null
+	    characters as with <code>H5T_STR_NULLTERM</code>.
+
+	    <br><br>
+	  <dt><code>H5T_STR_SPACEPAD</code>
+	  <dd>A Fortran-style string which is padded with space
+	    characters.  This is the same as
+	    <code>H5T_STR_NULLPAD</code> except the padding character
+	    is a space instead of a null.
+	</dl>
+
+	<p><code>H5Tget_strpad()</code> returns
 	<code>H5T_STR_ERROR</code> on failure, a negative value (all
 	successful return values are non-negative).
     </dl>
@@ -1364,7 +1388,7 @@ H5Tregister_soft ("cus2be", H5T_INTEGER, H5T_INTEGER, cray_ushort2be);
     <address><a href="mailto:koziol@ncsa.uiuc.edu">Quincey Koziol</a></address>
 <!-- Created: Thu Dec  4 14:57:32 EST 1997 -->
 <!-- hhmts start -->
-Last modified: Thu Jun 18 13:59:12 EDT 1998
+Last modified: Fri Aug  7 10:24:52 EDT 1998
 <!-- hhmts end -->
   </body>
 </html>
diff --git a/doc/html/H5.format.html b/doc/html/H5.format.html
index fff60db..86d591c 100644
--- a/doc/html/H5.format.html
+++ b/doc/html/H5.format.html
@@ -1978,13 +1978,13 @@
 	  <th width="90%">Meaning</th>
 	</tr>
 
-	<tr>
+	<tr valign=top>
 	  <td>0</td>
 	  <td><b>Byte Order.</b> If zero, byte order is little-endian;
 	    otherwise, byte order is big endian.</td>
 	</tr>
 
-	<tr>
+	<tr valign=top>
 	  <td>1, 2</td>
 	  <td><b>Padding type.</b>  Bit 1 is the lo_pad type and bit 2
 	    is the hi_pad type.  If a datum has unused bits at either
@@ -1992,13 +1992,13 @@
 	    locations.</td>
 	</tr>
 
-	<tr>
+	<tr valign=top>
 	  <td>3</td>
 	  <td><b>Signed.</b> If this bit is set then the fixed-point
 	    number is in 2's complement form.</td>
 	</tr>
 
-	<tr>
+	<tr valign=top>
 	  <td>4-23</td>
 	  <td>Reserved (zero).</td>
 	</tr>
@@ -2038,13 +2038,13 @@
 	  <th width="90%">Meaning</th>
 	</tr>
 
-	<tr>
+	<tr valign=top>
 	  <td>0</td>
 	  <td><b>Byte Order.</b> If zero, byte order is little-endian;
 	    otherwise, byte order is big endian.</td>
 	</tr>
 
-	<tr>
+	<tr valign=top>
 	  <td>1, 2, 3</td>
 	  <td><b>Padding type.</b>  Bit 1 is the low bits pad type, bit 2
 	    is the high bits pad type, and bit 3 is the internal bits
@@ -2053,7 +2053,7 @@
 	    1, 2, or 3 is copied to those locations.</td>
 	</tr>
 
-	<tr>
+	<tr valign=top>
 	  <td>4-5</td>
 	  <td><b>Normalization.</b> The value can be 0 if there is no
 	    normalization, 1 if the most significant bit of the
@@ -2063,18 +2063,18 @@
 	    appear in this field.</td>
 	</tr>
 
-	<tr>
+	<tr valign=top>
 	  <td>6-7</td>
 	  <td>Reserved (zero).</td>
 	</tr>
 
-	<tr>
+	<tr valign=top>
 	  <td>8-15</td>
 	  <td><b>Sign.</b> This is the bit position of the sign
 	    bit.</td>
 	</tr>
 
-	<tr>
+	<tr valign=top>
 	  <td>16-23</td>
 	  <td>Reserved (zero).</td>
 	</tr>
@@ -2114,6 +2114,67 @@
       </table>
     </center>
 
+   <p>
+    <center>
+      <table border cellpadding=4 width="80%">
+	<caption align=top>
+	  <b>Bit Field for Strings (Class 3)</b>
+	</caption>
+
+	<tr align=center>
+	  <th width="10%">Bits</th>
+	  <th width="90%">Meaning</th>
+	</tr>
+
+	<tr valign=top>
+	  <td>0-3</td>
+	  <td><b>Padding type.</b>  This four-bit value determines the
+	    type of padding to use for the string.  The values are:
+
+	    <dl>
+	      <dt><code>0</code> Null terminate.
+	      <dd>A zero byte marks the end of the string and is
+		guaranteed to be present after converting a long
+		string to a short string.  When converting a short
+		string to a long string the value is padded with
+		additional null characters as necessary.
+		
+		<br><br>
+	      <dt><code>1</code> Null pad.
+	      <dd>Null characters are added to the end of the value
+		during conversions from short values to long values
+		but conversion in the opposite direction simply
+		truncates the value.
+
+		<br><br>
+	      <dt><code>2</code> Space pad.
+	      <dd>Space characters are added to the end of the value
+		during conversions from short values to long values
+		but conversion in the opposite direction simply
+		truncates the value.  This is the Fortran
+		representation of the string.
+
+		<br><br>
+	      <dt><code>3-15</code> Reserved.
+	      <dd>These values are reserved for future use.
+	    </dl>
+	</tr>
+
+	<tr valign=top>
+	  <td>4-7</td>
+	  <td><b>Character Set.</b>  The character set to use for
+	    encoding the string.  The only character set supported is
+	    the 8-bit ASCII (zero) so no translations have been defined
+	    yet.</td>
+	</tr>
+
+	<tr valign=top>
+	  <td>8-23</td>
+	  <td>Reserved (zero).</td>
+	</tr>
+      </table>
+    </center>
+
     <p>
     <center>
       <table border cellpadding=4 width="80%">
@@ -2126,7 +2187,7 @@
 	  <th width="90%">Meaning</th>
 	</tr>
 
-	<tr>
+	<tr valign=top>
 	  <td>0-15</td>
 	  <td><b>Number of Members.</b> This field contains the number
 	    of members defined for the compound data type.  The member
@@ -2134,7 +2195,7 @@
 	    type message.
 	</tr>
 
-	<tr>
+	<tr valign=top>
 	  <td>15-23</td>
 	  <td>Reserved (zero).</td>
 	</tr>
@@ -3292,7 +3353,7 @@ data-type.
 <address><a href="mailto:koziol@ncsa.uiuc.edu">Quincey Koziol</a></address>
 <address><a href="mailto:matzke@llnl.gov">Robb Matzke</a></address>
 <!-- hhmts start -->
-Last modified: Tue Aug  4 10:04:40 EDT 1998
+Last modified: Fri Aug  7 11:04:44 EDT 1998
 <!-- hhmts end -->
 </body>
 </html>