[svn-r4449] Purpose:

    Feature
Description:
    Added an example program showing how to use different virtual
    file drivers.  First example is to show the Split File driver.
Platforms tested:
    eirene.

1 files changed, 89 insertions, 0 deletions

diff --git a/examples/h5_drivers.c b/examples/h5_drivers.c
new file mode 100644
index 0000000..4c4d6d9
--- /dev/null
+++ b/examples/h5_drivers.c
@@ -0,0 +1,89 @@
+/*  
+ * This shows how to use the hdf5 virtual file drivers.
+ * The example codes here do not check return values for the
+ * sake of simplicity.  As in all proper programs, return codes
+ * should be checked.
+ */
+ 
+#include "hdf5.h"
+#include "stdlib.h"
+
+/* global variables */
+int cleanup_g	=	-1;	/* whether to clean.  Init to not set. */
+
+/* prototypes */
+void cleanup(const char *);
+void split_file(void);
+
+
+/*
+ * Cleanup a file unless $HDF5_NOCLEANUP is set.
+ */
+void
+cleanup(const char *filename)
+{
+    if (cleanup_g == -1)
+	cleanup_g = getenv("HDF5_NOCLEANUP") ? 0 : 1;
+    if (cleanup_g)
+	remove(filename);
+}
+
+
+/*
+ * This shows how to use the split file driver.
+ */
+void
+split_file(void)
+{
+    hid_t fapl, fid;
+
+    /* 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.                          */
+    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);
+    /* using the file ... */
+    H5Fclose(fid);
+    H5Pclose(fapl);
+    /* Remove files created */
+    cleanup("Station1-m.h5");
+    cleanup("Station1-r.h5");
+
+    /* Example 2: metadata and rawdata files are in different      */
+    /*    directories.  Use PointA-m.h5 and /tmp/PointA-r.h5 as    */
+    /*    the metadata and rawdata files.                          */
+    fapl = H5Pcreate(H5P_FILE_ACCESS);
+    H5Pset_fapl_split(fapl, "-m.h5", H5P_DEFAULT, "/tmp/%s-r.h5", H5P_DEFAULT);
+    fid=H5Fcreate("PointA",H5F_ACC_TRUNC,H5P_DEFAULT,fapl);
+    /* using the file ... */
+    H5Fclose(fid);
+    H5Pclose(fapl);
+    /* Remove files created */
+    cleanup("PointA-m.h5");
+    cleanup("/tmp/PointA-r.h5");
+
+    /* Example 3: Using default extension names for the metadata   */
+    /*    and rawdata files.  Use Measure.meta and Measure.raw as  */
+    /*    the metadata and rawdata files.                          */
+    fapl = H5Pcreate(H5P_FILE_ACCESS);
+    H5Pset_fapl_split(fapl, NULL, H5P_DEFAULT, NULL, H5P_DEFAULT);
+    fid=H5Fcreate("Measure",H5F_ACC_TRUNC,H5P_DEFAULT,fapl);
+    /* using the file ... */
+    H5Fclose(fid);
+    H5Pclose(fapl);
+    /* Remove files created */
+    cleanup("Measure.meta");
+    cleanup("Measure.raw");
+}
+
+
+/* Main Body */
+int
+main (void)
+{
+    
+    split_file();
+
+    return(0);
+}