QOperatingSystemVersion Class

The QOperatingSystemVersion class provides information about the operating system version. More...

Header: #include <QOperatingSystemVersion>
qmake: QT += core
Since: Qt 5.9

This class was introduced in Qt 5.9.

Public Types

enum OSType { Android, IOS, MacOS, TvOS, ..., Unknown }

Static Public Members

const QOperatingSystemVersion AndroidJellyBean
const QOperatingSystemVersion AndroidJellyBean_MR1
const QOperatingSystemVersion AndroidJellyBean_MR2
const QOperatingSystemVersion AndroidKitKat
const QOperatingSystemVersion AndroidLollipop
const QOperatingSystemVersion AndroidLollipop_MR1
const QOperatingSystemVersion AndroidMarshmallow
const QOperatingSystemVersion AndroidNougat
const QOperatingSystemVersion AndroidNougat_MR1
const QOperatingSystemVersion AndroidOreo
const QOperatingSystemVersion MacOSHighSierra
const QOperatingSystemVersion MacOSMojave
const QOperatingSystemVersion MacOSSierra
const QOperatingSystemVersion OSXElCapitan
const QOperatingSystemVersion OSXMavericks
const QOperatingSystemVersion OSXYosemite
const QOperatingSystemVersion Windows7
const QOperatingSystemVersion Windows8
const QOperatingSystemVersion Windows10
const QOperatingSystemVersion Windows8_1

Detailed Description

Unlike other version functions in QSysInfo, QOperatingSystemVersion provides access to the full version number that developers typically use to vary behavior or determine whether to enable APIs or features based on the operating system version (as opposed to the kernel version number or marketing version).

This class is also a complete replacement for QSysInfo::macVersion and QSysInfo::windowsVersion, additionally providing access to the third (micro) version number component.

Presently, Android, Apple Platforms (iOS, macOS, tvOS, and watchOS), and Windows are supported.

The majorVersion(), minorVersion(), and microVersion() functions return the parts of the operating system version number based on:

PlatformsValue
Androidresult of parsing android.os.Build.VERSION.RELEASE using QVersionNumber, with a fallback to android.os.Build.VERSION.SDK_INT to determine the major and minor version component if the former fails
Apple PlatformsmajorVersion, minorVersion, and patchVersion from NSProcessInfo.operatingSystemVersion
WindowsdwMajorVersion, dwMinorVersion, and dwBuildNumber from RtlGetVersion - note that this function ALWAYS return the version number of the underlying operating system, as opposed to the shim underneath GetVersionEx that hides the real version number if the application is not manifested for that version of the OS

Because QOperatingSystemVersion stores both a version number and an OS type, the OS type can be taken into account when performing comparisons. For example, on a macOS system running macOS Sierra (v10.12), the following expression will return false even though the major version number component of the object on the left hand side of the expression (10) is greater than that of the object on the right (9):


      QOperatingSystemVersion::current() >= QOperatingSystemVersion(QOperatingSystemVersion::IOS, 9)

This allows expressions for multiple operating systems to be joined with a logical OR operator and still work as expected. For example:


      auto current = QOperatingSystemVersion::current();
      if (current >= QOperatingSystemVersion::OSXYosemite ||
          current >= QOperatingSystemVersion(QOperatingSystemVersion::IOS, 8)) {
          // returns true on macOS >= 10.10 and iOS >= 8.0, but false on macOS < 10.10 and iOS < 8.0
      }

A more naive comparison algorithm might incorrectly return true on all versions of macOS, including Mac OS 9. This behavior is achieved by overloading the comparison operators to return false whenever the OS types of the QOperatingSystemVersion instances being compared do not match. Be aware that due to this it can be the case x >= y and x < y are BOTH false for the same instances of x and y.

Member Type Documentation

enum QOperatingSystemVersion::OSType

This enum provides symbolic names for the various operating system families supported by QOperatingSystemVersion.

ConstantValueDescription
QOperatingSystemVersion::Android6The Google Android operating system.
QOperatingSystemVersion::IOS3The Apple iOS operating system.
QOperatingSystemVersion::MacOS2The Apple macOS operating system.
QOperatingSystemVersion::TvOS4The Apple tvOS operating system.
QOperatingSystemVersion::WatchOS5The Apple watchOS operating system.
QOperatingSystemVersion::Windows1The Microsoft Windows operating system.
QOperatingSystemVersion::Unknown0An unknown or unsupported operating system.

