| 1 | 
 #ifndef QUAZIP_QUAGZIPFILE_H | 
 
 
 
 
 
 | 2 | 
 #define QUAZIP_QUAGZIPFILE_H | 
 
 
 
 
 
 | 3 | 
  | 
 
 
 
 
 
 | 4 | 
 /* | 
 
 
 
 
 
 | 5 | 
 Copyright (C) 2005-2014 Sergey A. Tachenov | 
 
 
 
 
 
 | 6 | 
  | 
 
 
 
 
 
 | 7 | 
 This file is part of QuaZIP. | 
 
 
 
 
 
 | 8 | 
  | 
 
 
 
 
 
 | 9 | 
 QuaZIP is free software: you can redistribute it and/or modify | 
 
 
 
 
 
 | 10 | 
 it under the terms of the GNU Lesser General Public License as published by | 
 
 
 
 
 
 | 11 | 
 the Free Software Foundation, either version 2.1 of the License, or | 
 
 
 
 
 
 | 12 | 
 (at your option) any later version. | 
 
 
 
 
 
 | 13 | 
  | 
 
 
 
 
 
 | 14 | 
 QuaZIP is distributed in the hope that it will be useful, | 
 
 
 
 
 
 | 15 | 
 but WITHOUT ANY WARRANTY; without even the implied warranty of | 
 
 
 
 
 
 | 16 | 
 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the | 
 
 
 
 
 
 | 17 | 
 GNU Lesser General Public License for more details. | 
 
 
 
 
 
 | 18 | 
  | 
 
 
 
 
 
 | 19 | 
 You should have received a copy of the GNU Lesser General Public License | 
 
 
 
 
 
 | 20 | 
 along with QuaZIP.  If not, see <http://www.gnu.org/licenses/>. | 
 
 
 
 
 
 | 21 | 
  | 
 
 
 
 
 
 | 22 | 
 See COPYING file for the full LGPL text. | 
 
 
 
 
 
 | 23 | 
  | 
 
 
 
 
 
 | 24 | 
 Original ZIP package is copyrighted by Gilles Vollant and contributors, | 
 
 
 
 
 
 | 25 | 
 see quazip/(un)zip.h files for details. Basically it's the zlib license. | 
 
 
 
 
 
 | 26 | 
 */ | 
 
 
 
 
 
 | 27 | 
  | 
 
 
 
 
 
 | 28 | 
 #include <QIODevice> | 
 
 
 
 
 
 | 29 | 
 #include "quazip_global.h" | 
 
 
 
 
 
 | 30 | 
  | 
 
 
 
 
 
 | 31 | 
 #include <zlib.h> | 
 
 
 
 
 
 | 32 | 
  | 
 
 
 
 
 
 | 33 | 
 class QuaGzipFilePrivate; | 
 
 
 
 
 
 | 34 | 
  | 
 
 
 
 
 
 | 35 | 
 /// GZIP file | 
 
 
 
 
 
 | 36 | 
 /** | 
 
 
 
 
 
 | 37 | 
   This class is a wrapper around GZIP file access functions in zlib. Unlike QuaZip classes, it doesn't allow reading from a GZIP file opened as QIODevice, for example, if your GZIP file is in QBuffer. It only provides QIODevice access to a GZIP file contents, but the GZIP file itself must be identified by its name on disk or by descriptor id. | 
 
 
 
 
 
 | 38 | 
   */ | 
 
 
 
 
 
 | 39 | 
 class QUAZIP_EXPORT QuaGzipFile: public QIODevice { | 
 
 
 
 
 
 | 40 | 
   Q_OBJECT | 
 
 
 
 
 
 | 41 | 
 public: | 
 
 
 
 
 
 | 42 | 
   /// Empty constructor. | 
 
 
 
 
 
 | 43 | 
   /** | 
 
 
 
 
 
 | 44 | 
     Must call setFileName() before trying to open. | 
 
 
 
 
 
 | 45 | 
     */ | 
 
 
 
 
 
 | 46 | 
   QuaGzipFile(); | 
 
 
 
 
 
 | 47 | 
   /// Empty constructor with a parent. | 
 
 
 
 
 
 | 48 | 
   /** | 
 
 
 
 
 
 | 49 | 
     Must call setFileName() before trying to open. | 
 
 
 
 
 
 | 50 | 
     \param parent The parent object, as per QObject logic. | 
 
 
 
 
 
 | 51 | 
     */ | 
 
 
 
 
 
 | 52 | 
   QuaGzipFile(QObject *parent); | 
 
 
 
 
 
 | 53 | 
   /// Constructor. | 
 
 
 
 
 
 | 54 | 
   /** | 
 
 
 
 
 
 | 55 | 
     \param fileName The name of the GZIP file. | 
 
 
 
 
 
 | 56 | 
     \param parent The parent object, as per QObject logic. | 
 
 
 
 
 
 | 57 | 
     */ | 
 
 
 
 
 
 | 58 | 
   QuaGzipFile(const QString &fileName, QObject *parent = NULL); | 
 
 
 
 
 
 | 59 | 
   /// Destructor. | 
 
 
 
 
 
 | 60 | 
   virtual ~QuaGzipFile(); | 
 
 
 
 
 
 | 61 | 
   /// Sets the name of the GZIP file to be opened. | 
 
 
 
 
 
 | 62 | 
   void setFileName(const QString& fileName); | 
 
 
 
 
 
 | 63 | 
   /// Returns the name of the GZIP file. | 
 
 
 
 
 
 | 64 | 
   QString getFileName() const; | 
 
 
 
 
 
 | 65 | 
   /// Returns true. | 
 
 
 
 
 
 | 66 | 
   /** | 
 
 
 
 
 
 | 67 | 
     Strictly speaking, zlib supports seeking for GZIP files, but it is | 
 
 
 
 
 
 | 68 | 
     poorly implemented, because there is no way to implement it | 
 
 
 
 
 
 | 69 | 
     properly. For reading, seeking backwards is very slow, and for | 
 
 
 
 
 
 | 70 | 
     writing, it is downright impossible. Therefore, QuaGzipFile does not | 
 
 
 
 
 
 | 71 | 
     support seeking at all. | 
 
 
 
 
 
 | 72 | 
     */ | 
 
 
 
 
 
 | 73 | 
   virtual bool isSequential() const; | 
 
 
 
 
 
 | 74 | 
   /// Opens the file. | 
 
 
 
 
 
 | 75 | 
   /** | 
 
 
 
 
 
 | 76 | 
     \param mode Can be either QIODevice::Write or QIODevice::Read. | 
 
 
 
 
 
 | 77 | 
     ReadWrite and Append aren't supported. | 
 
 
 
 
 
 | 78 | 
     */ | 
 
 
 
 
 
 | 79 | 
   virtual bool open(QIODevice::OpenMode mode); | 
 
 
 
 
 
 | 80 | 
   /// Opens the file. | 
 
 
 
 
 
 | 81 | 
   /** | 
 
 
 
 
 
 | 82 | 
     \overload | 
 
 
 
 
 
 | 83 | 
     \param fd The file descriptor to read/write the GZIP file from/to. | 
 
 
 
 
 
 | 84 | 
     \param mode Can be either QIODevice::Write or QIODevice::Read. | 
 
 
 
 
 
 | 85 | 
     ReadWrite and Append aren't supported. | 
 
 
 
 
 
 | 86 | 
     */ | 
 
 
 
 
 
 | 87 | 
   virtual bool open(int fd, QIODevice::OpenMode mode); | 
 
 
 
 
 
 | 88 | 
   /// Flushes data to file. | 
 
 
 
 
 
 | 89 | 
   /** | 
 
 
 
 
 
 | 90 | 
     The data is written using Z_SYNC_FLUSH mode. Doesn't make any sense | 
 
 
 
 
 
 | 91 | 
     when reading. | 
 
 
 
 
 
 | 92 | 
     */ | 
 
 
 
 
 
 | 93 | 
   virtual bool flush(); | 
 
 
 
 
 
 | 94 | 
   /// Closes the file. | 
 
 
 
 
 
 | 95 | 
   virtual void close(); | 
 
 
 
 
 
 | 96 | 
 protected: | 
 
 
 
 
 
 | 97 | 
   /// Implementation of QIODevice::readData(). | 
 
 
 
 
 
 | 98 | 
   virtual qint64 readData(char *data, qint64 maxSize); | 
 
 
 
 
 
 | 99 | 
   /// Implementation of QIODevice::writeData(). | 
 
 
 
 
 
 | 100 | 
   virtual qint64 writeData(const char *data, qint64 maxSize); | 
 
 
 
 
 
 | 101 | 
 private: | 
 
 
 
 
 
 | 102 | 
     // not implemented by design to disable copy | 
 
 
 
 
 
 | 103 | 
     QuaGzipFile(const QuaGzipFile &that); | 
 
 
 
 
 
 | 104 | 
     QuaGzipFile& operator=(const QuaGzipFile &that); | 
 
 
 
 
 
 | 105 | 
     QuaGzipFilePrivate *d; | 
 
 
 
 
 
 | 106 | 
 }; | 
 
 
 
 
 
 | 107 | 
  | 
 
 
 
 
 
 | 108 | 
 #endif // QUAZIP_QUAGZIPFILE_H |