[svn-r3621] This commit was manufactured by cvs2svn to create branch 'hdf5_1_4'.

doc/html/Tutor/examples/java/CreateAttribute.java

@@ -0,0 +1,302 @@
+/******************************************************************
+ * CreateAttribute.java (for HDF5 tutorial lesson 7)
+ *
+ *   -- Creating and Writing a dataset attribute
+ *      (a java conversion from h5_crtatt.c)
+ *
+ ******************************************************************/
+
+import ncsa.hdf.hdf5lib.*;
+import ncsa.hdf.hdf5lib.exceptions.*;
+
+public class CreateAttribute
+{
+   public static void main(String []argv) 
+   {
+      final String FILE = "dset.h5";
+      int file_id = -1;       // file identifier 
+      int dataset_id = -1;    // dataset identifier
+      int attribute_id = -1;
+      int dataspace_id = -1;  // dataspace identifier   
+      long[] dims = new long[1];
+      int[] attr_data = new int[2];
+      int status = -1;
+       
+      // Initialize the attribute data.
+      attr_data[0] = 100;
+      attr_data[1] = 200;
+
+      // Open an existing file.
+      file_id = H5Fopen_wrap (FILE, HDF5Constants.H5F_ACC_RDWR, 
+			      HDF5Constants.H5P_DEFAULT);
+       
+      // Open an existing dataset.
+      dataset_id = H5Dopen_wrap (file_id, "/dset");
+
+      // Create the data space for the attribute.
+      dims[0] = 2;
+      dataspace_id = H5Screate_simple_wrap (1, dims, null);
+
+      // Create a dataset attribute. 
+      attribute_id = H5Acreate_wrap 
+	  (dataset_id, "attr", 
+	   H5.J2C (HDF5CDataTypes.JH5T_STD_I32BE), 
+	   dataspace_id, HDF5Constants.H5P_DEFAULT);
+        
+      // Write the attribute data. 
+      status = H5Awrite_wrap 
+	  (attribute_id,    
+	   H5.J2C (HDF5CDataTypes.JH5T_NATIVE_INT), 
+	   attr_data);
+      
+      // Close the attribute. 
+      status = H5Aclose_wrap (attribute_id);
+      
+      // Close the dataspace. 
+      status = H5Sclose_wrap (dataspace_id);
+      
+      // Close to the dataset.
+      status = H5Dclose_wrap (dataset_id);
+   
+      // Close the file. 
+      status = H5Fclose_wrap (file_id); 
+   }
+
+
+   // Help function for opening an existing file
+   public static int H5Fopen_wrap (String name, int flags, int access_id)
+   {
+      int file_id = -1;    // file identifier 
+      try 
+      {
+	 // Create a new file using default file properties.
+	 file_id = H5.H5Fopen (name, flags, access_id);
+      }
+      catch (HDF5Exception hdf5e)
+      {
+	 System.out.println 
+	     ("CreateAttribute.H5Fopen_wrap() with HDF5Exception: "
+	      + hdf5e.getMessage());
+      }
+      catch (Exception e)
+      {
+	 System.out.println 
+	     ("CreateAttribute.H5Fopen_wrap() with other Exception: " 
+	      + e.getMessage());
+      }
+      return file_id;
+   }
+
+
+   // Help function for opening an existing dataset
+   public static int H5Dopen_wrap (int loc_id, String name)
+   {
+      int dataset_id = -1;  // dataset identifier   
+   
+      try 
+      {
+	 // Opening an existing dataset
+	 dataset_id = H5.H5Dopen (loc_id, name);
+      }
+      catch (HDF5Exception hdf5e)
+      {
+	 System.out.println 
+	     ("CreateAttribute.H5Dopen_wrap() with HDF5Exception: "
+	      + hdf5e.getMessage());
+      }
+      catch (Exception e)
+      {
+	 System.out.println 
+	     ("CreateAttribute.H5Dopen_wrap() with other Exception: "
+	      + e.getMessage());
+      }
+      return dataset_id;
+   }
+    
+
+   // Create the data space for the attribute.
+   public static int H5Screate_simple_wrap (int rank, long dims[],
+					    long maxdims[])
+   {
+      int dataspace_id = -1;  // dataspace identifier   
+        
+      try 
+      {
+	 // Create the data space for the dataset.
+	 dataspace_id = H5.H5Screate_simple (rank, dims, maxdims);
+      }
+      catch (HDF5Exception hdf5e)
+      {
+	 System.out.println 
+	     ("CreateAttribute.H5Screate_simple_wrap() with HDF5Exception: "
+	      + hdf5e.getMessage());
+	 
+      }
+      catch (Exception e)
+      {
+	 System.out.println 
+	     ("CreateAttribute.H5Screate_simple_wrap() with other Exception: "
+			     + e.getMessage());
+      }
+      return dataspace_id;   
+   }
+
+
+   // Help function for creating a dataset attribute. 
+   public static int H5Acreate_wrap (int loc_id, String name, int type_id, 
+				     int space_id, int create_plist)
+   {
+      int attribute_id = -1;  // attribute identifier   
+   
+      try 
+      {
+	 // Create the dataset 
+	 attribute_id = H5.H5Acreate (loc_id, name, type_id, space_id, 
+				      create_plist);
+      }
+      catch (HDF5Exception hdf5e)
+      {
+	 System.out.println 
+	     ("CreateAttribute.H5Acreate_wrap() with HDF5Exception: "
+	      + hdf5e.getMessage());
+       }
+      catch (Exception e)
+      {
+	 System.out.println 
+	     ("CreateAttribute.H5Acreate_wrap() with other Exception: "
+	      + e.getMessage());
+      }
+      return attribute_id;
+   }
+
+
+   // Help function for writing the attribute data.
+   public static int H5Awrite_wrap (int attr_id, int mem_type_id,
+				    Object buf)
+   {
+      int status = -1;
+      
+      try 
+      {
+	 // Write the attribute data.
+	 status = H5.H5Awrite (attr_id, mem_type_id, buf);
+      }
+      catch (HDF5Exception hdf5e)
+      {
+	 System.out.println 
+	     ("CreateAttribute.H5Awrite_wrap() with HDF5Exception: " 
+	      + hdf5e.getMessage());
+      }
+      catch (Exception e)
+      {
+	 System.out.println 
+	     ("CreateAttribute.H5Awrite_wrap() with other exception: " 
+	      + e.getMessage());
+      }
+      return status;
+   }
+ 
+
+   // Help function for closing the attribute
+   public static int H5Aclose_wrap (int attribute_id)
+   {
+      int status = -1;
+      
+      try 
+      {
+	 // Close the dataset
+	 status = H5.H5Aclose (attribute_id);
+      }
+      catch (HDF5Exception hdf5e)
+      {
+	 System.out.println 
+	     ("CreateAttribute.H5Aclose_wrap() with HDF5Exception: " 
+	      + hdf5e.getMessage());
+      }
+      catch (Exception e)
+      {
+	 System.out.println 
+	     ("CreateAttribute.H5Aclose_wrap() with other exception: " 
+	      + e.getMessage());
+      }
+      return status;
+   }
+ 
+
+   // Help function for closing the dataset
+   public static int H5Dclose_wrap (int dataset_id)
+   {
+      int status = -1;
+      
+      try 
+      {
+	 // Close the dataset
+	 status = H5.H5Dclose (dataset_id);
+      }
+      catch (HDF5Exception hdf5e)
+      {
+	 System.out.println 
+	     ("CreateAttribute.H5Dclose_wrap() with HDF5Exception: " 
+	      + hdf5e.getMessage());
+      }
+      catch (Exception e)
+      {
+	 System.out.println 
+	     ("CreateAttribute.H5Dclose_wrap() with other exception: " 
+	      + e.getMessage());
+      }
+      return status;
+   }
+ 
+
+   // Help function for closing the dataspace
+   public static int H5Sclose_wrap (int dataspace_id)
+   {
+      int status = -1;
+      
+      try 
+      {
+	 // Terminate access to the data space. 
+	 status = H5.H5Sclose (dataspace_id);
+      }
+      catch (HDF5Exception hdf5e)
+      {
+	 System.out.println 
+	     ("CreateAttribute.H5Sclose_wrap() with HDF5Exception: " 
+	      + hdf5e.getMessage());
+      }
+      catch (Exception e)
+      {
+	 System.out.println 
+	     ("CreateAttribute.H5Sclose_wrap() with other exception: " 
+	      + e.getMessage());
+      }
+      return status;
+   }
+ 
+
+   // Help function for terminating access to the file. 
+   public static int H5Fclose_wrap (int file_id)
+   {
+      int status = -1;
+      
+      try 
+      {
+	 // Terminate access to the file. 
+	 status = H5.H5Fclose (file_id);
+      }
+      catch (HDF5Exception hdf5e)
+      { 
+	 System.out.println 
+	     ("CreateAttribute.H5Fclose_wrap() with HDF5Exception: " 
+	      + hdf5e.getMessage());
+      }
+      catch (Exception e)
+      {
+	 System.out.println 
+	     ("CreateAttribute.H5Fclose_wrap() with other exception: " 
+	      + e.getMessage());
+      }
+      return status;
+   }  
+}