1 files changed, 141 insertions, 0 deletions
diff --git a/libk3b/core/k3bversion.h b/libk3b/core/k3bversion.h
new file mode 100644
index 0000000..a6e3aee
--- /dev/null
+++ b/libk3b/core/k3bversion.h
@@ -0,0 +1,141 @@
+/* 
+ *
+ * $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