From 8d6b274fa4c65e87443c0fbf8425229230385405 Mon Sep 17 00:00:00 2001 From: Sona Kurazyan Date: Wed, 27 Jul 2022 15:57:58 +0200 Subject: Extract header qtversionchecks.h from qglobal.h Task-number: QTBUG-99313 Change-Id: Iaaa6a055367e861d095b92e3e85e5bc340e6bbc1 Reviewed-by: Thiago Macieira --- src/corelib/global/qtversionchecks.cpp | 46 ++++++++++++++++++++++++++++++++++ 1 file changed, 46 insertions(+) create mode 100644 src/corelib/global/qtversionchecks.cpp (limited to 'src/corelib/global/qtversionchecks.cpp') diff --git a/src/corelib/global/qtversionchecks.cpp b/src/corelib/global/qtversionchecks.cpp new file mode 100644 index 0000000000..1e80eab63c --- /dev/null +++ b/src/corelib/global/qtversionchecks.cpp @@ -0,0 +1,46 @@ +// Copyright (C) 2022 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only + +/*! + \macro QT_VERSION_CHECK(major, minor, patch) + \relates + + Turns the \a major, \a minor and \a patch numbers of a version into an + integer that encodes all three. When expressed in hexadecimal, this integer + is of form \c 0xMMNNPP wherein \c{0xMM ==} \a major, \c{0xNN ==} \a minor, + and \c{0xPP ==} \a patch. This can be compared with another similarly + processed version ID. + + Example: + + \snippet code/src_corelib_global_qglobal.cpp qt-version-check + + \note the parameters are read as integers in the normal way, so should + normally be written in decimal (so a \c 0x prefix must be used if writing + them in hexadecimal). Thus \c{QT_VERSION_CHECK(5, 15, 0)} is equal to \c + 0x050f00, which could equally be written \c{QT_VERSION_CHECK(5, 0xf, 0)}. + + \sa QT_VERSION +*/ + +/*! + \macro QT_VERSION + \relates + + This macro expands to a numeric value of the same form as \l + QT_VERSION_CHECK() constructs, that specifies the version of Qt with which + code using it is compiled. For example, if you compile your application with + Qt 6.1.2, the QT_VERSION macro will expand to \c 0x060102, the same as + \c{QT_VERSION_CHECK(6, 1, 2)}. Note that this need not agree with the + version the application will find itself using at \e runtime. + + You can use QT_VERSION to select the latest Qt features where available + while falling back to older implementations otherwise. Using + QT_VERSION_CHECK() for the value to compare with is recommended. + + Example: + + \snippet code/src_corelib_global_qglobal.cpp 16 + + \sa QT_VERSION_STR, QT_VERSION_CHECK(), qVersion() +*/ -- cgit v1.2.3