H5File.hpp

Go to the documentation of this file.

/*
 *  Copyright (c), 2017, Adrien Devresse <adrien.devresse@epfl.ch>
 *
 *  Distributed under the Boost Software License, Version 1.0.
 *    (See accompanying file LICENSE_1_0.txt or copy at
 *          http://www.boost.org/LICENSE_1_0.txt)
 *
 */
#pragma once
 
#include <string>
 
#include "H5FileDriver.hpp"
#include "H5Object.hpp"
#include "H5PropertyList.hpp"
#include "bits/H5Annotate_traits.hpp"
#include "bits/H5Node_traits.hpp"
 
namespace HighFive {
 
class File: public Object, public NodeTraits<File>, public AnnotateTraits<File> {
  public:
    const static ObjectType type = ObjectType::File;
 
    enum : unsigned {
        ReadOnly = 0x00u,
        ReadWrite = 0x01u,
        Truncate = 0x02u,
        Excl = 0x04u,
        Debug = 0x08u,
        Create = 0x10u,
        Overwrite = Truncate,
        OpenOrCreate = ReadWrite | Create
    };
 
    explicit File(const std::string& filename,
                  unsigned openFlags = ReadOnly,
                  const FileAccessProps& fileAccessProps = FileAccessProps::Default());
 
    File(const std::string& filename,
         unsigned openFlags,
         const FileCreateProps& fileCreateProps,
         const FileAccessProps& fileAccessProps = FileAccessProps::Default());
 
    const std::string& getName() const noexcept;
 
 
    std::string getPath() const noexcept {
        return "/";
    }
 
    hsize_t getMetadataBlockSize() const;
 
    std::pair<H5F_libver_t, H5F_libver_t> getVersionBounds() const;
 
#if H5_VERSION_GE(1, 10, 1)
    H5F_fspace_strategy_t getFileSpaceStrategy() const;
 
    hsize_t getFileSpacePageSize() const;
#endif
 
    void flush();
 
    FileCreateProps getCreatePropertyList() const {
        return details::get_plist<FileCreateProps>(*this, H5Fget_create_plist);
    }
 
    FileAccessProps getAccessPropertyList() const {
        return details::get_plist<FileAccessProps>(*this, H5Fget_access_plist);
    }
 
    size_t getFileSize() const;
 
    size_t getFreeSpace() const;
 
  protected:
    File() = default;
    using Object::Object;
 
  private:
    mutable std::string _filename{};
 
    template <typename>
    friend class PathTraits;
};
 
}  // namespace HighFive
 
// H5File is the main user constructible -> bring in implementation headers
#include "bits/H5Annotate_traits_misc.hpp"
#include "bits/H5File_misc.hpp"
#include "bits/H5Node_traits_misc.hpp"
#include "bits/H5Path_traits_misc.hpp"