1berry/qtbase
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Doc: Remove "Container keywords" section from containers.html

Browse Source 
For foreach, we just mention that it is deprecated, and forever is not
actually directly related to Qt containers. Both macros are also
documented in qglobal.cpp, and the section title is not referenced
anywhere so this patch won't break any links.

Change-Id: I6c3e11b205237e5b502173f2216606adf5812f55
Reviewed-by: Paul Wicking <paul.wicking@qt.io>
(cherry picked from commit 4b3cb1329a36448bc636c9e43ed53b8b9e102acd)
Reviewed-by: Qt Cherry-pick Bot <cherrypick_bot@qt-project.org>
This commit is contained in:
Kai Köhne 2022-08-18 16:51:10 +02:00 committed by Qt Cherry-pick Bot
parent bff67a3ebf
commit b92f6dac20
1 changed files with 1 additions and 23 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

24
src/corelib/doc/src/containers.qdoc
View File

@ -333,28 +333,6 @@
on Java's iterator classes.
New code should should prefer \l{STL-Style Iterators}.
\section1 Container keywords
\target foreach
\section2 The foreach Keyword
\l{foreach-keyword}{The foreach keyword} is discouraged, new code should
prefer C++11 range-based loops.
\target forever
\section2 The forever keyword.
In addition to \c foreach, Qt also provides a \c forever
pseudo-keyword for infinite loops:
\snippet code/doc_src_containers.cpp 21
If you're worried about namespace pollution, you can disable
these macros by adding the following line to your \c .pro file:
\snippet code/doc_src_containers.cpp 22
\note The alternative macros Q_FOREACH and Q_FOREVER remain defined
regardless.
\section1 Qt containers compared with std containers
\table
@ -410,7 +388,7 @@
Qt includes other template classes that resemble containers in
some respects. These classes don't provide iterators and cannot
be used with the \c foreach keyword.
be used with the \l foreach keyword.
\list
\li QCache<Key, T> provides a cache to store objects of a certain