diff options
Diffstat (limited to 'doc/html/cpplus')
| -rw-r--r-- | doc/html/cpplus/CppInterfaces.html | 1437 | ||||
| -rw-r--r-- | doc/html/cpplus/CppUserNotes.doc | bin | 136192 -> 0 bytes | |||
| -rw-r--r-- | doc/html/cpplus/CppUserNotes.pdf | bin | 55301 -> 0 bytes | |||
| -rw-r--r-- | doc/html/cpplus/Makefile.am | 17 | ||||
| -rw-r--r-- | doc/html/cpplus/Makefile.in | 485 |
5 files changed, 0 insertions, 1939 deletions
diff --git a/doc/html/cpplus/CppInterfaces.html b/doc/html/cpplus/CppInterfaces.html deleted file mode 100644 index f8f37f2..0000000 --- a/doc/html/cpplus/CppInterfaces.html +++ /dev/null @@ -1,1437 +0,0 @@ -<html> -<head> -<title>HDF5 C++ API Interfaces</title> - -<!-- #BeginLibraryItem "/ed_libs/styles_RM.lbi" --> - -<!-- - * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * - * Copyright by the Board of Trustees of the University of Illinois. * - * All rights reserved. * - * * - * This file is part of HDF5. The full HDF5 copyright notice, including * - * terms governing use, modification, and redistribution, is contained in * - * the files COPYING and Copyright.html. COPYING can be found at the root * - * of the source code distribution tree; Copyright.html can be found at the * - * root level of an installed copy of the electronic HDF5 document set and * - * is linked from the top-level documents page. It can also be found at * - * http://hdf.ncsa.uiuc.edu/HDF5/doc/Copyright.html. If you do not have * - * access to either file, you may request a copy from hdfhelp@ncsa.uiuc.edu. * - * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * - --> - -<link href="../ed_styles/RMelect.css" rel="stylesheet" type="text/css"> -<!-- #EndLibraryItem --></head> - -<body bgcolor=#FFFFFF> -<pre> - - HDF5 C++ Interfaces - =================== - -// HDF5 dataset and attribute have some common characteristics, so the -// term abstract dataset is used to name the element that can represent -// both objects, dataset and attribute. -// -// Class AbstractDs is an abstract base class, from which Attribute and -// DataSet inherit. It provides the services that are common to both -// Attribute and DataSet. It also inherits from H5Object and passes down -// the services that H5Object provides. -class AbstractDs : public H5Object - - // Gets the dataspace of this abstract dataset - pure virtual - virtual DataSpace getSpace() const = 0; - - // Gets the class of the datatype that is used by this abstract - // dataset - H5T_class_t getTypeClass() const; - - // Gets a copy of the datatype that this abstract dataset uses. - // Note that this datatype is a generic one and can only be accessed - // via generic member functions, i.e., member functions belong to - // DataType. To get specific datatype, i.e. EnumType, FloatType, - // etc..., use the specific functions, that follow, instead. - DataType getDataType() const; - - // Gets a copy of the specific datatype of this abstract dataset - EnumType getEnumType() const; - CompType getCompType() const; - IntType getIntType() const; - FloatType getFloatType() const; - StrType getStrType() const; - - // Copy constructor - AbstractDs( const AbstractDs& original ); - - virtual ~AbstractDs(); - -// end of class AbstractDs - -// Atomic datatype can be an integer, float, string, or predefined datatype. -// -// Class AtomType is a base class, from which IntType, FloatType, StrType, -// and PredType inherit. It provides the services that are common to these -// subclasses. It also inherits from DataType and passes down the -// services that are common to all the datatypes. -class AtomType : public DataType - - // Sets the total size for an atomic datatype. - void setSize( size_t size ) const; - - // Returns the byte order of an atomic datatype. - H5T_order_t getOrder( string& order_string ) const; - - // Sets the byte ordering of an atomic datatype. - void setOrder( H5T_order_t order ) const; - - // Returns the precision of an atomic datatype. - size_t getPrecision() const; - - // Sets the precision of an atomic datatype. - void setPrecision( size_t precision ) const; - - // Gets the bit offset of the first significant bit. - int getOffset() const; - - // Sets the bit offset of the first significant bit. - void setOffset( size_t offset ) const; - - // Copy constructor - AtomType( const AtomType& original ); - - virtual ~AtomType(); - -// end of class AtomType - - -// An attribute is an abstract dataset because it has some characteristics -// that a dataset also has, but not all. -// -// Class Attribute inherits from AbstractDs and provides accesses to an -// attribute. -class Attribute : public AbstractDs - - // Writes data to this attribute. - void write(const DataType& mem_type, void *buf ) const; - - // Reads data from this attribute. - void read( const DataType& mem_type, void *buf ) const; - - // Gets a copy of the dataspace for this attribute. - virtual DataSpace getSpace() const; - - // Gets the name of this attribute. - string getName( size_t buf_size ) const; - - // An attribute doesn't have the ability to iterate, simply because - // it doesn't have any attributes associated with it. Thus, the - // implementation of this member which is inherited from H5Object - // is overwritten to do nothing here. - int iterateAttrs() const; - - // Creates a copy of an existing attribute using the attribute id - Attribute( const hid_t attr_id ); - - // Copy constructor - Attribute( const Attribute& original ); - - virtual ~Attribute(); - - -// CommonFG is a protocol class. Its existence is simply to provide the -// common services that are provided by H5File and Group. The file or -// group in the context of this class is referred to as 'location'. -class CommonFG - // Creates a new group at this location. - Group createGroup( const string& name, size_t size_hint = 0 ) const; - Group createGroup( const char* name, size_t size_hint = 0 ) const; - - // Opens an existing group in a location. - Group openGroup( const string& name ) const; - Group openGroup( const char* name ) const; - - // Creates a new dataset at this location. - DataSet createDataSet( const string& name, const DataType& data_type, const DataSpace& data_space, const DSetCreatPropList& create_plist = DSetCreatPropList::DEFAULT ) const; - DataSet createDataSet( const char* name, const DataType& data_type, const DataSpace& data_space, const DSetCreatPropList& create_plist = DSetCreatPropList::DEFAULT ) const; - - // Opens an existing dataset at this location. - DataSet openDataSet( const string& name ) const; - DataSet openDataSet( const char* name ) const; - - // Creates a link of the specified type from new_name to current_name; - // both names are interpreted relative to this location. - void link( H5G_link_t link_type, const string& curr_name, const string& new_name ) const; - void link( H5G_link_t link_type, const char* curr_name, const char* new_name ) const; - - // Removes the specified name at this location. - void unlink( const string& name ) const; - void unlink( const char* name ) const; - - // Renames an HDF5 object at this location. - void move( const string& src, const string& dst ) const; - void move( const char* src, const char* dst ) const; - - // Returns information about an HDF5 object, given by its name, at this location. - void getObjinfo( const string& name, hbool_t follow_link, H5G_stat_t& statbuf ) const; - void getObjinfo( const char* name, hbool_t follow_link, H5G_stat_t& statbuf ) const; - - // Returns the name of the HDF5 object that the symbolic link points to. - string getLinkval( const string& name, size_t size ) const; - string getLinkval( const char* name, size_t size ) const; - - // Sets the comment for the HDF5 object specified by its name. - void setComment( const string& name, const string& comment ) const; - void setComment( const char* name, const char* comment ) const; - - // Retrieves comment for the HDF5 object specified by its name. - string getComment( const string& name, size_t bufsize ) const; - string getComment( const char* name, size_t bufsize ) const; - - // Mounts the file 'child' onto this location. - void mount( const string& name, H5File& child, PropList& plist ) const; - void mount( const char* name, H5File& child, PropList& plist) const; - - // Unmounts the file named 'name' from this location. - void unmount( const string& name ) const; - void unmount( const char* name ) const; - - // Iterates over the elements of this location - not implemented in - // C++ style yet - int iterateElems( const string& name, int *idx, H5G_iterate_t op, void *op_data ); - int iterateElems( const char* name, int *idx, H5G_iterate_t op, void *op_data ); - - // Opens a generic named datatype at this location - DataType openDataType( const string& name ) const; - DataType openDataType( const char* name ) const; - - // Opens a named enumeration datatype at this location - EnumType openEnumType( const string& name ) const; - EnumType openEnumType( const char* name ) const; - - // Opens a named compound datatype at this location - CompType openCompType( const string& name ) const; - CompType openCompType( const char* name ) const; - - // Opens a named integer datatype at this location - IntType openIntType( const string& name ) const; - IntType openIntType( const char* name ) const; - - // Opens a named floating-point datatype at this location - FloatType openFloatType( const string& name ) const; - FloatType openFloatType( const char* name ) const; - - // Opens a named string datatype at this location - StrType openStrType( const string& name ) const; - StrType openStrType( const char* name ) const; - - // For H5File and Group to throw appropriate exception - pure virtual - virtual void throwException() const = 0; - - // Get id of the location, either group or file - pure virtual - virtual hid_t getLocId() const = 0; - - CommonFG(); - virtual ~CommonFG(); - -// end of CommonFG declaration - - -// Class CompType inherits from DataType and provides accesses to a compound -// datatype. -class CompType : public DataType - - // Creates a new compound datatype, given the type's size. - CompType( size_t size ); - - // Creates a compound datatype using an existing id. - CompType( const hid_t existing_id ); - - // Gets the compound datatype of the specified dataset. - CompType( const DataSet& dataset ); - - // Returns the number of members in this compound datatype. - int getNmembers() const; - - // Returns the name of a member of this compound datatype. - string getMemberName( unsigned member_num ) const; - - // Returns the offset of a member of this compound datatype. - size_t getMemberOffset( unsigned memb_no ) const; - - // Returns the dimensionality of the specified member of this compound datatype. - int getMemberDims( int member_num, size_t* dims, int* perm ) const; - - // Returns the type class of the specified member of this compound - // datatype. It provides to the user a way of knowing what type - // to create another datatype of the same class. - H5T_class_t getMemberClass( unsigned member_num ) const; - - // Returns the generic datatype of the specified member in - // this compound datatype. - DataType getMemberDataType( int member_num ) const; - - // Returns the enumeration datatype of the specified member in - // this compound datatype. - EnumType getMemberEnumType( int member_num ) const; - - // Returns the compound datatype of the specified member in - // this compound datatype. - CompType getMemberCompType( int member_num ) const; - - // Returns the integer datatype of the specified member in - // this compound datatype. - IntType getMemberIntType( int member_num ) const; - - // Returns the floating-point datatype of the specified member in - // this compound datatype. - FloatType getMemberFloatType( int member_num ) const; - - // Returns the string datatype of the specified member in - // this compound datatype. - StrType getMemberStrType( int member_num ) const; - - // Adds a new member to this compound datatype. - void insertMember( const string name, size_t offset, const DataType& new_member ) const; - - // Recursively removes padding from within this compound datatype. - void pack() const; - - // Default constructor - CompType(); - - // Copy constructor - CompType( const CompType& original ); - - virtual ~CompType(); - -// end of class CompType - - -// Class DataSet inherits from AbstractDs and provides accesses to a dataset. -class DataSet : public AbstractDs - - // Gets the dataspace of this dataset. - virtual DataSpace getSpace() const; - - // Gets the creation property list of this dataset. - DSetCreatPropList getCreatePlist() const; - - // Gets the storage size of this dataset. - hsize_t getStorageSize() const; - - // Reads the data of this dataset and stores it in the provided buffer. - // The memory and file dataspaces and the transferring property list - // can be defaults. - void read( void* buf, const DataType& mem_type, const DataSpace& mem_space = DataSpace::ALL, const DataSpace& file_space = DataSpace::ALL, const DSetMemXferPropList& xfer_plist = DSetMemXferPropList::DEFAULT ) const; - - // Writes the buffered data to this dataset. - // The memory and file dataspaces and the transferring property list - // can be defaults. - void write( const void* buf, const DataType& mem_type, const DataSpace& mem_space = DataSpace::ALL, const DataSpace& file_space = DataSpace::ALL, const DSetMemXferPropList& xfer_plist = DSetMemXferPropList::DEFAULT ) const; - - // Extends the dataset with unlimited dimension. - void extend( const hsize_t* size ) const; - - // Default constructor - DataSet(); - - // Copy constructor - DataSet( const DataSet& original ); - - virtual ~DataSet(); - -// end of class DataSet - - -// Class DataSpace provides accesses to the dataspace. -class DataSpace : public IdComponent - - // Default DataSpace objects - static const DataSpace ALL; - - // Creates a dataspace object given the space type. - DataSpace( H5S_class_t type ); - - // Creates a simple dataspace. - DataSpace( int rank, const hsize_t * dims, const hsize_t * maxdims = NULL); - - // Makes copy of an existing dataspace. - void copy( const DataSpace& like_space ); - - // Determines if this dataspace is a simple one. - bool isSimple () const; - - // Sets the offset of this simple dataspace. - void offsetSimple ( const hssize_t* offset ) const; - - // Retrieves dataspace dimension size and maximum size. - int getSimpleExtentDims ( hsize_t *dims, hsize_t *maxdims = NULL ) const; - - // Gets the dimensionality of this dataspace. - int getSimpleExtentNdims () const; - - // Gets the number of elements in this dataspace. - hssize_t getSimpleExtentNpoints () const; - - // Gets the current class of this dataspace. - H5S_class_t getSimpleExtentType () const; - - // Copies the extent of this dataspace. - void extentCopy ( DataSpace& dest_space ) const; - - // Sets or resets the size of this dataspace. - void setExtentSimple( int rank, const hsize_t *current_size, const hsize_t *maximum_size = NULL ) const; - - // Removes the extent from this dataspace. - void setExtentNone () const; - - // Gets the number of elements in this dataspace selection. - hssize_t getSelectNpoints () const; - - // Get number of hyperslab blocks. - hssize_t getSelectHyperNblocks () const; - - // Gets the list of hyperslab blocks currently selected. - void getSelectHyperBlocklist( hsize_t startblock, hsize_t numblocks, hsize_t *buf ) const; - - // Gets the number of element points in the current selection. - hssize_t getSelectElemNpoints () const; - - // Retrieves the list of element points currently selected. - void getSelectElemPointlist ( hsize_t startpoint, hsize_t numpoints, hsize_t *buf ) const; - - // Gets the bounding box containing the current selection. - void getSelectBounds ( hsize_t* start, hsize_t* end ) const; - - // Selects array elements to be included in the selection for - // this dataspace. - void selectElements ( H5S_seloper_t op, const size_t num_elements, const hsize_t* coord[ ] ) const; - - // Selects the entire dataspace. - void selectAll () const; - - // Resets the selection region to include no elements. - void selectNone () const; - - // Verifies that the selection is within the extent of the dataspace. - bool selectValid () const; - - // Selects a hyperslab region to add to the current selected region. - void selectHyperslab( H5S_seloper_t op, const hsize_t *count, const hsize_t *start, const hsize_t *stride = NULL, const hsize_t *block = NULL ) const; - - // Default constructor - DataSpace(); - - // Create a dataspace object from a dataspace identifier - DataSpace( const hid_t space_id ); - - // Copy constructor - DataSpace( const DataSpace& original ); - - virtual ~DataSpace(); -// end of class DataSpace - - -// HDF5 datatype can be an atom datatype, a compound datatype, or an -// enumeration datatype. A datatype is itself a kind of HDF5 object. -// -// Class DataType provides accesses to a generic HDF5 datatype. It has -// characteristics which AtomType, CompType, and EnumType inherit. It also -// inherits from H5Object and passes down the services to its subclasses. -class DataType : public H5Object - - // Creates a datatype given its class and size. - DataType( const H5T_class_t type_class, size_t size ); - - // Copies an existing datatype to this datatype instance. - void copy( const DataType& like_type ); - - // Returns the datatype class identifier of this datatype. - H5T_class_t getClass() const; - - // Commits a transient datatype to a file; this datatype becomes - // a named datatype which can be accessed from the location. - void commit( H5Object& loc, const string& name ) const; - void commit( H5Object& loc, const char* name ) const; - - // Determines whether this datatype is a named datatype or - // a transient datatype. - bool committed() const; - - // Finds a conversion function that can handle the conversion - // of this datatype to the given datatype, dest. - H5T_conv_t find( const DataType& dest, H5T_cdata_t **pcdata ) const; - - // Converts data from this datatype into the specified datatype, dest. - void convert( const DataType& dest, size_t nelmts, void *buf, void *background, PropList& plist ) const; - - // Sets the overflow handler to a specified function. - void setOverflow(H5T_overflow_t func) const; - - // Returns a pointer to the current global overflow function. - H5T_overflow_t getOverflow(void) const; - - // Locks a datatype. - void lock() const; - - // Returns the size of this datatype. - size_t getSize() const; - - // Returns the base datatype from which a datatype is derived. - // Not implemented yet - DataType getSuper() const; - - // Registers a conversion function. - void registerFunc(H5T_pers_t pers, const string& name, const DataType& dest, H5T_conv_t func ) const; - void registerFunc(H5T_pers_t pers, const char* name, const DataType& dest, H5T_conv_t func ) const; - - // Removes a conversion function from all conversion paths. - void unregister( H5T_pers_t pers, const string& name, const DataType& dest, H5T_conv_t func ) const; - void unregister( H5T_pers_t pers, const char* name, const DataType& dest, H5T_conv_t func ) const; - - // Tags an opaque datatype. - void setTag( const string& tag ) const; - void setTag( const char* tag ) const; - - // Gets the tag associated with an opaque datatype. - string getTag() const; - - // Creates a DataType using an existing id - this datatype is - // not a predefined type - DataType( const hid_t type_id, bool predtype = false ); - - // Default constructor - DataType(); - - // Copy constructor - DataType( const DataType& original ); - - virtual ~DataType(); - -// end of class DataType - - -// Class DSetCreatPropList provides accesses to a dataset creation -// property list. -class DSetCreatPropList : public PropList - - // Default DSetCreatPropList object - static const DSetCreatPropList DEFAULT; - - // Copies a dataset creation property list using assignment statement. - DSetCreatPropList& operator=( const DSetCreatPropList& rhs ); - - // Sets the type of storage used to store the raw data for the - // dataset that uses this property list. - void setLayout( hid_t plist, H5D_layout_t layout ) const; - - // Gets the layout of the raw data storage of the data that uses this - // property list. - H5D_layout_t getLayout() const; - - // Sets the size of the chunks used to store a chunked layout dataset. - void setChunk( int ndims, const hsize_t* dim ) const; - - // Retrieves the size of the chunks used to store a chunked layout dataset. - int getChunk( int max_ndims, hsize_t* dim ) const; - - // Sets compression method and compression level - void setDeflate( int level ) const; - - // Sets a dataset fill value. - void setFillValue( DataType& fvalue_type, const void* value ) const; - - // Retrieves a dataset fill value. - void getFillValue( DataType& fvalue_type, void* value ) const; - - // Adds a filter to the filter pipeline - void setFilter( H5Z_filter_t filter, unsigned int flags, size_t cd_nelmts, const unsigned int cd_values[] ) const; - - // Returns the number of filters in the pipeline. - int getNfilters() const; - - // Returns information about a filter in a pipeline. - H5Z_filter_t getFilter( int filter_number, unsigned int& flags, size_t& cd_nelmts, unsigned int* cd_values, size_t namelen, char name[] ) const; - - // Adds an external file to the list of external files. - void setExternal( const char* name, off_t offset, hsize_t size ) const; - - // Returns the number of external files for a dataset. - int getExternalCount() const; - - // Returns information about an external file - void getExternal( unsigned idx, size_t name_size, char* name, off_t& offset, hsize_t& size ) const; - - // Creates a copy of an existing dataset creation property list - // using the property list id - DSetCreatPropList( const hid_t plist_id ); - - // Default constructor - DSetCreatPropList(); - - // Copy constructor - DSetCreatPropList( const DSetCreatPropList& original ); - - virtual ~DSetCreatPropList(); - -// end of class DSetCreatPropList - - -// Class DSetMemXferPropList provides accesses to a dataset memory and -// transfer property list. -class DSetMemXferPropList : public PropList - - // Default object for dataset memory and transfer property list - static const DSetMemXferPropList DEFAULT; - - // 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) - - // Default constructor - DSetMemXferPropList(); - - // Copy constructor - DSetMemXferPropList( const DSetMemXferPropList& original ); - - // Default destructor - virtual ~DSetMemXferPropList(); - -// end of class DSetMemXferPropList - - -class EnumType : public DataType - - // Creates an empty enumeration datatype based on a native signed - // integer type, whose size is given by size. - EnumType( size_t size ); - - // Gets the enum datatype of the specified dataset - EnumType( const DataSet& dataset ); // H5Dget_type - - // Creates a new enum datatype based on an integer datatype - EnumType( const IntType& data_type ); // H5Tenum_create - - // Inserts a new member to this enumeration type. - void insert( const string& name, void *value ) const; - void insert( const char* name, void *value ) const; - - // Returns the symbol name corresponding to a specified member - // of this enumeration datatype. - string nameOf( void *value, size_t size ) const; - - // Returns the value corresponding to a specified member of this - // enumeration datatype. - void valueOf( const string& name, void *value ) const; - void valueOf( const char* name, void *value ) const; - - // Returns the value of an enumeration datatype member - void getMemberValue( unsigned memb_no, void *value ) const; - - // Default constructor - EnumType(); - - // Creates an enumeration datatype using an existing id - EnumType( const hid_t existing_id ); - - // Copy constructor - EnumType( const EnumType& original ); - - virtual ~EnumType(); -// end of class EnumType - - -class Exception - - // Creates an exception with a detailed message - Exception( const string& message ); - - Exception( const char* message); - - // Returns the character string that describes an error specified by - // a major error number. - string getMajorString( H5E_major_t major_num ) const; - - // Returns the character string that describes an error specified by - // a minor error number. - string getMinorString( H5E_minor_t minor_num ) const; - - // Returns the detailed message set at the time the exception is thrown - string getDetailMesg() const; - - // Turns on the automatic error printing. - void setAutoPrint( H5E_auto_t func, - void* client_data ) const; - - // Turns off the automatic error printing. - static void dontPrint(); - - // Retrieves the current settings for the automatic error stack - // traversal function and its data. - void getAutoPrint( H5E_auto_t& func, - void** client_data ) const; - - // Clears the error stack for the current thread. - void clearErrorStack() const; - - // Walks the error stack for the current thread, calling the - // specified function. - void walkErrorStack( H5E_direction_t direction, - H5E_walk_t func, void* client_data ) const; - - // Default error stack traversal callback function that prints - // error messages to the specified output stream. - void walkDefErrorStack( int n, H5E_error_t& err_desc, - void* client_data ) const; - - // Prints the error stack in a default manner. - //void printError() const; - void printError( FILE* stream = NULL ) const; - - // Creates an exception with no message - Exception(); - - // copy constructor - Exception( const Exception& original ); - -// end of class Exception - - -// Class FileIException inherits from Exception to provide exception -// handling for H5File. -class FileIException : public Exception - FileIException(); - FileIException( string message ); -// end of class FileIException - - -// Class GroupIException inherits from Exception to provide exception -// handling for Group. -class GroupIException : public Exception - GroupIException(); - GroupIException( string message ); -// end of class GroupIException - - -// Class DataSpaceIException inherits from Exception to provide exception -// handling for DataSpace. -class DataSpaceIException : public Exception - DataSpaceIException(); - DataSpaceIException( string message ); -// end of class DataSpaceIException - - -// Class DataTypeIException inherits from Exception to provide exception -// handling for DataType. -class DataTypeIException : public Exception - DataTypeIException(); - DataTypeIException( string message ); -// end of class DataTypeIException - - -// Class PropListIException inherits from Exception to provide exception -// handling for PropList. -class PropListIException : public Exception - PropListIException(); - PropListIException( string message ); -// end of class PropListIException - - -// Class DataSetIException inherits from Exception to provide exception -// handling for DataSet. -class DataSetIException : public Exception - DataSetIException(); - DataSetIException( string message ); -// end of class DataSetIException - - -// Class AttributeIException inherits from Exception to provide exception -// handling for Attribute. -class AttributeIException : public Exception - AttributeIException(); - AttributeIException( string message ); -// end of class AttributeIException - - -// Class LibraryIException inherits from Exception to provide exception -// handling for H5Library. -class LibraryIException : public Exception - LibraryIException(); - LibraryIException( string message ); -// end of class LibraryIException - - -// Class IdComponentException inherits from Exception to provide exception -// handling for IdComponent. -class IdComponentException : public Exception - IdComponentException(); - IdComponentException( string message ); -// end of class IdComponentException - - -// Class FileAccPropList provides accesses to a file access property list. -class FileAccPropList : public PropList - - // Default file access property list object - static const FileAccPropList DEFAULT; - - // Copies a file access property list using assignment statement. - FileAccPropList& operator=( const FileAccPropList& rhs ); - - // Sets alignment properties of this file access property list. - void setAlignment( hsize_t threshold = 1, hsize_t alignment = 1 ) const; - - // Retrieves the current settings for alignment properties from - // this file access property list. - void getAlignment( hsize_t& threshold, hsize_t& alignment ) const; - - // Sets the meta data cache and raw data chunk cache parameters. - void setCache( int mdc_nelmts, size_t rdcc_nelmts, size_t rdcc_nbytes, double rdcc_w0 ) const; - - // Retrieves maximum sizes of data caches and the preemption - // policy value. - void getCache( int& mdc_nelmts, size_t& rdcc_nelmts, size_t& rdcc_nbytes, double& rdcc_w0 ) const; - - // Sets garbage collecting references flag. - void setGcReferences( unsigned gc_ref = 0 ) const; - - // Returns garbage collecting references setting. - unsigned getGcReferences() const; - - // Creates a copy of an existing file access property list - // using the property list id. - FileAccPropList (const hid_t plist_id); - - // Default constructor - FileAccPropList(); - - // Copy constructor - FileAccPropList( const FileAccPropList& original ); - - // Default destructor - virtual ~FileAccPropList(); - -// end of class FileAccPropList - - -// Class FileCreatPropList provides accesses to a file creation property list. -class FileCreatPropList : public PropList - - // Default file creation property list object - static const FileCreatPropList DEFAULT; - - // Copies a file creation property list using assignment statement. - FileCreatPropList& operator=( const FileCreatPropList& rhs ); - - // Retrieves version information for various parts of a file. - void getVersion( unsigned& boot, unsigned& freelist, unsigned& stab, unsigned& shhdr ) const; - - // Sets the userblock size field of a file creation property list. - void setUserblock( hsize_t size ) const; - - // Gets the size of a user block in this file creation property list. - hsize_t getUserblock() const; - - // Sets file size-of addresses and sizes. - void setSizes( size_t sizeof_addr = 4, size_t sizeof_size = 4 ) const; - - // Retrieves the size-of address and size quantities stored in a - // file according to this file creation property list. - void getSizes( size_t& sizeof_addr, size_t& sizeof_size ) const; - - // Sets the size of parameters used to control the symbol table nodes. - void setSymk( unsigned int_nodes_k, unsigned leaf_nodes_k ) const; - - // Retrieves the size of the symbol table B-tree 1/2 rank and the - // symbol table leaf node 1/2 size. - void getSymk( unsigned& int_nodes_k, unsigned& leaf_nodes_k ) const; - - // Sets the size of parameter used to control the B-trees for - // indexing chunked datasets. - void setIstorek( unsigned ik ) const; - - // Returns the 1/2 rank of an indexed storage B-tree. - unsigned getIstorek() const; - - // Creates a copy of an existing file create property list - // using the property list id. - FileCreatPropList (const hid_t plist_id); - - // Default constructor - FileCreatPropList(); - - // Copy constructor - FileCreatPropList( const FileCreatPropList& original ); - - // Default destructor - virtual ~FileCreatPropList(); - -// end of class FileCreatPropList - -// Class H5File provides accesses to an HDF5 file. It uses the services -// provided by CommonFG beside inheriting the HDF5 id management from the -// IdComponent class. -class H5File : public IdComponent, public CommonFG - - // Creates or opens an HDF5 file. The file creation and access - // property lists can be default. - H5File( const string& name, unsigned int flags, const FileCreatPropList& create_plist = FileCreatPropList::DEFAULT, const FileAccPropList& access_plist = FileAccPropList::DEFAULT ); - H5File( const char* name, unsigned int flags, const FileCreatPropList& create_plist = FileCreatPropList::DEFAULT, const FileAccPropList& access_plist = FileAccPropList::DEFAULT ); - - // Throw file exception - used by CommonFG to specifically throw - // FileIException. - virtual void throwException() 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 ); - - // Reopens this file. - void reopen(); - - // Gets the creation property list of this file. - FileCreatPropList getCreatePlist() const; - - // Gets the access property list of this file. - FileAccPropList getAccessPlist() const; - - // Copy constructor - H5File(const H5File& original ); - - virtual ~H5File(); - -// end of class H5File - - -// Class FloatType inherits from AtomType and provides accesses to a -// floating-point datatype. -class FloatType : public AtomType - - // Creates a floating-point type using a predefined type. - FloatType( const PredType& pred_type ); - - // Gets the floating-point datatype of the specified dataset. - FloatType( const DataSet& dataset ); - - // Retrieves floating point datatype bit field information. - void getFields( size_t& spos, size_t& epos, size_t& esize, size_t& mpos, size_t& msize ) const; - - // Sets locations and sizes of floating point bit fields. - void setFields( size_t spos, size_t epos, size_t esize, size_t mpos, size_t msize ) const; - - // Retrieves the exponent bias of a floating-point type. - size_t getEbias() const; - - // Sets the exponent bias of a floating-point type. - void setEbias( size_t ebias ) const; - - // Retrieves mantissa normalization of a floating-point datatype. - H5T_norm_t getNorm( string& norm_string ) const; - - // Sets the mantissa normalization of a floating-point datatype. - void setNorm( H5T_norm_t norm ) const; - - // Retrieves the internal padding type for unused bits in - // floating-point datatypes. - H5T_pad_t getInpad( string& pad_string ) const; - - // Fills unused internal floating point bits. - void setInpad( H5T_pad_t inpad ) const; - - // Default constructor - FloatType(); - - // Creates a floating-point datatype using an existing id. - FloatType( const hid_t existing_id ); - - // Copy constructor - FloatType( const FloatType& original ); - - virtual ~FloatType(); - -// end of class FloatType - - -// Class Group provides accesses to an HDF5 group. As H5File, it uses the -// services provided by CommonFG. This class also inherits from H5Object. -class Group : public H5Object, public CommonFG - public: - - // Throw group exception - used by CommonFG to specifically throw - // GroupIException. - virtual void throwException() const; - - // Default constructor - Group(); - - // Copy constructor - Group( const Group& original ); - - virtual ~Group(); - -// end of class Group - -// Class IdComponent provides a mechanism to handle reference counting -// for an identifier of any HDF5 object. -class IdComponent - // Sets the identifier of this object to a new value. - void setId( hid_t new_id ); - - // Creates an object to hold an HDF5 identifier. - IdComponent( const hid_t h5_id ); - - // Gets the value of the current HDF5 object id which is held - // by this IdComponent object. - hid_t getId () const; - - // Increment reference counter. - void incRefCount(); - - // Decrement reference counter. - void decRefCount(); - - // Get the reference counter to this identifier. - int getCounter(); - - // Decrements the reference counter then determines if there are - // no more reference to this object. - bool noReference(); - - // Reset this object by deleting its reference counter of the old id. - void reset(); - - // Copy constructor - IdComponent( const IdComponent& original ); - - // Destructor - virtual ~IdComponent(); - -}; // end class IdComponent - - -// Class IntType inherits from AtomType and provides accesses to -// integer datatypes. -class IntType : public AtomType - - // Creates a integer type using a predefined type. - IntType( const PredType& pred_type ); - - // Gets the integer datatype of the specified dataset. - IntType( const DataSet& dataset ); - - // Retrieves the sign type for an integer type. - H5T_sign_t getSign() const; - - // Sets the sign proprety for an integer type. - void setSign( H5T_sign_t sign ) const; - - // Default constructor - IntType(); - - // Creates a integer datatype using an existing id. - IntType( const hid_t existing_id ); - - // Copy constructor - IntType( const IntType& original ); - - virtual ~IntType(); - -// end of class IntType - - -// Class H5Library provides accesses to the HDF5 library. All of its -// member functions are static. -class H5Library - - // Initializes the HDF5 library. - static void open(); - - // Flushes all data to disk, closes files, and cleans up memory. - static void close(); - - // Instructs library not to install atexit cleanup routine - static void dontAtExit(); - - // Returns the HDF library release number. - static void getLibVersion( unsigned& majnum, unsigned& minnum, unsigned& relnum ); - - // Verifies that the arguments match the version numbers compiled - // into the library - static void checkVersion( unsigned majnum, unsigned minnum, unsigned relnum ); - -// end of class H5Library - - -// An HDF5 object can be a group, dataset, attribute, or named datatype. -// -// Class H5Object provides the services that are typical to an HDF5 object -// so Group, DataSet, Attribute, and DataType can use them. It also -// inherits the HDF5 id management from the class IdComponent. -class H5Object : public IdComponent - - // Flushes all buffers associated with this HDF5 object to disk. - void flush( H5F_scope_t scope ) const; - - // Creates an attribute for a group, dataset, or named datatype. - // PropList is currently not used, it should always be default. - Attribute createAttribute( const char* name, const DataType& type, const DataSpace& space, const PropList& create_plist = PropList::DEFAULT ) const; - Attribute createAttribute( const string& name, const DataType& type, const DataSpace& space, const PropList& create_plist = PropList::DEFAULT ) const; - - // Opens an attribute that belongs to this object, given the - // attribute name. - Attribute openAttribute( const string& name ) const; - Attribute openAttribute( const char* name ) const; - - // Opens an attribute that belongs to this object, given the - // attribute index. - Attribute openAttribute( const unsigned int idx ) const; - - // Iterate user's function over the attributes of this HDF5 object - int iterateAttrs( attr_operator_t user_op, unsigned* idx = NULL, void* op_data = NULL ); - - // Determines the number of attributes attached to this HDF5 object. - int getNumAttrs() const; - - // Removes an attribute from this HDF5 object, given the attribute - // name. - void removeAttr( const string& name ) const; - void removeAttr( const char* name ) const; - - // Copy constructor - H5Object( const H5Object& original ); - - virtual ~H5Object(); - -// end of class H5Object - - -// Class PredType contains all the predefined datatype objects that are -// currently available. -class PredType : public AtomType - - static const PredType STD_I8BE; - static const PredType STD_I8LE; - static const PredType STD_I16BE; - static const PredType STD_I16LE; - static const PredType STD_I32BE; - static const PredType STD_I32LE; - static const PredType STD_I64BE; - static const PredType STD_I64LE; - static const PredType STD_U8BE; - static const PredType STD_U8LE; - static const PredType STD_U16BE; - static const PredType STD_U16LE; - static const PredType STD_U32BE; - static const PredType STD_U32LE; - static const PredType STD_U64BE; - static const PredType STD_U64LE; - static const PredType STD_B8BE; - static const PredType STD_B8LE; - static const PredType STD_B16BE; - static const PredType STD_B16LE; - static const PredType STD_B32BE; - static const PredType STD_B32LE; - static const PredType STD_B64BE; - static const PredType STD_B64LE; - static const PredType STD_REF_OBJ; - static const PredType STD_REF_DSETREG; - - static const PredType C_S1; - static const PredType FORTRAN_S1; - - static const PredType IEEE_F32BE; - static const PredType IEEE_F32LE; - static const PredType IEEE_F64BE; - static const PredType IEEE_F64LE; - - static const PredType UNIX_D32BE; - static const PredType UNIX_D32LE; - static const PredType UNIX_D64BE; - static const PredType UNIX_D64LE; - - static const PredType INTEL_I8; - static const PredType INTEL_I16; - static const PredType INTEL_I32; - static const PredType INTEL_I64; - static const PredType INTEL_U8; - static const PredType INTEL_U16; - static const PredType INTEL_U32; - static const PredType INTEL_U64; - static const PredType INTEL_B8; - static const PredType INTEL_B16; - static const PredType INTEL_B32; - static const PredType INTEL_B64; - static const PredType INTEL_F32; - static const PredType INTEL_F64; - - static const PredType ALPHA_I8; - static const PredType ALPHA_I16; - static const PredType ALPHA_I32; - static const PredType ALPHA_I64; - static const PredType ALPHA_U8; - static const PredType ALPHA_U16; - static const PredType ALPHA_U32; - static const PredType ALPHA_U64; - static const PredType ALPHA_B8; - static const PredType ALPHA_B16; - static const PredType ALPHA_B32; - static const PredType ALPHA_B64; - static const PredType ALPHA_F32; - static const PredType ALPHA_F64; - - static const PredType MIPS_I8; - static const PredType MIPS_I16; - static const PredType MIPS_I32; - static const PredType MIPS_I64; - static const PredType MIPS_U8; - static const PredType MIPS_U16; - static const PredType MIPS_U32; - static const PredType MIPS_U64; - static const PredType MIPS_B8; - static const PredType MIPS_B16; - static const PredType MIPS_B32; - static const PredType MIPS_B64; - static const PredType MIPS_F32; - static const PredType MIPS_F64; - - static const PredType NATIVE_CHAR; - static const PredType NATIVE_SCHAR; - static const PredType NATIVE_UCHAR; - static const PredType NATIVE_SHORT; - static const PredType NATIVE_USHORT; - static const PredType NATIVE_INT; - static const PredType NATIVE_UINT; - static const PredType NATIVE_LONG; - static const PredType NATIVE_ULONG; - static const PredType NATIVE_LLONG; - static const PredType NATIVE_ULLONG; - static const PredType NATIVE_FLOAT; - static const PredType NATIVE_DOUBLE; - static const PredType NATIVE_LDOUBLE; - static const PredType NATIVE_B8; - static const PredType NATIVE_B16; - static const PredType NATIVE_B32; - static const PredType NATIVE_B64; - static const PredType NATIVE_OPAQUE; - static const PredType NATIVE_HSIZE; - static const PredType NATIVE_HSSIZE; - static const PredType NATIVE_HERR; - static const PredType NATIVE_HBOOL; - - static const PredType NATIVE_INT8; - static const PredType NATIVE_UINT8; - static const PredType NATIVE_INT_LEAST8; - static const PredType NATIVE_UINT_LEAST8; - static const PredType NATIVE_INT_FAST8; - static const PredType NATIVE_UINT_FAST8; - - static const PredType NATIVE_INT16; - static const PredType NATIVE_UINT16; - static const PredType NATIVE_INT_LEAST16; - static const PredType NATIVE_UINT_LEAST16; - static const PredType NATIVE_INT_FAST16; - static const PredType NATIVE_UINT_FAST16; - - static const PredType NATIVE_INT32; - static const PredType NATIVE_UINT32; - static const PredType NATIVE_INT_LEAST32; - static const PredType NATIVE_UINT_LEAST32; - static const PredType NATIVE_INT_FAST32; - static const PredType NATIVE_UINT_FAST32; - - static const PredType NATIVE_INT64; - static const PredType NATIVE_UINT64; - static const PredType NATIVE_INT_LEAST64; - static const PredType NATIVE_UINT_LEAST64; - static const PredType NATIVE_INT_FAST64; - static const PredType NATIVE_UINT_FAST64; - - // Copy constructor - PredType( const PredType& original ); - - // Default destructor - virtual ~PredType(); - - protected: - // Default constructor - PredType(); - - // Creates a pre-defined type using an HDF5 pre-defined constant - PredType( const hid_t predtype_id ); // used by the library only - -// end of class PredType - - -// An HDF5 property list can be a file creation property list, a file -// access property list, a dataset creation property list, or a dataset -// memory and transfer property list. -// -// Class PropList provides accesses to an HDF5 property list. Its -// services are inherited by classes FileCreatPropList, FileAccPropList, -// DSetCreatPropList, and DSetMemXferPropList. It also inherits the HDF5 -// id management from the class IdComponent. -class PropList : public IdComponent - - // Default property list object - static const PropList DEFAULT; - - // Creates a property list given the property list type. - PropList( H5P_class_t type ); - - // Makes a copy of the given property list. - void copy( const PropList& like_plist ); - - // Gets the class of this property list, i.e. H5P_FILE_CREATE, - // H5P_FILE_ACCESS, ... - H5P_class_t getClass() const; - - // Default constructor - PropList(); - - // Copy constructor - PropList( const PropList& original ); - - // Creates a default property list or creates a copy of an - // existing property list giving the property list id - PropList( const hid_t plist_id ); - - virtual ~PropList(); - -// end of class PropList - -// Class RefCounter provides a reference counting mechanism. It is used -// mainly by IdComponent to keep track of the references to an HDF5 object -// identifier. -class RefCounter - - // Returns the value of the counter. - int getCounter () const; - - // Increments and decrements the counter. - void increment(); - void decrement(); - - // This bool function is used to determine whether to close an - // HDF5 object when there are no more reference to that object. - // It decrements the counter, then returns true if there are no - // other object references the associated identifier. When the - // function returns true, the associated identifier can be closed - // safely. - bool noReference(); - - // Default constructor - RefCounter(); - - ~RefCounter(); - -// end of class RefCounter - - -// Class StrType inherits from AtomType and provides accesses to a -// string datatype. -class StrType : public AtomType - public: - // Creates a string type using a predefined type. - StrType( const PredType& pred_type ); - - // Gets the string datatype of the specified dataset. - StrType( const DataSet& dataset ); - - // Returns the character set type of this string datatype. - H5T_cset_t getCset() const; - - // Sets character set to be used. - void setCset( H5T_cset_t cset ) const; - - // Returns the string padding method for this string datatype. - H5T_str_t getStrpad() const; - - // Defines the storage mechanism for character strings. - void setStrpad( H5T_str_t strpad ) const; - - // Default constructor - StrType(); - - // Copy constructor - StrType( const StrType& original ); - - // Creates a string datatype using an existing id. - StrType( const hid_t existing_id ); - - virtual ~StrType(); -// end of class StrType - - -// This template function, resetIdComponent, is used to reset an -// IdComponent object, which includes closing the associated HDF5 -// identifier if it has no other references. -// 'Type' can be of the following classes: Attribute, DataSet, DataSpace, -// DataType, H5File, Group, and PropList. -template <class Type> -void resetIdComponent( - Type* obj ) // pointer to object to be reset - -</pre> - -<hr> - - -<!-- #BeginLibraryItem "/ed_libs/Footer.lbi" --><address> -<a href="mailto:hdfhelp@ncsa.uiuc.edu">HDF Help Desk</a> -<br> -Describes HDF5 Release 1.7, the unreleased development branch; working toward HDF5 Release 1.8.0 -</address><!-- #EndLibraryItem --> - -Last modified: 17 December 2000 - -</body> -</html> - diff --git a/doc/html/cpplus/CppUserNotes.doc b/doc/html/cpplus/CppUserNotes.doc Binary files differdeleted file mode 100644 index c14d3d6..0000000 --- a/doc/html/cpplus/CppUserNotes.doc +++ /dev/null diff --git a/doc/html/cpplus/CppUserNotes.pdf b/doc/html/cpplus/CppUserNotes.pdf Binary files differdeleted file mode 100644 index 7d0064f..0000000 --- a/doc/html/cpplus/CppUserNotes.pdf +++ /dev/null diff --git a/doc/html/cpplus/Makefile.am b/doc/html/cpplus/Makefile.am deleted file mode 100644 index 81af45e..0000000 --- a/doc/html/cpplus/Makefile.am +++ /dev/null @@ -1,17 +0,0 @@ -# HDF5 Library Doc Makefile(.in) -# -# Copyright (C) 1997, 2002 -# National Center for Supercomputing Applications. -# All rights reserved. -# -## -## Makefile.am -## Run automake to generate a Makefile.in from this file. -# - -include $(top_srcdir)/config/commence-doc.am - -localdocdir = $(docdir)/hdf5/cpplus - -# Public doc files (to be installed)... -localdoc_DATA=CppInterfaces.html CppUserNotes.doc CppUserNotes.pdf diff --git a/doc/html/cpplus/Makefile.in b/doc/html/cpplus/Makefile.in deleted file mode 100644 index 434d2d7..0000000 --- a/doc/html/cpplus/Makefile.in +++ /dev/null @@ -1,485 +0,0 @@ -# Makefile.in generated by automake 1.9.5 from Makefile.am. -# @configure_input@ - -# Copyright (C) 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, -# 2003, 2004, 2005 Free Software Foundation, Inc. -# This Makefile.in is free software; the Free Software Foundation -# gives unlimited permission to copy and/or distribute it, -# with or without modifications, as long as this notice is preserved. - -# This program is distributed in the hope that it will be useful, -# but WITHOUT ANY WARRANTY, to the extent permitted by law; without -# even the implied warranty of MERCHANTABILITY or FITNESS FOR A -# PARTICULAR PURPOSE. - -@SET_MAKE@ - -# HDF5 Library Doc Makefile(.in) -# -# Copyright (C) 1997, 2002 -# National Center for Supercomputing Applications. -# All rights reserved. -# -# - -srcdir = @srcdir@ -top_srcdir = @top_srcdir@ -VPATH = @srcdir@ -pkgdatadir = $(datadir)/@PACKAGE@ -pkglibdir = $(libdir)/@PACKAGE@ -pkgincludedir = $(includedir)/@PACKAGE@ -top_builddir = ../../.. -am__cd = CDPATH="$${ZSH_VERSION+.}$(PATH_SEPARATOR)" && cd -INSTALL = @INSTALL@ -install_sh_DATA = $(install_sh) -c -m 644 -install_sh_PROGRAM = $(install_sh) -c -install_sh_SCRIPT = $(install_sh) -c -INSTALL_HEADER = $(INSTALL_DATA) -transform = $(program_transform_name) -NORMAL_INSTALL = : -PRE_INSTALL = : -POST_INSTALL = : -NORMAL_UNINSTALL = : -PRE_UNINSTALL = : -POST_UNINSTALL = : -build_triplet = @build@ -host_triplet = @host@ -DIST_COMMON = $(srcdir)/Makefile.am $(srcdir)/Makefile.in \ - $(top_srcdir)/config/commence-doc.am \ - $(top_srcdir)/config/commence.am -subdir = doc/html/cpplus -ACLOCAL_M4 = $(top_srcdir)/aclocal.m4 -am__aclocal_m4_deps = $(top_srcdir)/configure.in -am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \ - $(ACLOCAL_M4) -mkinstalldirs = $(SHELL) $(top_srcdir)/bin/mkinstalldirs -CONFIG_HEADER = $(top_builddir)/src/H5config.h -CONFIG_CLEAN_FILES = -SOURCES = -DIST_SOURCES = -am__vpath_adj_setup = srcdirstrip=`echo "$(srcdir)" | sed 's|.|.|g'`; -am__vpath_adj = case $$p in \ - $(srcdir)/*) f=`echo "$$p" | sed "s|^$$srcdirstrip/||"`;; \ - *) f=$$p;; \ - esac; -am__strip_dir = `echo $$p | sed -e 's|^.*/||'`; -am__installdirs = "$(DESTDIR)$(localdocdir)" -localdocDATA_INSTALL = $(INSTALL_DATA) -DATA = $(localdoc_DATA) -DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST) - -# Set the paths for AFS installs of autotools for Linux machines -# Ideally, these tools should never be needed during the build. -ACLOCAL = /afs/ncsa/projects/hdf/packages/automake_1.9.5/Linux_2.4/bin/aclocal -I /afs/ncsa/projects/hdf/packages/libtool_1.5.14/Linux_2.4/share/aclocal -ADD_PARALLEL_FILES = @ADD_PARALLEL_FILES@ -AMDEP_FALSE = @AMDEP_FALSE@ -AMDEP_TRUE = @AMDEP_TRUE@ -AMTAR = @AMTAR@ -AM_MAKEFLAGS = @AM_MAKEFLAGS@ -AR = @AR@ -AUTOCONF = /afs/ncsa/projects/hdf/packages/autoconf_2.59/Linux_2.4/bin/autoconf -AUTOHEADER = /afs/ncsa/projects/hdf/packages/autoconf_2.59/Linux_2.4/bin/autoheader -AUTOMAKE = /afs/ncsa/projects/hdf/packages/automake_1.9.5/Linux_2.4/bin/automake -AWK = @AWK@ -BUILD_CXX_CONDITIONAL_FALSE = @BUILD_CXX_CONDITIONAL_FALSE@ -BUILD_CXX_CONDITIONAL_TRUE = @BUILD_CXX_CONDITIONAL_TRUE@ -BUILD_FORTRAN_CONDITIONAL_FALSE = @BUILD_FORTRAN_CONDITIONAL_FALSE@ -BUILD_FORTRAN_CONDITIONAL_TRUE = @BUILD_FORTRAN_CONDITIONAL_TRUE@ -BUILD_HDF5_HL_CONDITIONAL_FALSE = @BUILD_HDF5_HL_CONDITIONAL_FALSE@ -BUILD_HDF5_HL_CONDITIONAL_TRUE = @BUILD_HDF5_HL_CONDITIONAL_TRUE@ -BUILD_PABLO_CONDITIONAL_FALSE = @BUILD_PABLO_CONDITIONAL_FALSE@ -BUILD_PABLO_CONDITIONAL_TRUE = @BUILD_PABLO_CONDITIONAL_TRUE@ -BUILD_PARALLEL_CONDITIONAL_FALSE = @BUILD_PARALLEL_CONDITIONAL_FALSE@ -BUILD_PARALLEL_CONDITIONAL_TRUE = @BUILD_PARALLEL_CONDITIONAL_TRUE@ -BUILD_PDB2HDF = @BUILD_PDB2HDF@ -BUILD_PDB2HDF_CONDITIONAL_FALSE = @BUILD_PDB2HDF_CONDITIONAL_FALSE@ -BUILD_PDB2HDF_CONDITIONAL_TRUE = @BUILD_PDB2HDF_CONDITIONAL_TRUE@ -BYTESEX = @BYTESEX@ -CC = @CC@ -CCDEPMODE = @CCDEPMODE@ -CC_VERSION = @CC_VERSION@ -CFLAGS = @CFLAGS@ -CONFIG_DATE = @CONFIG_DATE@ -CONFIG_MODE = @CONFIG_MODE@ -CONFIG_USER = @CONFIG_USER@ -CPP = @CPP@ -CPPFLAGS = @CPPFLAGS@ -CXX = @CXX@ -CXXCPP = @CXXCPP@ -CXXDEPMODE = @CXXDEPMODE@ -CXXFLAGS = @CXXFLAGS@ -CYGPATH_W = @CYGPATH_W@ -DEBUG_PKG = @DEBUG_PKG@ -DEFS = @DEFS@ -DEPDIR = @DEPDIR@ -DYNAMIC_DIRS = @DYNAMIC_DIRS@ -ECHO = @ECHO@ -ECHO_C = @ECHO_C@ -ECHO_N = @ECHO_N@ -ECHO_T = @ECHO_T@ -EGREP = @EGREP@ -EXEEXT = @EXEEXT@ -F77 = @F77@ - -# Make sure that these variables are exported to the Makefiles -F9XMODEXT = @F9XMODEXT@ -F9XMODFLAG = @F9XMODFLAG@ -F9XSUFFIXFLAG = @F9XSUFFIXFLAG@ -FC = @FC@ -FCFLAGS = @FCFLAGS@ -FCLIBS = @FCLIBS@ -FFLAGS = @FFLAGS@ -FILTERS = @FILTERS@ -FSEARCH_DIRS = @FSEARCH_DIRS@ -H5_VERSION = @H5_VERSION@ -HADDR_T = @HADDR_T@ -HDF5_INTERFACES = @HDF5_INTERFACES@ -HID_T = @HID_T@ -HL = @HL@ -HL_FOR = @HL_FOR@ -HSIZET = @HSIZET@ -HSIZE_T = @HSIZE_T@ -HSSIZE_T = @HSSIZE_T@ -INSTALL_DATA = @INSTALL_DATA@ -INSTALL_PROGRAM = @INSTALL_PROGRAM@ -INSTALL_SCRIPT = @INSTALL_SCRIPT@ -INSTALL_STRIP_PROGRAM = @INSTALL_STRIP_PROGRAM@ -INSTRUMENT_LIBRARY = @INSTRUMENT_LIBRARY@ -LDFLAGS = @LDFLAGS@ -LIBOBJS = @LIBOBJS@ -LIBS = @LIBS@ -LIBTOOL = @LIBTOOL@ -LN_S = @LN_S@ -LTLIBOBJS = @LTLIBOBJS@ -LT_STATIC_EXEC = @LT_STATIC_EXEC@ -MAINT = @MAINT@ -MAINTAINER_MODE_FALSE = @MAINTAINER_MODE_FALSE@ -MAINTAINER_MODE_TRUE = @MAINTAINER_MODE_TRUE@ -MAKEINFO = @MAKEINFO@ -MPE = @MPE@ -OBJECT_NAMELEN_DEFAULT_F = @OBJECT_NAMELEN_DEFAULT_F@ -OBJEXT = @OBJEXT@ -PACKAGE = @PACKAGE@ -PACKAGE_BUGREPORT = @PACKAGE_BUGREPORT@ -PACKAGE_NAME = @PACKAGE_NAME@ -PACKAGE_STRING = @PACKAGE_STRING@ -PACKAGE_TARNAME = @PACKAGE_TARNAME@ -PACKAGE_VERSION = @PACKAGE_VERSION@ -PARALLEL = @PARALLEL@ -PATH_SEPARATOR = @PATH_SEPARATOR@ -PERL = @PERL@ -PTHREAD = @PTHREAD@ -RANLIB = @RANLIB@ -ROOT = @ROOT@ -RUNPARALLEL = @RUNPARALLEL@ -RUNSERIAL = @RUNSERIAL@ -R_INTEGER = @R_INTEGER@ -R_LARGE = @R_LARGE@ -SEARCH = @SEARCH@ -SETX = @SETX@ -SET_MAKE = @SET_MAKE@ - -# Hardcode SHELL to be /bin/sh. Most machines have this shell, and -# on at least one machine configure fails to detect its existence (janus). -# Also, when HDF5 is configured on one machine but run on another, -# configure's automatic SHELL detection may not work on the build machine. -SHELL = /bin/sh -SIZE_T = @SIZE_T@ -STATIC_SHARED = @STATIC_SHARED@ -STRIP = @STRIP@ -TESTPARALLEL = @TESTPARALLEL@ -TRACE_API = @TRACE_API@ -USE_FILTER_DEFLATE = @USE_FILTER_DEFLATE@ -USE_FILTER_FLETCHER32 = @USE_FILTER_FLETCHER32@ -USE_FILTER_NBIT = @USE_FILTER_NBIT@ -USE_FILTER_SCALEOFFSET = @USE_FILTER_SCALEOFFSET@ -USE_FILTER_SHUFFLE = @USE_FILTER_SHUFFLE@ -USE_FILTER_SZIP = @USE_FILTER_SZIP@ -VERSION = @VERSION@ -ac_ct_AR = @ac_ct_AR@ -ac_ct_CC = @ac_ct_CC@ -ac_ct_CXX = @ac_ct_CXX@ -ac_ct_F77 = @ac_ct_F77@ -ac_ct_FC = @ac_ct_FC@ -ac_ct_RANLIB = @ac_ct_RANLIB@ -ac_ct_STRIP = @ac_ct_STRIP@ -am__fastdepCC_FALSE = @am__fastdepCC_FALSE@ -am__fastdepCC_TRUE = @am__fastdepCC_TRUE@ -am__fastdepCXX_FALSE = @am__fastdepCXX_FALSE@ -am__fastdepCXX_TRUE = @am__fastdepCXX_TRUE@ -am__include = @am__include@ -am__leading_dot = @am__leading_dot@ -am__quote = @am__quote@ -am__tar = @am__tar@ -am__untar = @am__untar@ -bindir = @bindir@ -build = @build@ -build_alias = @build_alias@ -build_cpu = @build_cpu@ -build_os = @build_os@ -build_vendor = @build_vendor@ -datadir = @datadir@ -exec_prefix = @exec_prefix@ -host = @host@ -host_alias = @host_alias@ -host_cpu = @host_cpu@ -host_os = @host_os@ -host_vendor = @host_vendor@ - -# Install directories that automake doesn't know about -includedir = $(exec_prefix)/include -infodir = @infodir@ -install_sh = @install_sh@ -libdir = @libdir@ -libexecdir = @libexecdir@ -localstatedir = @localstatedir@ -mandir = @mandir@ -mkdir_p = @mkdir_p@ -oldincludedir = @oldincludedir@ -prefix = @prefix@ -program_transform_name = @program_transform_name@ -sbindir = @sbindir@ -sharedstatedir = @sharedstatedir@ -sysconfdir = @sysconfdir@ -target_alias = @target_alias@ - -# Shell commands used in Makefiles -RM = rm -f -CP = cp - -# Some machines need a command to run executables; this is that command -# so that our tests will run. -# We use RUNTESTS instead of RUNSERIAL directly because it may be that -# some tests need to be run with a different command. Older versions -# of the makefiles used the command -# $(LIBTOOL) --mode=execute -# in some directories, for instance. -RUNTESTS = $(RUNSERIAL) - -# Libraries to link to while building -LIBHDF5 = $(top_builddir)/src/libhdf5.la -LIBH5TEST = $(top_builddir)/test/libh5test.la -LIBH5F = $(top_builddir)/fortran/src/libhdf5_fortran.la -LIBH5FTEST = $(top_builddir)/fortran/test/libh5test_fortran.la -LIBH5CPP = $(top_builddir)/c++/src/libhdf5_cpp.la -LIBH5TOOLS = $(top_builddir)/tools/lib/libh5tools.la -LIBH5_HL = $(top_builddir)/hl/src/libhdf5_hl.la -LIBH5F_HL = $(top_builddir)/hl/fortran/src/libhdf5hl_fortran.la -LIBH5CPP_HL = $(top_builddir)/hl/c++/src/libhdf5_hl_cpp.la -docdir = $(exec_prefix)/doc - -# Scripts used to build examples -H5CC = $(bindir)/h5cc -H5CC_PP = $(bindir)/h5pcc -H5FC = $(bindir)/h5fc -H5FC_PP = $(bindir)/h5pfc - -# .chkexe and .chksh files are used to mark tests that have run successfully. -MOSTLYCLEANFILES = *.chkexe *.chksh -localdocdir = $(docdir)/hdf5/cpplus - -# Public doc files (to be installed)... -localdoc_DATA = CppInterfaces.html CppUserNotes.doc CppUserNotes.pdf -all: all-am - -.SUFFIXES: -$(srcdir)/Makefile.in: @MAINTAINER_MODE_TRUE@ $(srcdir)/Makefile.am $(top_srcdir)/config/commence-doc.am $(top_srcdir)/config/commence.am $(am__configure_deps) - @for dep in $?; do \ - case '$(am__configure_deps)' in \ - *$$dep*) \ - cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh \ - && exit 0; \ - exit 1;; \ - esac; \ - done; \ - echo ' cd $(top_srcdir) && $(AUTOMAKE) --foreign doc/html/cpplus/Makefile'; \ - cd $(top_srcdir) && \ - $(AUTOMAKE) --foreign doc/html/cpplus/Makefile -.PRECIOUS: Makefile -Makefile: $(srcdir)/Makefile.in $(top_builddir)/config.status - @case '$?' in \ - *config.status*) \ - cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh;; \ - *) \ - echo ' cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ $(am__depfiles_maybe)'; \ - cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ $(am__depfiles_maybe);; \ - esac; - -$(top_builddir)/config.status: $(top_srcdir)/configure $(CONFIG_STATUS_DEPENDENCIES) - cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh - -$(top_srcdir)/configure: @MAINTAINER_MODE_TRUE@ $(am__configure_deps) - cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh -$(ACLOCAL_M4): @MAINTAINER_MODE_TRUE@ $(am__aclocal_m4_deps) - cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh - -mostlyclean-libtool: - -rm -f *.lo - -clean-libtool: - -rm -rf .libs _libs - -distclean-libtool: - -rm -f libtool -uninstall-info-am: -install-localdocDATA: $(localdoc_DATA) - @$(NORMAL_INSTALL) - test -z "$(localdocdir)" || $(mkdir_p) "$(DESTDIR)$(localdocdir)" - @list='$(localdoc_DATA)'; for p in $$list; do \ - if test -f "$$p"; then d=; else d="$(srcdir)/"; fi; \ - f=$(am__strip_dir) \ - echo " $(localdocDATA_INSTALL) '$$d$$p' '$(DESTDIR)$(localdocdir)/$$f'"; \ - $(localdocDATA_INSTALL) "$$d$$p" "$(DESTDIR)$(localdocdir)/$$f"; \ - done - -uninstall-localdocDATA: - @$(NORMAL_UNINSTALL) - @list='$(localdoc_DATA)'; for p in $$list; do \ - f=$(am__strip_dir) \ - echo " rm -f '$(DESTDIR)$(localdocdir)/$$f'"; \ - rm -f "$(DESTDIR)$(localdocdir)/$$f"; \ - done -tags: TAGS -TAGS: - -ctags: CTAGS -CTAGS: - - -distdir: $(DISTFILES) - $(mkdir_p) $(distdir)/../../../config - @srcdirstrip=`echo "$(srcdir)" | sed 's|.|.|g'`; \ - topsrcdirstrip=`echo "$(top_srcdir)" | sed 's|.|.|g'`; \ - list='$(DISTFILES)'; for file in $$list; do \ - case $$file in \ - $(srcdir)/*) file=`echo "$$file" | sed "s|^$$srcdirstrip/||"`;; \ - $(top_srcdir)/*) file=`echo "$$file" | sed "s|^$$topsrcdirstrip/|$(top_builddir)/|"`;; \ - esac; \ - if test -f $$file || test -d $$file; then d=.; else d=$(srcdir); fi; \ - dir=`echo "$$file" | sed -e 's,/[^/]*$$,,'`; \ - if test "$$dir" != "$$file" && test "$$dir" != "."; then \ - dir="/$$dir"; \ - $(mkdir_p) "$(distdir)$$dir"; \ - else \ - dir=''; \ - fi; \ - if test -d $$d/$$file; then \ - if test -d $(srcdir)/$$file && test $$d != $(srcdir); then \ - cp -pR $(srcdir)/$$file $(distdir)$$dir || exit 1; \ - fi; \ - cp -pR $$d/$$file $(distdir)$$dir || exit 1; \ - else \ - test -f $(distdir)/$$file \ - || cp -p $$d/$$file $(distdir)/$$file \ - || exit 1; \ - fi; \ - done -check-am: all-am -check: check-am -all-am: Makefile $(DATA) -installdirs: - for dir in "$(DESTDIR)$(localdocdir)"; do \ - test -z "$$dir" || $(mkdir_p) "$$dir"; \ - done -install: install-am -install-exec: install-exec-am -install-data: install-data-am -uninstall: uninstall-am - -install-am: all-am - @$(MAKE) $(AM_MAKEFLAGS) install-exec-am install-data-am - -installcheck: installcheck-am -install-strip: - $(MAKE) $(AM_MAKEFLAGS) INSTALL_PROGRAM="$(INSTALL_STRIP_PROGRAM)" \ - install_sh_PROGRAM="$(INSTALL_STRIP_PROGRAM)" INSTALL_STRIP_FLAG=-s \ - `test -z '$(STRIP)' || \ - echo "INSTALL_PROGRAM_ENV=STRIPPROG='$(STRIP)'"` install -mostlyclean-generic: - -test -z "$(MOSTLYCLEANFILES)" || rm -f $(MOSTLYCLEANFILES) - -clean-generic: - -distclean-generic: - -test -z "$(CONFIG_CLEAN_FILES)" || rm -f $(CONFIG_CLEAN_FILES) - -maintainer-clean-generic: - @echo "This command is intended for maintainers to use" - @echo "it deletes files that may require special tools to rebuild." -clean: clean-am - -clean-am: clean-generic clean-libtool mostlyclean-am - -distclean: distclean-am - -rm -f Makefile -distclean-am: clean-am distclean-generic distclean-libtool - -dvi: dvi-am - -dvi-am: - -html: html-am - -info: info-am - -info-am: - -install-data-am: install-localdocDATA - -install-exec-am: - -install-info: install-info-am - -install-man: - -installcheck-am: - -maintainer-clean: maintainer-clean-am - -rm -f Makefile -maintainer-clean-am: distclean-am maintainer-clean-generic - -mostlyclean: mostlyclean-am - -mostlyclean-am: mostlyclean-generic mostlyclean-libtool - -pdf: pdf-am - -pdf-am: - -ps: ps-am - -ps-am: - -uninstall-am: uninstall-info-am uninstall-localdocDATA - -.PHONY: all all-am check check-am clean clean-generic clean-libtool \ - distclean distclean-generic distclean-libtool distdir dvi \ - dvi-am html html-am info info-am install install-am \ - install-data install-data-am install-exec install-exec-am \ - install-info install-info-am install-localdocDATA install-man \ - install-strip installcheck installcheck-am installdirs \ - maintainer-clean maintainer-clean-generic mostlyclean \ - mostlyclean-generic mostlyclean-libtool pdf pdf-am ps ps-am \ - uninstall uninstall-am uninstall-info-am \ - uninstall-localdocDATA - - -# Ignore most rules -lib progs check test _test check-p check-s: - @echo "Nothing to be done" - -tests dep depend: - @@SETX@; for d in X $(SUBDIRS); do \ - if test $$d != X; then \ - (cd $$d && $(MAKE) $(AM_MAKEFLAGS) $@) || exit 1; \ - fi; - done - -# In docs directory, install-doc is the same as install -install-doc install-all: - $(MAKE) $(AM_MAKEFLAGS) install -uninstall-doc uninstall-all: - $(MAKE) $(AM_MAKEFLAGS) uninstall -# Tell versions [3.59,3.63) of GNU make to not export all variables. -# Otherwise a system limit (for SysV at least) may be exceeded. -.NOEXPORT: |