/usr/include/zim/cluster.h is in libzim-dev 2.0.0-2build2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
| 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 | /*
 * Copyright (C) 2009 Tommi Maekitalo
 *
 * This program is free software; you can redistribute it and/or
 * modify it under the terms of the GNU General Public License as
 * published by the Free Software Foundation; either version 2 of the
 * License, or (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful, but
 * is provided AS IS, WITHOUT ANY WARRANTY; without even the implied
 * warranty of MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, and
 * NON-INFRINGEMENT.  See the GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, write to the Free Software
 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301 USA
 *
 */
#ifndef ZIM_CLUSTER_H
#define ZIM_CLUSTER_H
#include <zim/zim.h>
#include <zim/refcounted.h>
#include <zim/smartptr.h>
#include <zim/fstream.h>
#include <iosfwd>
#include <vector>
namespace zim
{
  class Blob;
  class Cluster;
  class ClusterImpl : public RefCounted
  {
      friend std::ostream& operator<< (std::ostream& out, const ClusterImpl& blobImpl);
      typedef std::vector<size_type> Offsets;
      typedef std::vector<char> Data;
      CompressionType compression;
      Offsets offsets;
      Data _data;
      offset_type startOffset;
      ifstream* lazy_read_stream;
      offset_type read_header(std::istream& in);
      void read_content(std::istream& in);
      void write(std::ostream& out) const;
      void set_lazy_read(ifstream* in) {
        lazy_read_stream = in;
      }
      bool is_fully_initialised() const { return lazy_read_stream == 0; }
      void finalise_read();
      const Data& data() const {
        if ( !is_fully_initialised() )
        {
           const_cast<ClusterImpl*>(this)->finalise_read();
        }
        return _data;
      }
    public:
      ClusterImpl();
      void setCompression(CompressionType c)   { compression = c; }
      CompressionType getCompression() const   { return compression; }
      bool isCompressed() const                { return compression == zimcompZip || compression == zimcompBzip2 || compression == zimcompLzma; }
      size_type getCount() const               { return offsets.size() - 1; }
      const char* getData(unsigned n) const    { return &data()[ offsets[n] ]; }
      size_type getSize(unsigned n) const      { return offsets[n+1] - offsets[n]; }
      size_type getSize() const                { return offsets.size() * sizeof(size_type) + data().size(); }
      offset_type getOffset(size_type n) const { return startOffset + offsets[n]; }
      Blob getBlob(size_type n) const;
      void clear();
      void addBlob(const Blob& blob);
      void addBlob(const char* data, unsigned size);
      void init_from_stream(ifstream& in, offset_type offset);
  };
  class Cluster
  {
      friend std::ostream& operator<< (std::ostream& out, const Cluster& blob);
      SmartPtr<ClusterImpl> impl;
      ClusterImpl* getImpl();
    public:
      Cluster();
      void setCompression(CompressionType c)  { getImpl()->setCompression(c); }
      CompressionType getCompression() const  { return impl ? impl->getCompression() : zimcompNone; }
      bool isCompressed() const
        { return impl && (impl->getCompression() == zimcompZip
                       || impl->getCompression() == zimcompBzip2
                       || impl->getCompression() == zimcompLzma); }
      const char* getBlobPtr(size_type n) const     { return impl->getData(n); }
      size_type getBlobSize(size_type n) const      { return impl->getSize(n); }
      offset_type getBlobOffset(size_type n) const  { return impl->getOffset(n); }
      Blob getBlob(size_type n) const;
      size_type count() const   { return impl ? impl->getCount() : 0; }
      size_type size() const    { return impl ? impl->getSize(): sizeof(size_type); }
      void clear()              { if (impl) impl->clear(); }
      void addBlob(const char* data, unsigned size) { getImpl()->addBlob(data, size); }
      void addBlob(const Blob& blob)                { getImpl()->addBlob(blob); }
      operator bool() const   { return impl; }
      void init_from_stream(ifstream& in, offset_type offset);
  };
  std::ostream& operator<< (std::ostream& out, const ClusterImpl& blobImpl);
  std::ostream& operator<< (std::ostream& out, const Cluster& blob);
}
#endif // ZIM_CLUSTER_H
 |