summaryrefslogtreecommitdiffstats
path: root/doc/html/RM_H5T.html
diff options
context:
space:
mode:
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>