summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorAlbert Cheng <acheng@hdfgroup.org>2001-09-17 21:36:23 (GMT)
committerAlbert Cheng <acheng@hdfgroup.org>2001-09-17 21:36:23 (GMT)
commit04ed08e223b1eb9a9b9073bb07f92707b40bd2fd (patch)
treec465c1e0a924ac6bfde8b1581d171e9c804a3d51
parentee0c2bb4561c5ffc6b7d860a0670491c00f99bbe (diff)
downloadhdf5-04ed08e223b1eb9a9b9073bb07f92707b40bd2fd.zip
hdf5-04ed08e223b1eb9a9b9073bb07f92707b40bd2fd.tar.gz
hdf5-04ed08e223b1eb9a9b9073bb07f92707b40bd2fd.tar.bz2
[svn-r4445] Purpose:
Feature Description: Updated with the added feature of H5Pset_fapl_split. Added two examples too. Platforms tested: IE 5 plus eyeball.
-rw-r--r--doc/html/RM_H5P.html29
1 files changed, 29 insertions, 0 deletions
diff --git a/doc/html/RM_H5P.html b/doc/html/RM_H5P.html
index ba8347d..9a89611 100644
--- a/doc/html/RM_H5P.html
+++ b/doc/html/RM_H5P.html
@@ -3185,11 +3185,21 @@ facilitate moving easily between them.</i>
<code>fapl_id</code> is a file access property list identifier.
<p>
<code>meta_ext</code> is the filename extension for the metadata file.
+ The extension is appended to the name passed to <code>H5FDopen</code>,
+ usually from <code>H5Fcreate</code> or <code>H5Fopen</code>,
+ to form the name of the metadata file.
+ If the string %s is used in the extension, it works like the
+ name generator as in <code>H5Pset_fapl_multi</code>.
<p>
<code>meta_plist_id</code> is the file access property list identifier
for the metadata file.
<p>
<code>raw_ext</code> is the filename extension for the raw data file.
+ The extension is appended to the name passed to <code>H5FDopen</code>,
+ usually from <code>H5Fcreate</code> or <code>H5Fopen</code>,
+ to form the name of the rawdata file.
+ If the string %s is used in the extension, it works like the
+ name generator as in <code>H5Pset_fapl_multi</code>.
<p>
<code>raw_plist_id</code> is the file access property list identifier
for the raw data file.
@@ -3210,6 +3220,25 @@ facilitate moving easily between them.</i>
<dt><strong>Returns:</strong>
<dd>Returns a non-negative value if successful.
Otherwise returns a negative value.
+ <dt><strong>Example:</strong>
+ <dd>
+<pre>
+/* Example 1: Both metadata and rawdata files are in the same */
+/* directory. Use Station1-m.h5 and Station1-r.h5 as */
+/* the metadata and rawdata files. */
+hid_t fapl, fid;
+fapl = H5Pcreate(H5P_FILE_ACCESS);
+H5Pset_fapl_split(fapl, "-m.h5", H5P_DEFAULT, "-r.h5", H5P_DEFAULT);
+fid=H5Fcreate("Station1",H5F_ACC_TRUNC,H5P_DEFAULT,fapl);
+
+/* Example 2: metadata and rawdata files are in different */
+/* directories. Use PointA-m.h5 and /pfs/PointA-r.h5 as */
+/* the metadata and rawdata files. */
+hid_t fapl, fid;
+fapl = H5Pcreate(H5P_FILE_ACCESS);
+H5Pset_fapl_split(fapl, "-m.h5", H5P_DEFAULT, "/pfs/%s-r.h5", H5P_DEFAULT);
+fid=H5Fcreate("PointA",H5F_ACC_TRUNC,H5P_DEFAULT,fapl);
+</pre>
<!--
<dt><strong>Non-C API(s):</strong>
<dd><a href="fortran/h5p_FORTRAN.html#h5pxxx_f"