[svn-r8588] Purpose:

    Add C++ wrappers - incrementally check-in

Description
    Added wrapper for these C APIs:
        H5Rcreate
        H5Rget_obj_type
        H5Rget_region

    This is an incremental check-in to preserve the code, corresponding
    tests will follow in a few weeks.

Platforms:
    Linux 2.4 (eirene)
    I'm checking the code out and test on arabica too.

Misc. update:

1 files changed, 19 insertions, 6 deletions

diff --git a/c++/src/H5File.h b/c++/src/H5File.h
index 3edc6a3..c1720f3 100644
--- a/c++/src/H5File.h
+++ b/c++/src/H5File.h
@@ -40,25 +40,38 @@ class H5_DLLCPP H5File : public IdComponent, public CommonFG {
 	virtual hid_t getLocId() const;
 
 	// Returns the amount of free space in the file.
-	hssize_t getFreeSpace();
+	hssize_t getFreeSpace() const;
 
 	// Returns the number of opened object IDs (files, datasets, groups 
 	// and datatypes) in the same file.
-	int getObjCount(unsigned types);
-	int getObjCount();
+	int getObjCount(unsigned types) const;
+	int getObjCount() const;
 
 	// Retrieves a list of opened object IDs (files, datasets, groups 
 	// and datatypes) in the same file.
-	void getObjIDs(unsigned types, int max_objs, hid_t *oid_list);
+	void getObjIDs(unsigned types, int max_objs, hid_t *oid_list) const;
 
 	// Returns the pointer to the file handle of the low-level file driver.
-	void getVFDHandle(FileAccPropList& fapl, void **file_handle);
-	void getVFDHandle(void **file_handle);
+	void getVFDHandle(FileAccPropList& fapl, void **file_handle) const;
+	void getVFDHandle(void **file_handle) const;
 
 	// Determines if a file, specified by its name, is in HDF5 format
 	static bool isHdf5(const string& name );
 	static bool isHdf5(const char* name );
 
+	// Creates a reference to a named Hdf5 object in this object.
+	void* Reference(const char* name) const;
+
+	// Creates a reference to a named Hdf5 object or to a dataset region 
+	// in this object.
+	void* Reference(const char* name, DataSpace& dataspace, H5R_type_t ref_type = H5R_DATASET_REGION) const;
+
+	// Retrieves the type of object that an object reference points to.
+	H5G_obj_t getObjType(void *ref, H5R_type_t ref_type) const;
+
+	// Retrieves a dataspace with the region pointed to selected.
+	DataSpace getRegion(void *ref, H5R_type_t ref_type = H5R_DATASET_REGION) const;
+
 	// Reopens this file
 	void reopen();