C++ API improvement

Description:
    - Reorganized some exception classes to reflect the HDF5 object
      hierarchy and provide extendibility.
        DataSetIException -> LocationException -> Exception
        DataTypeIException -> LocationException -> Exception
        GroupIException -> LocationException -> Exception
        AttributeIException -> LocationException -> Exception
        FileIException -> GroupIException -> LocationException -> Exception
    - Added throwException() to these subclasses and use it in H5Location
        and H5Object member functions to throw an exception that is specific
        to the object that invokes the member function.  Applications that
        catch the base exception can continue to do the same.
    - Many cleanup for inconsistencies in comments/headers.
Platforms tested:
    Linux/64 (jelly)
    Linux/64 (platypus)
    Darwin (osx1010test)

1 files changed, 3 insertions, 0 deletions

diff --git a/c++/src/H5DataSet.h b/c++/src/H5DataSet.h
index 09aab08..f0178f4 100644
--- a/c++/src/H5DataSet.h
+++ b/c++/src/H5DataSet.h
@@ -85,6 +85,9 @@ class H5_DLLCPP DataSet : public H5Object, public AbstractDs {
         ///\brief Returns this class name.
         virtual H5std_string fromClass () const { return("DataSet"); }
 
+        // Throw DataSetIException.
+        virtual void throwException(const H5std_string& func_name, const H5std_string& msg) const;
+
         // Creates a dataset by way of dereference.
         DataSet(const H5Location& loc, const void* ref, H5R_type_t ref_type = H5R_OBJECT);
         DataSet(const Attribute& attr, const void* ref, H5R_type_t ref_type = H5R_OBJECT);