Member Variable Documentation

const QOperatingSystemVersion QOperatingSystemVersion::AndroidJellyBean

This variable holds a version corresponding to Android Jelly Bean (version 4.1, API level 16).

This documentation was introduced in Qt 5.9.

const QOperatingSystemVersion QOperatingSystemVersion::AndroidJellyBean_MR1

This variable holds a version corresponding to Android Jelly Bean, maintenance release 1 (version 4.2, API level 17).

This documentation was introduced in Qt 5.9.

const QOperatingSystemVersion QOperatingSystemVersion::AndroidJellyBean_MR2

This variable holds a version corresponding to Android Jelly Bean, maintenance release 2 (version 4.3, API level 18).

This documentation was introduced in Qt 5.9.

const QOperatingSystemVersion QOperatingSystemVersion::AndroidKitKat

This variable holds a version corresponding to Android KitKat (versions 4.4 & 4.4W, API levels 19 & 20).

This documentation was introduced in Qt 5.9.

const QOperatingSystemVersion QOperatingSystemVersion::AndroidLollipop

This variable holds a version corresponding to Android Lollipop (version 5.0, API level 21).

This documentation was introduced in Qt 5.9.

const QOperatingSystemVersion QOperatingSystemVersion::AndroidLollipop_MR1

This variable holds a version corresponding to Android Lollipop, maintenance release 1 (version 5.1, API level 22).

This documentation was introduced in Qt 5.9.

const QOperatingSystemVersion QOperatingSystemVersion::AndroidMarshmallow

This variable holds a version corresponding to Android Marshmallow (version 6.0, API level 23).

This documentation was introduced in Qt 5.9.

const QOperatingSystemVersion QOperatingSystemVersion::AndroidNougat

This variable holds a version corresponding to Android Nougat (version 7.0, API level 24).

This documentation was introduced in Qt 5.9.

const QOperatingSystemVersion QOperatingSystemVersion::AndroidNougat_MR1

This variable holds a version corresponding to Android Nougat, maintenance release 1 (version 7.0, API level 25).

This documentation was introduced in Qt 5.9.

const QOperatingSystemVersion QOperatingSystemVersion::AndroidOreo

This variable holds a version corresponding to Android Oreo (version 8.0, API level 26).

This documentation was introduced in Qt 5.9.2.

const QOperatingSystemVersion QOperatingSystemVersion::MacOSHighSierra

This variable holds a version corresponding to macOS High Sierra (version 10.13).

This documentation was introduced in Qt 5.9.1.

const QOperatingSystemVersion QOperatingSystemVersion::MacOSMojave

This variable holds a version corresponding to macOS Mojave (version 10.14).

This documentation was introduced in Qt 5.11.2.

const QOperatingSystemVersion QOperatingSystemVersion::MacOSSierra

This variable holds a version corresponding to macOS Sierra (version 10.12).

This documentation was introduced in Qt 5.9.

const QOperatingSystemVersion QOperatingSystemVersion::OSXElCapitan

This variable holds a version corresponding to OS X El Capitan (version 10.11).

This documentation was introduced in Qt 5.9.

const QOperatingSystemVersion QOperatingSystemVersion::OSXMavericks

This variable holds a version corresponding to OS X Mavericks (version 10.9).

This documentation was introduced in Qt 5.9.

const QOperatingSystemVersion QOperatingSystemVersion::OSXYosemite

This variable holds a version corresponding to OS X Yosemite (version 10.10).

This documentation was introduced in Qt 5.9.

const QOperatingSystemVersion QOperatingSystemVersion::Windows7

This variable holds a version corresponding to Windows 7 (version 6.1).

This documentation was introduced in Qt 5.9.

const QOperatingSystemVersion QOperatingSystemVersion::Windows8

This variable holds a version corresponding to Windows 8 (version 6.2).

This documentation was introduced in Qt 5.9.

const QOperatingSystemVersion QOperatingSystemVersion::Windows10

This variable holds a version corresponding to Windows 10 (version 10.0).

This documentation was introduced in Qt 5.9.

const QOperatingSystemVersion QOperatingSystemVersion::Windows8_1

This variable holds a version corresponding to Windows 8.1 (version 6.3).

This documentation was introduced in Qt 5.9.