[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, 77 insertions, 0 deletions

diff --git a/c++/src/H5DxferProp.h b/c++/src/H5DxferProp.h
new file mode 100644
index 0000000..2e7f51a
--- /dev/null
+++ b/c++/src/H5DxferProp.h
@@ -0,0 +1,77 @@
+#ifndef _H5DSetMemXferPropList_H
+#define _H5DSetMemXferPropList_H
+
+#ifndef H5_NO_NAMESPACE
+namespace H5 {
+#endif
+
+class DSetMemXferPropList : public PropList {
+   public:
+	static const DSetMemXferPropList DEFAULT;
+
+	// Creates a dataset memory and transfer property list
+	DSetMemXferPropList();
+
+	// Copy constructor: creates a copy of a DSetMemXferPropList object
+	DSetMemXferPropList( const DSetMemXferPropList& orig );
+
+	// Copies a dataset memory and transfer property list using 
+	// assignment statement
+	DSetMemXferPropList& operator=( const DSetMemXferPropList& rhs );
+
+	// Sets type conversion and background buffers
+	void setBuffer( size_t size, void* tconv, void* bkg ) const;
+
+	// Reads buffer settings
+	size_t getBuffer( void** tconv, void** bkg ) const;
+
+	// Sets the dataset transfer property list status to TRUE or FALSE
+	void setPreserve( bool status ) const;
+
+	// Checks status of the dataset transfer property list
+	bool getPreserve() const;
+
+	// Indicates whether to cache hyperslab blocks during I/O
+	void setHyperCache( bool cache, unsigned limit = 0 ) const;
+
+	// Returns information regarding the caching of hyperslab blocks during I/O
+	void getHyperCache( bool& cache, unsigned& limit ) const;
+
+	// Sets B-tree split ratios for a dataset transfer property list 
+	void setBtreeRatios( double left, double middle, double right ) const;
+
+	// Gets B-tree split ratios for a dataset transfer property list
+	void getBtreeRatios( double& left, double& middle, double& right ) const;
+
+	// Sets the memory manager for variable-length datatype 
+	// allocation in H5Dread and H5Dvlen_reclaim
+	void setVlenMemManager( H5MM_allocate_t alloc, void* alloc_info, 
+				H5MM_free_t free, void* free_info ) const;
+
+	// alloc and free are set to NULL, indicating that system 
+	// malloc and free are to be used
+	void setVlenMemManager() const;
+
+	// Gets the memory manager for variable-length datatype 
+	// allocation in H5Dread and H5Tvlen_reclaim
+	void getVlenMemManager( H5MM_allocate_t& alloc, void** alloc_info, 
+				H5MM_free_t& free, void** free_info ) const;
+
+	// Sets the transfer mode - parallel mode, not currently supported
+	//void setXfer( H5D_transfer_t data_xfer_mode = H5D_XFER_INDEPENDENT ) const;
+
+	// Gets the transfer mode - parallel mode, not currently supported
+	//H5D_transfer_t getXfer() const;
+
+	// Creates a copy of an existing dataset memory and transfer 
+	// property list using the property list id
+	DSetMemXferPropList (const hid_t plist_id) : PropList( plist_id ) {}
+
+	// Default destructor
+	virtual ~DSetMemXferPropList();
+
+};
+#ifndef H5_NO_NAMESPACE
+}
+#endif
+#endif