AuroraMiddleware/qt5base-lts
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Document Q_NODISCARD_CTOR

Browse Source 
Found in API review.

Amends 959800f6de.

Pick-to: 6.6
Change-Id: I00877ce7030c638765b495089899c022deb31a27
Reviewed-by: Ivan Solovev <ivan.solovev@qt.io>
This commit is contained in:
Marc Mutz 2023-06-21 11:22:15 +02:00
parent f403ef428e
commit 4968f8418f
1 changed files with 18 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

18
src/corelib/global/qcompilerdetection.qdoc
View File

@ -392,3 +392,21 @@
If this macro is used outside a function, the behavior is undefined.
*/
/*!
\macro Q_NODISCARD_CTOR
\relates <QtCompilerDetection>
\since 6.6
\brief Expands to \c{[[nodiscard]]} on compilers that accept it on constructors.
Otherwise it expands to nothing.
Constructors marked as Q_NODISCARD_CTOR cause a compiler warning if a call
site doesn't use the resulting object.
This macro is exists solely to prevent warnings on compilers that don't
implement the feature. If your supported platforms all allow \c{[[nodiscard]]}
on constructors, we strongly recommend you use the C++ attribute directly instead
of this macro.
*/