tools/qdoc3/uncompressor.cpp

   1 /****************************************************************************
   2 **
   3 ** Copyright (C) 2010 Nokia Corporation and/or its subsidiary(-ies).
   4 ** All rights reserved.
   5 ** Contact: Nokia Corporation (qt-info@nokia.com)
   6 **
   7 ** This file is part of the tools applications of the Qt Toolkit.
   8 **
   9 ** $QT_BEGIN_LICENSE:LGPL$
  10 ** No Commercial Usage
  11 ** This file contains pre-release code and may not be distributed.
  12 ** You may use this file in accordance with the terms and conditions
  13 ** contained in the Technology Preview License Agreement accompanying
  14 ** this package.
  15 **
  16 ** GNU Lesser General Public License Usage
  17 ** Alternatively, this file may be used under the terms of the GNU Lesser
  18 ** General Public License version 2.1 as published by the Free Software
  19 ** Foundation and appearing in the file LICENSE.LGPL included in the
  20 ** packaging of this file.  Please review the following information to
  21 ** ensure the GNU Lesser General Public License version 2.1 requirements
  22 ** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
  23 **
  24 ** In addition, as a special exception, Nokia gives you certain additional
  25 ** rights.  These rights are described in the Nokia Qt LGPL Exception
  26 ** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
  27 **
  28 ** If you have questions regarding the use of this file, please contact
  29 ** Nokia at qt-info@nokia.com.
  30 **
  31 **
  32 **
  33 **
  34 **
  35 **
  36 **
  37 **
  38 ** $QT_END_LICENSE$
  39 **
  40 ****************************************************************************/
  41
  42 /*
  43   uncompressor.cpp
  44 */
  45
  46 #include "uncompressor.h"
  47
  48 QT_BEGIN_NAMESPACE
  49
  50 QList<Uncompressor *> Uncompressor::uncompressors;
  51
  52
  53 /*!
  54   \class Uncompressor
  55
  56   \brief The Uncompressor class is a base class for classes that
  57   know how to uncompress a certain kind of compressed file.
  58
  59   The uncompressor contains a list of the filename extensions
  60   of the file types that the uncompressor knows how to uncompress.
  61
  62   It maintains a static list of all the instances of Uncompressor
  63   that have been created. It also has a static function for searching
  64   that list to find the uncompressor to use for uncompressing a file
  65   with a certain extension.
  66  */
  67
  68 /*!
  69   The constructor takes a list of filename extensions, which it
  70   copies and saves internally. This uncompressor is prepended
  71   to the stack list.
  72  */
  73 Uncompressor::Uncompressor( const QStringList& extensions )
  74     : fileExts( extensions )
  75 {
  76     uncompressors.prepend( this );
  77 }
  78
  79 /*!
  80   The destructor deletes all the filename extensions.
  81  */
  82 Uncompressor::~Uncompressor()
  83 {
  84     uncompressors.removeAll( this );
  85 }
  86
  87 /*!
  88   This function searches the static list of uncompressors to find the
  89   first one that can handle \a fileName. If it finds an acceptable
  90   uncompressor, it returns a pointer to it. Otherwise it returns null.
  91 */
  92 Uncompressor*
  93 Uncompressor::uncompressorForFileName( const QString& fileName )
  94 {
  95     int dot = -1;
  96     while ( (dot = fileName.indexOf(".", dot + 1)) != -1 ) {
  97         QString ext = fileName.mid( dot + 1 );
  98         QList<Uncompressor *>::ConstIterator u = uncompressors.begin();
  99         while ( u != uncompressors.end() ) {
 100             if ( (*u)->fileExtensions().contains(ext) )
 101                 return *u;
 102             ++u;
 103         }
 104     }
 105     return 0;
 106 }
 107
 108 QT_END_NAMESPACE