versionnumber.h

Go to the documentation of this file.

/*
    Copyright (C) 2008-2010  Lukas Sommer < SommerLuk at gmail dot com >

    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) version 3 or any later version
    accepted by the membership of KDE e.V. (or its successor approved
    by the membership of KDE e.V.), which shall act as a proxy
    defined in Section 14 of version 3 of the license.

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  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, see <http://www.gnu.org/licenses/>.
*/

#ifndef VERSIONNUMBER_H
#define VERSIONNUMBER_H

#include <QStringList>
#include <QMetaType>

class VersionNumber
{

  public:
    VersionNumber();
    VersionNumber(const VersionNumber & value); // copy constructor
    VersionNumber(const QString & value);
    VersionNumber(const qint64 value);
    virtual ~VersionNumber();
    QString toString() const;
    VersionNumber operator=(const VersionNumber & value);
    VersionNumber operator=(const QString & value);
    VersionNumber operator=(qint64 value);
    bool operator<(const VersionNumber & value) const;
    bool operator<=(const VersionNumber & value) const;
    bool operator>(const VersionNumber & value) const;
    bool operator>=(const VersionNumber & value) const;
    bool operator==(const VersionNumber & value) const;
    bool operator!=(const VersionNumber & value) const;

  private:
    // typedefs
    typedef QStringList simpleNumber;
    typedef QList< simpleNumber > numberWithPoints;
    typedef QList< numberWithPoints > numberWithPointsAndDashes;
    enum characterType {
      letter,
      digit,
      other
    };
    enum type_whichIsBigger {
      first_one,
      second_one,
      both_are_equal
    };

    // members
    QString theString;
    numberWithPointsAndDashes epoch;
    numberWithPointsAndDashes version_and_release;

    // methods
    void helper_copyFromHere(const VersionNumber & value);
    void helper_setValue(const QString & value);
    static VersionNumber::characterType helper_characterType(const QChar & value);
    static VersionNumber::simpleNumber helper_createSimpleNumber(const QString & value);
    static VersionNumber::numberWithPoints helper_createNumberWithPoints(const QString & value);
    static VersionNumber::numberWithPointsAndDashes helper_createNumberWithPointsAndDashes(
      const QString & value);
    static VersionNumber::type_whichIsBigger whichIsBigger(const VersionNumber & firstValue,
                                                           const VersionNumber & secondValue);
    static VersionNumber::type_whichIsBigger whichIsBigger(
      const numberWithPointsAndDashes & firstValue,
      const numberWithPointsAndDashes & secondValue);
    static VersionNumber::type_whichIsBigger whichIsBigger(const numberWithPoints & firstValue,
                                                           const numberWithPoints & secondValue);
    static VersionNumber::type_whichIsBigger whichIsBigger(const simpleNumber & firstValue,
                                                           const simpleNumber & secondValue);
    static VersionNumber::type_whichIsBigger whichIsBigger(const QString & firstValue,
                                                           const QString & secondValue);
    static VersionNumber::type_whichIsBigger helper_whichNumberIsBigger(
      const QString & firstValue,
      const QString & secondValue);
    static VersionNumber::type_whichIsBigger helper_whichStringIsBigger(
      const QString & firstValue,
      const QString & secondValue);

};

Q_DECLARE_METATYPE(VersionNumber)

#endif