summaryrefslogtreecommitdiffstats
path: root/doc/html/RM_H5T.html
diff options
context:
space:
mode:
authorFrank Baker <fbaker@hdfgroup.org>2000-03-08 22:14:46 (GMT)
committerFrank Baker <fbaker@hdfgroup.org>2000-03-08 22:14:46 (GMT)
commit4d57b9df226af87f092ea6833bff13c588e80caa (patch)
tree591b9ef136c13bedea66d9f09369f7027520e7f4 /doc/html/RM_H5T.html
parentf3e7e5b438a919bd2332b062b1bfac5d426c76f6 (diff)
downloadhdf5-4d57b9df226af87f092ea6833bff13c588e80caa.zip
hdf5-4d57b9df226af87f092ea6833bff13c588e80caa.tar.gz
hdf5-4d57b9df226af87f092ea6833bff13c588e80caa.tar.bz2
[svn-r2006] RM_H5D.html
H5Dopen: Corrected description of 'loc_id' parameter. RM_H5T.html H5Tset_strpad: Corrected string padding values list (replaced 'H5T_STR_NULL & H5T_STR_SPACE' with ''H5T_STR_NULLTERM, 'H5T_STR_NULLPAD, & H5T_STR_SPACEPAD'. Added notes re conversion from shorter to longer strings and from longer to shorter strings. Other minor edits and formatting. H5Tget_class Corrected H5T_ENUM and H5T_REFERENCE entries in class identifiers table (they were reversed). Tools.html h5dump: Added note that '-bb' option is not yet implemented. Changed 'boot block' to 'super block'.
Diffstat (limited to 'doc/html/RM_H5T.html')
-rw-r--r--doc/html/RM_H5T.html39
1 files changed, 29 insertions, 10 deletions
diff --git a/doc/html/RM_H5T.html b/doc/html/RM_H5T.html
index 3dde985..f49c490 100644
--- a/doc/html/RM_H5T.html
+++ b/doc/html/RM_H5T.html
@@ -880,8 +880,8 @@ H5Tget_overflow ()
<li><code>H5T_BITFIELD</code> (<code>4</code>)
<li><code>H5T_OPAQUE</code> (<code>5</code>)
<li><code>H5T_COMPOUND</code> (<code>6</code>)
- <li><code>H5T_ENUM</code> (<code>7</code>)
- <li><code>H5T_REFERENCE</code> (<code>8</code>)
+ <li><code>H5T_REFERENCE</code> (<code>7</code>)
+ <li><code>H5T_ENUM</code> (<code>8</code>)
</ul>
<dt><strong>Parameters:</strong>
<dl>
@@ -1918,17 +1918,36 @@ zero.
<dt><strong>Purpose:</strong>
<dd>Defines the storage mechanism for character strings.
<dt><strong>Description:</strong>
- <dd>The method used to store character strings differs with the
- programming language: C usually null terminates strings while
- Fortran left-justifies and space-pads strings.
- <code>H5Tset_strpad</code> defines the storage mechanism for the string.
- Valid string padding values are:
+ <dd><code>H5Tset_strpad</code> defines the storage mechanism for the string.
+ <p>
+ The method used to store character strings differs with the
+ programming language:
+ <ul>
+ <li>C usually null terminates strings while
+ <li>Fortran left-justifies and space-pads strings.
+ </ul>
+ Valid string padding values, as passed in the parameter
+ <code>strpad</code>, are as follows:
<ul> <dl>
- <dt>H5T_STR_NULL (<code>0</code>)
- <dd>Pad with zeros (as C does)
- <dt>H5T_STR_SPACE (<code>1</code>)
+ <dt>H5T_STR_NULLTERM (<code>0</code>)
+ <dd>Null terminate (as C does)
+ <dt>H5T_STR_NULLPAD (<code>1</code>)
+ <dd>Pad with zeros
+ <dt>H5T_STR_SPACEPAD (<code>2</code>)
<dd>Pad with spaces (as FORTRAN does)
</dl> </ul>
+ <p>
+ When converting from a longer string to a shorter string,
+ the behavior is as follows.
+ If the short string is <code>H5T_STR_NULLPAD</code> or
+ <code>H5T_STR_SPACEPAD</code>, then the string is simply truncated.
+ If the short string is <code>H5T_STR_NULLTERM</code>, it is
+ truncated and a null terminator is appended.
+ <p>
+ When converting from a shorter string to a longer string,
+ the long string is padded on the end by appending nulls or spaces.
+
+
<dt><strong>Parameters:</strong>
<dl>
<dt><em>hid_t</em> <code>type_id</code>