88ce565d7d
Description:
- Replaced PredType::NotAtexit() with PredType::AtExit(H5CPP_EXITED);
and used PredType::AtExit as a flag to detect when all predefined
types have been destroyed. Then, H5close will be called to terminate
the library after its being re-initiated when the PredType destructors
were activated. This change removed the memory leaks shown by the
user's sample program.
- Added H5CPP_EXITED for PredType::AtExit to use as a flag
- Updated some inaccurate comments
- Removed stream functions from FileAccPropList
- Replaced H5_VMS with appropriate macro in H5IdComponent.cpp
- Corrected many URLs (hdfgroup vs. ncsa) in comments
- Replaced std::string with H5std_string in comments
Platforms tested:
Linux/32 2.6 (jam)
Linux/64 2.6 (amani)
SunOS 5.10 (linew)
258 lines
10 KiB
C++
258 lines
10 KiB
C++
/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
|
|
* Copyright by The HDF Group. *
|
|
* 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://hdfgroup.org/HDF5/doc/Copyright.html. If you do not have *
|
|
* access to either file, you may request a copy from help@hdfgroup.org. *
|
|
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
|
|
|
|
#include <string>
|
|
|
|
#include "H5Include.h"
|
|
#include "H5Exception.h"
|
|
#include "H5IdComponent.h"
|
|
#include "H5PropList.h"
|
|
#include "H5FcreatProp.h"
|
|
|
|
#ifndef H5_NO_NAMESPACE
|
|
namespace H5 {
|
|
#endif
|
|
|
|
//--------------------------------------------------------------------------
|
|
///\brief Constant for default property
|
|
//--------------------------------------------------------------------------
|
|
const FileCreatPropList FileCreatPropList::DEFAULT;
|
|
|
|
//--------------------------------------------------------------------------
|
|
// Function: FileCreatPropList default constructor
|
|
///\brief Default constructor: Creates a file create property list
|
|
// Programmer Binh-Minh Ribler - 2000
|
|
//--------------------------------------------------------------------------
|
|
FileCreatPropList::FileCreatPropList() : PropList( H5P_FILE_CREATE ) {}
|
|
|
|
//--------------------------------------------------------------------------
|
|
// Function: FileCreatPropList copy constructor
|
|
///\brief Copy constructor: makes a copy of the original
|
|
/// FileCreatPropList object.
|
|
///\param original - IN: FileCreatPropList instance to copy
|
|
// Programmer Binh-Minh Ribler - 2000
|
|
//--------------------------------------------------------------------------
|
|
FileCreatPropList::FileCreatPropList( const FileCreatPropList& original ) : PropList( original ) {}
|
|
|
|
//--------------------------------------------------------------------------
|
|
// Function: FileCreatPropList overloaded constructor
|
|
///\brief Creates a file creation property list using the id of an
|
|
/// existing one.
|
|
///\param plist_id - IN: FileCreatPropList id to use
|
|
// Programmer Binh-Minh Ribler - 2000
|
|
//--------------------------------------------------------------------------
|
|
FileCreatPropList::FileCreatPropList(const hid_t plist_id) : PropList(plist_id) {}
|
|
|
|
#ifndef H5_NO_DEPRECATED_SYMBOLS
|
|
//--------------------------------------------------------------------------
|
|
// Function: FileCreatPropList::getVersion
|
|
///\brief Retrieves version information for various parts of a file.
|
|
///\param super - OUT: The file super block.
|
|
///\param freelist - OUT: The global free list.
|
|
///\param stab - OUT: The root symbol table entry.
|
|
///\param shhdr - OUT: Shared object headers.
|
|
///\exception H5::PropListIException
|
|
///\par Description
|
|
/// Any (or even all) of the output arguments can be null pointers.
|
|
// Programmer Binh-Minh Ribler - 2000
|
|
//--------------------------------------------------------------------------
|
|
void FileCreatPropList::getVersion(unsigned& super, unsigned& freelist, unsigned& stab, unsigned& shhdr) const
|
|
{
|
|
herr_t ret_value = H5Pget_version( id, &super, &freelist, &stab, &shhdr );
|
|
if( ret_value < 0 )
|
|
{
|
|
throw PropListIException("FileCreatPropList::getVersion",
|
|
"H5Pget_version failed");
|
|
}
|
|
}
|
|
#endif /* H5_NO_DEPRECATED_SYMBOLS */
|
|
|
|
//--------------------------------------------------------------------------
|
|
// Function: FileCreatPropList::setUserblock
|
|
///\brief Sets the user block size field of this file creation property list.
|
|
///\param size - IN: User block size to be set, in bytes
|
|
///\exception H5::PropListIException
|
|
///\par Description
|
|
/// The default user block size is 0; it may be set to any power
|
|
/// of 2 equal to 512 or greater (512, 1024, 2048, etc.)
|
|
// Programmer Binh-Minh Ribler - 2000
|
|
//--------------------------------------------------------------------------
|
|
void FileCreatPropList::setUserblock( hsize_t size ) const
|
|
{
|
|
herr_t ret_value = H5Pset_userblock( id, size);
|
|
if( ret_value < 0 )
|
|
{
|
|
throw PropListIException("FileCreatPropList::setUserblock",
|
|
"H5Pset_userblock failed");
|
|
}
|
|
}
|
|
|
|
//--------------------------------------------------------------------------
|
|
// Function: FileCreatPropList::getUserblock
|
|
///\brief Returns the user block size of this file creation property list.
|
|
///\return User block size
|
|
///\exception H5::PropListIException
|
|
// Programmer Binh-Minh Ribler - 2000
|
|
//--------------------------------------------------------------------------
|
|
hsize_t FileCreatPropList::getUserblock() const
|
|
{
|
|
hsize_t userblock_size;
|
|
herr_t ret_value = H5Pget_userblock( id, &userblock_size );
|
|
if( ret_value < 0 )
|
|
{
|
|
throw PropListIException("FileCreatPropList::getUserblock",
|
|
"H5Pget_userblock failed");
|
|
}
|
|
return( userblock_size );
|
|
}
|
|
|
|
//--------------------------------------------------------------------------
|
|
// Function: FileCreatPropList::setSizes
|
|
///\brief Sets the byte size of the offsets and lengths used to
|
|
/// address objects in an HDF5 file.
|
|
///\param sizeof_addr - IN: Size of an object offset in bytes
|
|
///\param sizeof_size - IN: Size of an object length in bytes.
|
|
///\exception H5::PropListIException
|
|
///\par Description
|
|
/// For information on setting sizes, please refer to the
|
|
/// C layer Reference Manual at:
|
|
/// http://www.hdfgroup.org/HDF5/doc/RM/RM_H5P.html#Property-SetSizes
|
|
// Programmer Binh-Minh Ribler - 2000
|
|
//--------------------------------------------------------------------------
|
|
void FileCreatPropList::setSizes( size_t sizeof_addr, size_t sizeof_size ) const
|
|
{
|
|
herr_t ret_value = H5Pset_sizes( id, sizeof_addr, sizeof_size );
|
|
if( ret_value < 0 )
|
|
{
|
|
throw PropListIException("FileCreatPropList::setSizes",
|
|
"H5Pset_sizes failed");
|
|
}
|
|
}
|
|
|
|
//--------------------------------------------------------------------------
|
|
// Function: FileCreatPropList::getSizes
|
|
///\brief Retrieves the size of the offsets and lengths used in an
|
|
/// HDF5 file.
|
|
///
|
|
///\exception H5::PropListIException
|
|
// Programmer Binh-Minh Ribler - 2000
|
|
//--------------------------------------------------------------------------
|
|
void FileCreatPropList::getSizes( size_t& sizeof_addr, size_t& sizeof_size ) const
|
|
{
|
|
herr_t ret_value = H5Pget_sizes( id, &sizeof_addr, &sizeof_size );
|
|
if( ret_value < 0 )
|
|
{
|
|
throw PropListIException("FileCreatPropList::getSizes",
|
|
"H5Pget_sizes failed");
|
|
}
|
|
}
|
|
|
|
//--------------------------------------------------------------------------
|
|
// Function: FileCreatPropList::setSymk
|
|
///\brief Sets the size of parameters used to control the symbol table
|
|
/// nodes.
|
|
///\param ik - IN: Symbol table tree rank
|
|
///\param lk - IN: Symbol table node size
|
|
///\exception H5::PropListIException
|
|
///\par Description
|
|
/// For information, please see the C layer Reference Manual at:
|
|
/// http://www.hdfgroup.org/HDF5/doc/RM/RM_H5P.html#Property-SetSymK
|
|
// Programmer Binh-Minh Ribler - 2000
|
|
//--------------------------------------------------------------------------
|
|
void FileCreatPropList::setSymk( unsigned ik, unsigned lk ) const
|
|
{
|
|
herr_t ret_value = H5Pset_sym_k( id, ik, lk );
|
|
if( ret_value < 0 )
|
|
{
|
|
throw PropListIException("FileCreatPropList::setSymk",
|
|
"H5Pset_sym_k failed");
|
|
}
|
|
}
|
|
|
|
//--------------------------------------------------------------------------
|
|
// Function: FileCreatPropList::getSymk
|
|
///\brief Retrieves the size of the symbol table B-tree 1/2 rank and
|
|
/// the symbol table leaf node 1/2 size.
|
|
///
|
|
///\exception H5::PropListIException
|
|
///\par Description
|
|
/// For information, please see
|
|
/// http://www.hdfgroup.org/HDF5/doc/RM/RM_H5P.html#Property-GetSymK
|
|
// Programmer Binh-Minh Ribler - 2000
|
|
//--------------------------------------------------------------------------
|
|
void FileCreatPropList::getSymk( unsigned& ik, unsigned& lk ) const
|
|
{
|
|
herr_t ret_value = H5Pget_sym_k( id, &ik, &lk );
|
|
if( ret_value < 0 )
|
|
{
|
|
throw PropListIException("FileCreatPropList::getSymk",
|
|
"H5Pget_sym_k failed");
|
|
}
|
|
}
|
|
|
|
//--------------------------------------------------------------------------
|
|
// Function: FileCreatPropList::setIstorek
|
|
///\brief Sets the size of the parameter used to control the B-trees
|
|
/// for indexing chunked datasets.
|
|
///\param ik - IN: 1/2 rank of chunked storage B-tree
|
|
///\exception H5::PropListIException
|
|
///\par Description
|
|
/// For information, please see the C layer Reference Manual at:
|
|
/// http://www.hdfgroup.org/HDF5/doc/RM/RM_H5P.html#Property-SetIstoreK
|
|
// Programmer Binh-Minh Ribler - 2000
|
|
//--------------------------------------------------------------------------
|
|
void FileCreatPropList::setIstorek( unsigned ik ) const
|
|
{
|
|
herr_t ret_value = H5Pset_istore_k( id, ik );
|
|
if( ret_value < 0 )
|
|
{
|
|
throw PropListIException("FileCreatPropList::setIstorek",
|
|
"H5Pset_istore_k failed");
|
|
}
|
|
}
|
|
|
|
//--------------------------------------------------------------------------
|
|
// Function: FileCreatPropList::getIstorek
|
|
///\brief Returns the 1/2 rank of an indexed storage B-tree.
|
|
///\return 1/2 rank of chunked storage B-tree
|
|
///\exception H5::PropListIException
|
|
///\par Description
|
|
/// For information, please see
|
|
/// http://www.hdfgroup.org/HDF5/doc/RM/RM_H5P.html#Property-GetIstoreK
|
|
// Programmer Binh-Minh Ribler - 2000
|
|
//--------------------------------------------------------------------------
|
|
unsigned FileCreatPropList::getIstorek() const
|
|
{
|
|
unsigned ik;
|
|
herr_t ret_value = H5Pget_istore_k( id, &ik );
|
|
if( ret_value < 0 )
|
|
{
|
|
throw PropListIException("FileCreatPropList::getIstorek",
|
|
"H5Pget_istore_k failed");
|
|
}
|
|
return( ik );
|
|
}
|
|
|
|
//--------------------------------------------------------------------------
|
|
// Function: FileCreatPropList destructor
|
|
///\brief Noop destructor.
|
|
// Programmer Binh-Minh Ribler - 2000
|
|
//--------------------------------------------------------------------------
|
|
FileCreatPropList::~FileCreatPropList() {}
|
|
|
|
#ifndef H5_NO_NAMESPACE
|
|
} // end namespace
|
|
#endif
|