Back to home page

EIC code displayed by LXR

 
 

    


Warning, file /include/QtCore/qtdeprecationmarkers.h was not indexed or was modified since last indexation (in which case cross-reference links may be missing, inaccurate or erroneous).

0001 // Copyright (C) 2022 The Qt Company Ltd.
0002 // SPDX-License-Identifier: LicenseRef-Qt-Commercial OR LGPL-3.0-only OR GPL-2.0-only OR GPL-3.0-only
0003 // Qt-Security score:significant reason:default
0004 
0005 #ifndef QTDEPRECATIONMARKERS_H
0006 #define QTDEPRECATIONMARKERS_H
0007 
0008 #include <QtCore/qtconfigmacros.h>
0009 #include <QtCore/qtclasshelpermacros.h>
0010 #include <QtCore/qtdeprecationdefinitions.h>
0011 #include <QtCore/qtversionchecks.h>
0012 #include <QtCore/qcompilerdetection.h> // for Q_DECL_DEPRECATED
0013 
0014 #if 0
0015 #pragma qt_class(QtDeprecationMarkers)
0016 #pragma qt_sync_stop_processing
0017 #endif
0018 
0019 QT_BEGIN_NAMESPACE
0020 
0021 #if defined(QT_NO_DEPRECATED)
0022 /* undef, so as to cause compile-errors when they're used outside #if QT_DEPRECATED_SINCE blocks */
0023 #  undef QT_DEPRECATED
0024 #  undef QT_DEPRECATED_X
0025 #  undef QT_DEPRECATED_VARIABLE
0026 #  undef QT_DEPRECATED_CONSTRUCTOR
0027 #elif !defined(QT_NO_DEPRECATED_WARNINGS)
0028 #  undef QT_DEPRECATED
0029 #  define QT_DEPRECATED Q_DECL_DEPRECATED
0030 #  undef QT_DEPRECATED_X
0031 #  define QT_DEPRECATED_X(text) Q_DECL_DEPRECATED_X(text)
0032 #  undef QT_DEPRECATED_VARIABLE
0033 #  define QT_DEPRECATED_VARIABLE Q_DECL_VARIABLE_DEPRECATED
0034 #  undef QT_DEPRECATED_CONSTRUCTOR
0035 #  define QT_DEPRECATED_CONSTRUCTOR Q_DECL_CONSTRUCTOR_DEPRECATED explicit
0036 #else
0037 #  undef QT_DEPRECATED
0038 #  define QT_DEPRECATED
0039 #  undef QT_DEPRECATED_X
0040 #  define QT_DEPRECATED_X(text)
0041 #  undef QT_DEPRECATED_VARIABLE
0042 #  define QT_DEPRECATED_VARIABLE
0043 #  undef QT_DEPRECATED_CONSTRUCTOR
0044 #  define QT_DEPRECATED_CONSTRUCTOR
0045 #  undef Q_DECL_ENUMERATOR_DEPRECATED
0046 #  define Q_DECL_ENUMERATOR_DEPRECATED
0047 #  undef Q_DECL_ENUMERATOR_DEPRECATED_X
0048 #  define Q_DECL_ENUMERATOR_DEPRECATED_X(ignored)
0049 #endif
0050 
0051 /*
0052     QT_DEPRECATED_SINCE(major, minor) evaluates as true if the Qt version is greater than
0053     the deprecation point specified.
0054 
0055     Use it to specify from which version of Qt a function or class has been deprecated
0056 
0057     Example:
0058         #if QT_DEPRECATED_SINCE(5,1)
0059             QT_DEPRECATED void deprecatedFunction(); //function deprecated since Qt 5.1
0060         #endif
0061 
0062 */
0063 #ifdef QT_DEPRECATED
0064 #define QT_DEPRECATED_SINCE(major, minor) (QT_VERSION_CHECK(major, minor, 0) > QT_DISABLE_DEPRECATED_UP_TO)
0065 #else
0066 #define QT_DEPRECATED_SINCE(major, minor) 0
0067 #endif
0068 
0069 /*
0070     QT_REMOVAL_QT{VER}_DEPRECATED_SINCE(major, minor)
0071 
0072     The macro should be used if the API is deprecated and should be removed
0073     in the {VER} major release.
0074 
0075     The \a major and \a minor parameters specify the deprecation version.
0076 
0077     For now, we provide the macros to remove the deprecated APIs in Qt 7
0078     and in Qt 8.
0079 
0080     Example:
0081 
0082     \code
0083     #if QT_REMOVAL_QT7_DEPRECATED_SINCE(6, 9)
0084         QT_DEPRECATED_VERSION_X_6_9("The reason for the deprecation")
0085         void deprecatedFunc();
0086     #endif
0087     \endcode
0088 
0089     The \c {deprecatedFunc()} function is deprecated since Qt 6.9, and will be
0090     completely removed in Qt 7.0.
0091 */
0092 #define QT_DEPRECATED_TO_BE_REMOVED_HELPER(dep_major, dep_minor, rem_major) \
0093     (QT_DEPRECATED_SINCE(dep_major, dep_minor) && (QT_VERSION < QT_VERSION_CHECK(rem_major, 0, 0)))
0094 
0095 // For APIs that should be removed in Qt 7
0096 #define QT_REMOVAL_QT7_DEPRECATED_SINCE(major, minor) \
0097     QT_DEPRECATED_TO_BE_REMOVED_HELPER(major, minor, 7)
0098 
0099 // For APIs that should be removed in Qt 8
0100 #define QT_REMOVAL_QT8_DEPRECATED_SINCE(major, minor) \
0101     QT_DEPRECATED_TO_BE_REMOVED_HELPER(major, minor, 8)
0102 
0103 /*
0104   QT_DEPRECATED_VERSION(major, minor) and QT_DEPRECATED_VERSION_X(major, minor, text)
0105   outputs a deprecation warning if QT_WARN_DEPRECATED_UP_TO is equal to or greater
0106   than the version specified as major, minor. This makes it possible to deprecate a
0107   function without annoying a user who needs to stay compatible with a specified minimum
0108   version and therefore can't use the new function.
0109 */
0110 #if QT_WARN_DEPRECATED_UP_TO >= QT_VERSION_CHECK(5, 12, 0)
0111 # define QT_DEPRECATED_VERSION_X_5_12(text) QT_DEPRECATED_X(text)
0112 # define QT_DEPRECATED_VERSION_5_12         QT_DEPRECATED
0113 #else
0114 # define QT_DEPRECATED_VERSION_X_5_12(text)
0115 # define QT_DEPRECATED_VERSION_5_12
0116 #endif
0117 
0118 #if QT_WARN_DEPRECATED_UP_TO >= QT_VERSION_CHECK(5, 13, 0)
0119 # define QT_DEPRECATED_VERSION_X_5_13(text) QT_DEPRECATED_X(text)
0120 # define QT_DEPRECATED_VERSION_5_13         QT_DEPRECATED
0121 #else
0122 # define QT_DEPRECATED_VERSION_X_5_13(text)
0123 # define QT_DEPRECATED_VERSION_5_13
0124 #endif
0125 
0126 #if QT_WARN_DEPRECATED_UP_TO >= QT_VERSION_CHECK(5, 14, 0)
0127 # define QT_DEPRECATED_VERSION_X_5_14(text) QT_DEPRECATED_X(text)
0128 # define QT_DEPRECATED_VERSION_5_14         QT_DEPRECATED
0129 #else
0130 # define QT_DEPRECATED_VERSION_X_5_14(text)
0131 # define QT_DEPRECATED_VERSION_5_14
0132 #endif
0133 
0134 #if QT_WARN_DEPRECATED_UP_TO >= QT_VERSION_CHECK(5, 15, 0)
0135 # define QT_DEPRECATED_VERSION_X_5_15(text) QT_DEPRECATED_X(text)
0136 # define QT_DEPRECATED_VERSION_5_15         QT_DEPRECATED
0137 #else
0138 # define QT_DEPRECATED_VERSION_X_5_15(text)
0139 # define QT_DEPRECATED_VERSION_5_15
0140 #endif
0141 
0142 #if QT_WARN_DEPRECATED_UP_TO >= QT_VERSION_CHECK(6, 0, 0)
0143 # define QT_DEPRECATED_VERSION_X_6_0(text) QT_DEPRECATED_X(text)
0144 # define QT_DEPRECATED_VERSION_6_0         QT_DEPRECATED
0145 #else
0146 # define QT_DEPRECATED_VERSION_X_6_0(text)
0147 # define QT_DEPRECATED_VERSION_6_0
0148 #endif
0149 
0150 #if QT_WARN_DEPRECATED_UP_TO >= QT_VERSION_CHECK(6, 1, 0)
0151 # define QT_DEPRECATED_VERSION_X_6_1(text) QT_DEPRECATED_X(text)
0152 # define QT_DEPRECATED_VERSION_6_1         QT_DEPRECATED
0153 #else
0154 # define QT_DEPRECATED_VERSION_X_6_1(text)
0155 # define QT_DEPRECATED_VERSION_6_1
0156 #endif
0157 
0158 #if QT_WARN_DEPRECATED_UP_TO >= QT_VERSION_CHECK(6, 2, 0)
0159 # define QT_DEPRECATED_VERSION_X_6_2(text) QT_DEPRECATED_X(text)
0160 # define QT_DEPRECATED_VERSION_6_2         QT_DEPRECATED
0161 #else
0162 # define QT_DEPRECATED_VERSION_X_6_2(text)
0163 # define QT_DEPRECATED_VERSION_6_2
0164 #endif
0165 
0166 #if QT_WARN_DEPRECATED_UP_TO >= QT_VERSION_CHECK(6, 3, 0)
0167 # define QT_DEPRECATED_VERSION_X_6_3(text) QT_DEPRECATED_X(text)
0168 # define QT_DEPRECATED_VERSION_6_3         QT_DEPRECATED
0169 #else
0170 # define QT_DEPRECATED_VERSION_X_6_3(text)
0171 # define QT_DEPRECATED_VERSION_6_3
0172 #endif
0173 
0174 #if QT_WARN_DEPRECATED_UP_TO >= QT_VERSION_CHECK(6, 4, 0)
0175 # define QT_DEPRECATED_VERSION_X_6_4(text) QT_DEPRECATED_X(text)
0176 # define QT_DEPRECATED_VERSION_6_4         QT_DEPRECATED
0177 #else
0178 # define QT_DEPRECATED_VERSION_X_6_4(text)
0179 # define QT_DEPRECATED_VERSION_6_4
0180 #endif
0181 
0182 #if QT_WARN_DEPRECATED_UP_TO >= QT_VERSION_CHECK(6, 5, 0)
0183 # define QT_DEPRECATED_VERSION_X_6_5(text) QT_DEPRECATED_X(text)
0184 # define QT_DEPRECATED_VERSION_6_5         QT_DEPRECATED
0185 #else
0186 # define QT_DEPRECATED_VERSION_X_6_5(text)
0187 # define QT_DEPRECATED_VERSION_6_5
0188 #endif
0189 
0190 #if QT_WARN_DEPRECATED_UP_TO >= QT_VERSION_CHECK(6, 6, 0)
0191 # define QT_DEPRECATED_VERSION_X_6_6(text) QT_DEPRECATED_X(text)
0192 # define QT_DEPRECATED_VERSION_6_6         QT_DEPRECATED
0193 #else
0194 # define QT_DEPRECATED_VERSION_X_6_6(text)
0195 # define QT_DEPRECATED_VERSION_6_6
0196 #endif
0197 
0198 #if QT_WARN_DEPRECATED_UP_TO >= QT_VERSION_CHECK(6, 7, 0)
0199 # define QT_DEPRECATED_VERSION_X_6_7(text) QT_DEPRECATED_X(text)
0200 # define QT_DEPRECATED_VERSION_6_7         QT_DEPRECATED
0201 #else
0202 # define QT_DEPRECATED_VERSION_X_6_7(text)
0203 # define QT_DEPRECATED_VERSION_6_7
0204 #endif
0205 
0206 #if QT_WARN_DEPRECATED_UP_TO >= QT_VERSION_CHECK(6, 8, 0)
0207 # define QT_DEPRECATED_VERSION_X_6_8(text) QT_DEPRECATED_X(text)
0208 # define QT_DEPRECATED_VERSION_6_8         QT_DEPRECATED
0209 #else
0210 # define QT_DEPRECATED_VERSION_X_6_8(text)
0211 # define QT_DEPRECATED_VERSION_6_8
0212 #endif
0213 
0214 #if QT_WARN_DEPRECATED_UP_TO >= QT_VERSION_CHECK(6, 9, 0)
0215 # define QT_DEPRECATED_VERSION_X_6_9(text) QT_DEPRECATED_X(text)
0216 # define QT_DEPRECATED_VERSION_6_9         QT_DEPRECATED
0217 #else
0218 # define QT_DEPRECATED_VERSION_X_6_9(text)
0219 # define QT_DEPRECATED_VERSION_6_9
0220 #endif
0221 
0222 #if QT_WARN_DEPRECATED_UP_TO >= QT_VERSION_CHECK(6, 10, 0)
0223 # define QT_DEPRECATED_VERSION_X_6_10(text) QT_DEPRECATED_X(text)
0224 # define QT_DEPRECATED_VERSION_6_10         QT_DEPRECATED
0225 #else
0226 # define QT_DEPRECATED_VERSION_X_6_10(text)
0227 # define QT_DEPRECATED_VERSION_6_10
0228 #endif
0229 
0230 #if QT_WARN_DEPRECATED_UP_TO >= QT_VERSION_CHECK(6, 11, 0)
0231 # define QT_DEPRECATED_VERSION_X_6_11(text) QT_DEPRECATED_X(text)
0232 # define QT_DEPRECATED_VERSION_6_11         QT_DEPRECATED
0233 #else
0234 # define QT_DEPRECATED_VERSION_X_6_11(text)
0235 # define QT_DEPRECATED_VERSION_6_11
0236 #endif
0237 
0238 #if QT_WARN_DEPRECATED_UP_TO >= QT_VERSION_CHECK(6, 12, 0)
0239 # define QT_DEPRECATED_VERSION_X_6_12(text) QT_DEPRECATED_X(text)
0240 # define QT_DEPRECATED_VERSION_6_12         QT_DEPRECATED
0241 #else
0242 # define QT_DEPRECATED_VERSION_X_6_12(text)
0243 # define QT_DEPRECATED_VERSION_6_12
0244 #endif
0245 
0246 #if QT_WARN_DEPRECATED_UP_TO >= QT_VERSION_CHECK(6, 13, 0)
0247 # define QT_DEPRECATED_VERSION_X_6_13(text) QT_DEPRECATED_X(text)
0248 # define QT_DEPRECATED_VERSION_6_13         QT_DEPRECATED
0249 #else
0250 # define QT_DEPRECATED_VERSION_X_6_13(text)
0251 # define QT_DEPRECATED_VERSION_6_13
0252 #endif
0253 
0254 #if QT_WARN_DEPRECATED_UP_TO >= QT_VERSION_CHECK(6, 14, 0)
0255 # define QT_DEPRECATED_VERSION_X_6_14(text) QT_DEPRECATED_X(text)
0256 # define QT_DEPRECATED_VERSION_6_14         QT_DEPRECATED
0257 #else
0258 # define QT_DEPRECATED_VERSION_X_6_14(text)
0259 # define QT_DEPRECATED_VERSION_6_14
0260 #endif
0261 
0262 #if QT_WARN_DEPRECATED_UP_TO >= QT_VERSION_CHECK(6, 15, 0)
0263 # define QT_DEPRECATED_VERSION_X_6_15(text) QT_DEPRECATED_X(text)
0264 # define QT_DEPRECATED_VERSION_6_15         QT_DEPRECATED
0265 #else
0266 # define QT_DEPRECATED_VERSION_X_6_15(text)
0267 # define QT_DEPRECATED_VERSION_6_15
0268 #endif
0269 
0270 #if QT_WARN_DEPRECATED_UP_TO >= QT_VERSION_CHECK(6, 16, 0)
0271 # define QT_DEPRECATED_VERSION_X_6_16(text) QT_DEPRECATED_X(text)
0272 # define QT_DEPRECATED_VERSION_6_16         QT_DEPRECATED
0273 #else
0274 # define QT_DEPRECATED_VERSION_X_6_16(text)
0275 # define QT_DEPRECATED_VERSION_6_16
0276 #endif
0277 
0278 #define QT_DEPRECATED_VERSION_X_5(minor, text)      QT_DEPRECATED_VERSION_X_5_##minor(text)
0279 #define QT_DEPRECATED_VERSION_X(major, minor, text) QT_DEPRECATED_VERSION_X_##major##_##minor(text)
0280 
0281 #define QT_DEPRECATED_VERSION_5(minor)      QT_DEPRECATED_VERSION_5_##minor
0282 #define QT_DEPRECATED_VERSION(major, minor) QT_DEPRECATED_VERSION_##major##_##minor
0283 
0284 /*
0285     QT_IF_DEPRECATED_SINCE(major, minor, whenTrue, whenFalse) expands to
0286     \a whenTrue if the specified (\a major, \a minor) version is less than or
0287     equal to the deprecation version defined by QT_DISABLE_DEPRECATED_UP_TO,
0288     and to \a whenFalse otherwise.
0289 
0290     Currently used for QT_INLINE_SINCE(maj, min), but can also be helpful for
0291     other macros of that kind.
0292 
0293     The implementation uses QT_DEPRECATED_SINCE(maj, min) to define a bunch of
0294     helper QT_IF_DEPRECATED_SINCE_X_Y macros, which expand to \a whenTrue or
0295     \a whenFalse depending on the value of QT_DEPRECATED_SINCE.
0296 
0297     If you need to use QT_IF_DEPRECATED_SINCE() for a (major, minor) version,
0298     that is not yet covered by the list below, you need to copy the definition
0299     and change the major and minor versions accordingly. For example, for
0300     version (X, Y), you will need to add
0301 
0302     \code
0303     #if QT_DEPRECATED_SINCE(X, Y)
0304     # define QT_IF_DEPRECATED_SINCE_X_Y(whenTrue, whenFalse) whenFalse
0305     #else
0306     # define QT_IF_DEPRECATED_SINCE_X_Y(whenTrue, whenFalse) whenTrue
0307     #endif
0308     \endcode
0309 */
0310 
0311 #define QT_IF_DEPRECATED_SINCE(major, minor, whenTrue, whenFalse) \
0312     QT_IF_DEPRECATED_SINCE_ ## major ## _ ## minor(whenTrue, whenFalse)
0313 
0314 #if QT_DEPRECATED_SINCE(6, 0)
0315 # define QT_IF_DEPRECATED_SINCE_6_0(whenTrue, whenFalse) whenFalse
0316 #else
0317 # define QT_IF_DEPRECATED_SINCE_6_0(whenTrue, whenFalse) whenTrue
0318 #endif
0319 
0320 #if QT_DEPRECATED_SINCE(6, 1)
0321 # define QT_IF_DEPRECATED_SINCE_6_1(whenTrue, whenFalse) whenFalse
0322 #else
0323 # define QT_IF_DEPRECATED_SINCE_6_1(whenTrue, whenFalse) whenTrue
0324 #endif
0325 
0326 #if QT_DEPRECATED_SINCE(6, 2)
0327 # define QT_IF_DEPRECATED_SINCE_6_2(whenTrue, whenFalse) whenFalse
0328 #else
0329 # define QT_IF_DEPRECATED_SINCE_6_2(whenTrue, whenFalse) whenTrue
0330 #endif
0331 
0332 #if QT_DEPRECATED_SINCE(6, 3)
0333 # define QT_IF_DEPRECATED_SINCE_6_3(whenTrue, whenFalse) whenFalse
0334 #else
0335 # define QT_IF_DEPRECATED_SINCE_6_3(whenTrue, whenFalse) whenTrue
0336 #endif
0337 
0338 #if QT_DEPRECATED_SINCE(6, 4)
0339 # define QT_IF_DEPRECATED_SINCE_6_4(whenTrue, whenFalse) whenFalse
0340 #else
0341 # define QT_IF_DEPRECATED_SINCE_6_4(whenTrue, whenFalse) whenTrue
0342 #endif
0343 
0344 #if QT_DEPRECATED_SINCE(6, 5)
0345 # define QT_IF_DEPRECATED_SINCE_6_5(whenTrue, whenFalse) whenFalse
0346 #else
0347 # define QT_IF_DEPRECATED_SINCE_6_5(whenTrue, whenFalse) whenTrue
0348 #endif
0349 
0350 #if QT_DEPRECATED_SINCE(6, 6)
0351 # define QT_IF_DEPRECATED_SINCE_6_6(whenTrue, whenFalse) whenFalse
0352 #else
0353 # define QT_IF_DEPRECATED_SINCE_6_6(whenTrue, whenFalse) whenTrue
0354 #endif
0355 
0356 #if QT_DEPRECATED_SINCE(6, 7)
0357 # define QT_IF_DEPRECATED_SINCE_6_7(whenTrue, whenFalse) whenFalse
0358 #else
0359 # define QT_IF_DEPRECATED_SINCE_6_7(whenTrue, whenFalse) whenTrue
0360 #endif
0361 
0362 #if QT_DEPRECATED_SINCE(6, 8)
0363 # define QT_IF_DEPRECATED_SINCE_6_8(whenTrue, whenFalse) whenFalse
0364 #else
0365 # define QT_IF_DEPRECATED_SINCE_6_8(whenTrue, whenFalse) whenTrue
0366 #endif
0367 
0368 #if QT_DEPRECATED_SINCE(6, 9)
0369 # define QT_IF_DEPRECATED_SINCE_6_9(whenTrue, whenFalse) whenFalse
0370 #else
0371 # define QT_IF_DEPRECATED_SINCE_6_9(whenTrue, whenFalse) whenTrue
0372 #endif
0373 
0374 #if QT_DEPRECATED_SINCE(6, 10)
0375 # define QT_IF_DEPRECATED_SINCE_6_10(whenTrue, whenFalse) whenFalse
0376 #else
0377 # define QT_IF_DEPRECATED_SINCE_6_10(whenTrue, whenFalse) whenTrue
0378 #endif
0379 
0380 #if QT_DEPRECATED_SINCE(6, 11)
0381 # define QT_IF_DEPRECATED_SINCE_6_11(whenTrue, whenFalse) whenFalse
0382 #else
0383 # define QT_IF_DEPRECATED_SINCE_6_11(whenTrue, whenFalse) whenTrue
0384 #endif
0385 
0386 #if QT_DEPRECATED_SINCE(6, 12)
0387 # define QT_IF_DEPRECATED_SINCE_6_12(whenTrue, whenFalse) whenFalse
0388 #else
0389 # define QT_IF_DEPRECATED_SINCE_6_12(whenTrue, whenFalse) whenTrue
0390 #endif
0391 
0392 #if QT_DEPRECATED_SINCE(6, 13)
0393 # define QT_IF_DEPRECATED_SINCE_6_13(whenTrue, whenFalse) whenFalse
0394 #else
0395 # define QT_IF_DEPRECATED_SINCE_6_13(whenTrue, whenFalse) whenTrue
0396 #endif
0397 
0398 #if QT_DEPRECATED_SINCE(6, 14)
0399 # define QT_IF_DEPRECATED_SINCE_6_14(whenTrue, whenFalse) whenFalse
0400 #else
0401 # define QT_IF_DEPRECATED_SINCE_6_14(whenTrue, whenFalse) whenTrue
0402 #endif
0403 
0404 #if QT_DEPRECATED_SINCE(6, 15)
0405 # define QT_IF_DEPRECATED_SINCE_6_15(whenTrue, whenFalse) whenFalse
0406 #else
0407 # define QT_IF_DEPRECATED_SINCE_6_15(whenTrue, whenFalse) whenTrue
0408 #endif
0409 
0410 #if QT_DEPRECATED_SINCE(6, 16)
0411 # define QT_IF_DEPRECATED_SINCE_6_16(whenTrue, whenFalse) whenFalse
0412 #else
0413 # define QT_IF_DEPRECATED_SINCE_6_16(whenTrue, whenFalse) whenTrue
0414 #endif
0415 
0416 #ifdef __cplusplus
0417 // A tag to help mark stuff deprecated (cf. QStringViewLiteral)
0418 namespace QtPrivate {
0419 inline QT_DEFINE_TAG(Deprecated);
0420 }
0421 #endif
0422 
0423 #ifdef QT_ASCII_CAST_WARNINGS
0424 #  define QT_ASCII_CAST_WARN \
0425     Q_DECL_DEPRECATED_X("Use fromUtf8, QStringLiteral, or QLatin1StringView")
0426 #else
0427 #  define QT_ASCII_CAST_WARN
0428 #endif
0429 
0430 QT_END_NAMESPACE
0431 
0432 #endif // QTDEPRECATIONMARKERS_H