[svn-r2897] Purpose:

	C++ API for 1.3.x branch

Description:
	The *.C and *.h files named different than those in 1.2.x.
	They are in the form: 'H5' + classname, or just classname if
	the classname is already prefixed with 'H5' to avoid ambiguity
	in documentation context.  This version has several hidden bugs
	fixed and an improvement on the reference counting approach.
	The classes and their inheritance structure are listed below:
	---------------------------------------
	H5Library
	Exception
	RefCounter
	IdComponent
		H5File
		DataSpace
		H5Object
			Group
			AbstractDs
				DataSet
				Attribute
			DataType
				PredType
				EnumType
				CompType
				AtomType
					StrType
					IntType
					FloatType
		PropList
			FileCreatPropList
			FileAccPropList
			DSetCreatPropList
			DSetMemXferPropList
	---------------------------------------
	IdComponent uses RefCounter to keep track of opened objects
	so proper termination of HDF5 objects can be maintained.
	Each class has a .h file containing the class declaration and
	a .C file containing its definition.  In addition to the classes
	files, the following files do not have class information:

	- H5Cpp.h: header file to be included in user's application
	- H5Idtemplates.h: contains a template function used by several classes
	- H5Classes.h: contains forward class declarations
	- H5CommonFG.*: contains common code used by classes H5File and Group
	- H5Include.h: contains the hdf5.h header file and the #undef RCSID
		to work around the problem: multiple defined RcsId
	- H5Alltypes.h: simply serves as a container to hold the header
		files of all datatypes to simplify the header file inclusion

Platforms:
	Solaris (arabica) and Linux

1 files changed, 136 insertions, 0 deletions

diff --git a/c++/src/H5IdComponent.C b/c++/src/H5IdComponent.C
new file mode 100644
index 0000000..2b7bff8
--- /dev/null
+++ b/c++/src/H5IdComponent.C
@@ -0,0 +1,136 @@
+#include <string>
+
+#include "H5Include.h"
+#include "H5RefCounter.h"
+#include "H5Exception.h"
+#include "H5Library.h"
+#include "H5IdComponent.h"
+#include "H5Idtemplates.h"
+
+#ifndef H5_NO_NAMESPACE
+namespace H5 {
+#endif
+
+// Default constructor - private
+IdComponent::IdComponent() : id( 0 )
+{
+   // starts counting object references
+   ref_count = new RefCounter;
+}
+
+// Constructor that takes an HDF5 object id.  It creates an instance
+// of IdComponent to hold the HDF5 id
+IdComponent::IdComponent( hid_t h5_id ) : id( h5_id )
+{
+   // starts counting object references
+   ref_count = new RefCounter;
+}
+
+// Copy constructor: makes a copy of the original object
+IdComponent::IdComponent( const IdComponent& original )
+{
+   id = original.id;
+   ref_count = original.ref_count; // points to the same ref counter
+   ref_count->increment(); // increment number of references to this id
+}
+
+// Increment reference counter
+void IdComponent::incRefCount() { ref_count->increment(); }
+
+// Decrement reference counter
+void IdComponent::decRefCount() { ref_count->decrement(); }
+
+// Get the reference counter to this identifier
+int IdComponent::getCounter() { return( ref_count->getCounter()); }
+
+// Decrements the reference counter then determines if there are no more
+// reference to this object
+bool IdComponent::noReference()
+{
+   if( ref_count->getCounter() > 0 )
+      ref_count->decrement();
+   return( ref_count->getCounter() == 0 ? true:false );
+}
+
+/* Assignment operator.
+   Description:
+   Reset the identifier of this object so that the HDF5 id can be properly
+   closed.  Copy the new identifier to this object, then increment the 
+   reference counter of the identifier to indicate that another object 
+   is referencing the identifier.
+*/
+IdComponent& IdComponent::operator=( const IdComponent& rhs )
+{
+   // reset the identifier of this object - resetIdComponent will call the 
+   // appropriate H5xclose to close the id
+   resetIdComponent( this );
+
+   // copy the data members from the rhs object
+   id = rhs.id;
+   ref_count = rhs.ref_count; // points to the same ref counter
+
+   // increment the reference counter
+   ref_count->increment();
+
+   return( *this );
+}
+
+/* Sets the identifier of this object to a new value
+   Description:
+        Reset the current identifier of this object so that the HDF5
+        id can be appropriately closed.  If only this object references
+        its identifier, its reference counter will be deleted.  A new 
+        reference counter is created for the new HDF5 object id.
+*/
+void IdComponent::setId( hid_t new_id )
+{
+   // reset the identifier of this object, call appropriate H5Xclose
+   resetIdComponent( this );
+
+   id = new_id;
+
+   // starts counting object references
+   ref_count = new RefCounter;
+}
+
+// Gets the id of this object 
+hid_t IdComponent::getId () const
+{
+   return( id );
+}
+
+// Reset this object by deleting its RefCounter
+void IdComponent::reset ()
+{
+   delete ref_count;
+}
+
+// Default destructor
+IdComponent::~IdComponent() {
+
+/* uncomment this block when decide to use dontAtExit or fix the atexit/
+   global destructor problem - BMR 11/14/00
+
+   if( id == NOTATEXIT )
+   {
+      // Call H5Library::close to clean up - temporary solution to avoid the
+      // trouble of atexit/global destructors
+      try {
+         if( H5Library::need_cleanup == true )
+         {
+            H5Library::close();
+            H5Library::need_cleanup = false; // reset the boolean just in case
+         }
+      }
+      // catch failure caused by the H5Library operations
+      catch( LibraryIException error )
+      {
+         error.printError();
+      }
+   }
+*/
+}
+
+#ifndef H5_NO_NAMESPACE
+}
+#endif