You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
k3b/libk3b/core/k3bversion.h

142 lines
4.6 KiB

/*
*
* $Id: k3bversion.h 619556 2007-01-03 17:38:12Z trueg $
* Copyright (C) 2003 Sebastian Trueg <trueg@k3b.org>
*
* This file is part of the K3b project.
* Copyright (C) 1998-2007 Sebastian Trueg <trueg@k3b.org>
*
* 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.
* See the file "COPYING" for the exact licensing terms.
*/
#ifndef _K3B_VERSION_H_
#define _K3B_VERSION_H_
#include <qstring.h>
#include "k3b_export.h"
/**
* \brief Representation of a version.
*
* K3bVersion represents a version consisting of a major version (accessible via majorVersion()),
* a minor version (accessible via minorVersion()), a patchLevel (accessible via patchLevel()),
* and a suffix (accessible via suffix()).
*
* The major version is mandatory while all other fields are optional (in case of the minor version
* and the patchlevel -1 means that the field is undefined).
*
* K3bVersion tries to treat version suffixes in an "intelligent" way to properly compare versions
* (see compareSuffix() for more details).
*
* K3bVersion may also be used everywhere a QString is needed as it automatically converts to a
* string representation using createVersionString().
*/
class LIBK3B_EXPORT K3bVersion
{
public:
/**
* construct an empty version object
* which is invalid
* @ see isValid()
*/
K3bVersion();
/**
* copy constructor
*/
K3bVersion( const K3bVersion& );
/**
* this constructor tries to parse the given version string
*/
K3bVersion( const QString& version );
/**
* sets the version and generates a version string from it
*/
K3bVersion( int majorVersion, int minorVersion, int pachlevel = -1, const QString& suffix = QString::null );
/**
* tries to parse the version string
* used by the constructor
*/
void setVersion( const QString& );
bool isValid() const;
/**
* sets the version and generates a version string from it
* used by the constructor
*
* If minorVersion or pachlevel are -1 they will not be used when generating the version string.
*/
void setVersion( int majorVersion, int minorVersion = -1, int patchlevel = -1, const QString& suffix = QString::null );
const QString& versionString() const { return m_versionString; }
int majorVersion() const { return m_majorVersion; }
int minorVersion() const { return m_minorVersion; }
int patchLevel() const { return m_patchLevel; }
const QString& suffix() const { return m_suffix; }
/**
* just to make it possible to use as a QString
*/
operator const QString& () const { return m_versionString; }
K3bVersion& operator=( const QString& v );
/**
* \return A new K3bVersion object which equals this one except that the suffix is empty.
*/
K3bVersion simplify() const;
/**
* If minorVersion or pachlevel are -1 they will not be used when generating the version string.
* If minorVersion is -1 patchlevel will be ignored.
*/
static QString createVersionString( int majorVersion,
int minorVersion = -1,
int patchlevel = -1,
const QString& suffix = QString::null );
/**
* "Intelligent" comparison of two version suffixes.
*
* This method checks for the following types of suffixes and treats them in the
* following order:
*
* [empty prefix] > rcX > preX > betaX > alphaX = aX (where X is a number)
*
* Every other suffixes are compared alphanumerical.
* An empty prefix is always considered newer than an unknown non-emtpy suffix (e.g. not one of the above.)
*
* @return \li -1 if suffix1 is less than suffix2
* \li 0 if suffix1 equals suffix2 (be aware that this is not the same as comparing to strings as
* alphaX equals aX in this case.)
* \li 1 if suffix1 is greater than suffix2
*/
static int compareSuffix( const QString& suffix1, const QString& suffix2 );
private:
static void splitVersionString( const QString& s, int& num, QString& suffix );
QString m_versionString;
int m_majorVersion;
int m_minorVersion;
int m_patchLevel;
QString m_suffix;
};
LIBK3B_EXPORT bool operator<( const K3bVersion& v1, const K3bVersion& v2 );
LIBK3B_EXPORT bool operator>( const K3bVersion& v1, const K3bVersion& v2 );
LIBK3B_EXPORT bool operator==( const K3bVersion& v1, const K3bVersion& v2 );
LIBK3B_EXPORT bool operator<=( const K3bVersion& v1, const K3bVersion& v2 );
LIBK3B_EXPORT bool operator>=( const K3bVersion& v1, const K3bVersion& v2 );
#endif