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

Create qdoc macros for C++ class docs 2.1: qHash()

Browse Source 
Add a family of qdoc macros to document the various qHash() overloads
we have.

This patch does not change the \relates of the qHash() functions, they
remain as inconsistent as they have been. Created QTBUG-129815 to
clean things up. Since this author expects the \relates to change in
the future, there are different \qhash commands, and all except
\qhashbuiltin take the class name as an argument, for use in a
centrally-choreographed fix for QTBUG-129815.

As drive-by's, fix:
- missing documentation about Key having to support qHash() in the
  associative Qt containers
- drop noexcept and default arguments from \fn lines that needed to
  have their argument names changed
- move the QStringView overload from qhash.cpp to qstringview.cpp
  (as it \relates to the former)

Fixes: QTBUG-129574
Pick-to: 6.5
Change-Id: I8e8c2edc27422cbe5823f56baf3a24d7f7050836
Reviewed-by: Ivan Solovev <ivan.solovev@qt.io>
Reviewed-by: Jaishree Vyas <jaishree.vyas@qt.io>
(cherry picked from commit 906aa1533f2267b091615d21c2d31e1742f0a520)
This commit is contained in:
Marc Mutz 2024-10-09 12:43:20 +02:00
parent a0897816f8
commit cc138604d6
42 changed files with 169 additions and 284 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

55
doc/global/cpp-doc-macros.qdocconf
View File

@ -13,3 +13,58 @@ macro.memberswap = \
"\n\n" \
"Swaps this \1 with \\a{other}. This operation is very fast and never fails." \
"\n\n"
#
# Macros for qHash()
#
macro.implqhashT = \
"\n\n" \
"Type \\c{\1} must be supported by qHash()." \
"\n\n"
macro.implqhashTS = \
"\n\n" \
"Types \\c{\1} and \\c{\2} must be supported by qHash()." \
"\n\n"
# \qhash{QClass} - generates qHash() doc for (hidden-friend) qHash() overloads
# \qhashT{QClass}{T}
# \qhashTS{QClass}{T}{S}
# QClass - the class being hashed (without decoration such as \c const, \c{&} or \c{<T>})
# T - the first template argument's name, if any
# S - the second template argument's name, if any
# The function's argument names must be \a key and \a seed, resp.
macro.qhash = \
"\n\n" \
"Returns the hash value for \\a key, using \\a seed to seed the calculation." \
"\\omit \1 \\endomit" \
"\n\n"
macro.qhashT = "\\qhash{\1}\\implqhashT{\2}"
macro.qhashTS = "\\qhash{\1}\\implqhashTS{\2}{\3}"
# \qhashold{QClass} - generates qHash() docs for (non-hidden-friend) qHash() overloads
# of class type. These should eventually go away
# \qhasholdT{QClass}{T}
# \qhasholdTS{QClass}{T}{S}
# QClass - the class being hashed (used for \relates)
# T - the first template argument's name, if any
# S - the second template argument's name, if any
# The function's argument names must be \a key and \a seed, resp.
macro.qhashold = \
"\n\n" \
"\\relates \1" \
"\\qhash{\1}"
macro.qhasholdT = "\\qhashold{\1}\\implqhashT{\2}"
macro.qhasholdTS = "\\qhashold{\1}\\implqhashTS{\2}{\3}"
# \qhashbuiltin (no arguments)
# \qhashbuiltinT{T}
# \qhashbuiltinTS{T}{S}
# For language-provided (built-in) types
# T - the first template argument's name, if any
# S - the second template argument's name, if any
# The function's argument names must be \a key and \a seed, resp.
macro.qhashbuiltin = "\\qhashold{QHash}"
macro.qhashbuiltinT = "\\qhashbuiltin\\implqhashT{\1}"
macro.qhashbuiltinTS = "\\qhashbuiltin\\implqhashTS{\1}{\2}"

7
src/corelib/global/qflags.qdoc
View File

@ -398,12 +398,9 @@
*/
/*!
\fn template <typename Enum> size_t qHash(QFlags<Enum> flags, size_t seed = 0) noexcept
\fn template <typename Enum> size_t qHash(QFlags<Enum> key, size_t seed)
\since 6.2
\relates QFlags
Calculates the hash for the flags \a flags, using \a seed
to seed the calculation.
\qhashold{QFlags}
*/
/*!

4
src/corelib/global/qfloat16.cpp
View File

@ -375,9 +375,7 @@ Q_CORE_EXPORT void qFloatFromFloat16(float *out, const qfloat16 *in, qsizetype l
/*!
\fn size_t qfloat16::qHash(qfloat16 key, size_t seed)
\since 6.5.3
Returns the hash value for the \a key, using \a seed to seed the
calculation.
\qhash{qfloat16}
\note In Qt versions before 6.5, this operation was provided by the
qHash(float) overload. In Qt versions 6.5.0 to 6.5.2, this functionality

4
src/corelib/global/qnamespace.qdoc
View File

@ -3567,9 +3567,7 @@
/*!
\fn size_t qHash(QKeyCombination key, size_t seed = 0) noexcept
\relates QKeyCombination
Returns the hash value for the \a key, using \a seed to seed the calculation.
\qhashold{QKeyCombination}
*/
#ifndef QT_NO_DEBUG_STREAM

6
src/corelib/io/qurl.cpp
View File

@ -3616,10 +3616,8 @@ QList<QUrl> QUrl::fromStringList(const QStringList &urls, ParsingMode mode)
*/
/*!
Returns the hash value for the \a url. If specified, \a seed is used to
initialize the hash.
\relates QHash
\fn size_t qHash(const QUrl &key, size_t seed)
\qhashold{QHash}
\since 5.0
*/
size_t qHash(const QUrl &url, size_t seed) noexcept

5
src/corelib/io/qurlquery.cpp
View File

@ -423,10 +423,7 @@ bool comparesEqual(const QUrlQuery &lhs, const QUrlQuery &rhs)
/*!
\since 5.6
\relates QUrlQuery
Returns the hash value for \a key,
using \a seed to seed the calculation.
\qhashold{QUrlQuery}
*/
size_t qHash(const QUrlQuery &key, size_t seed) noexcept
{

5
src/corelib/ipc/qtipccommon.cpp
View File

@ -497,9 +497,8 @@ void QNativeIpcKey::setNativeKey_internal(const QString &)
}
/*!
\fn size_t QNativeIpcKey::qHash(const QNativeIpcKey &ipcKey, size_t seed) noexcept
Returns the hash value for \a ipcKey, using \a seed to seed the calculation.
\fn size_t QNativeIpcKey::qHash(const QNativeIpcKey &key, size_t seed)
\qhash{QNativeIpcKey}
*/
size_t qHash(const QNativeIpcKey &ipcKey, size_t seed) noexcept
{

7
src/corelib/itemmodels/qabstractitemmodel.cpp
View File

@ -4153,12 +4153,9 @@ bool QAbstractListModel::dropMimeData(const QMimeData *data, Qt::DropAction acti
*/
/*!
\fn size_t qHash(const QPersistentModelIndex &index, size_t seed = 0)
\fn size_t qHash(const QPersistentModelIndex &key, size_t seed)
\since 5.0
\relates QPersistentModelIndex
Returns a hash of the QPersistentModelIndex \a index, using \a seed to
seed the calculation.
\qhashold{QPersistentModelIndex}
*/

7
src/corelib/kernel/qmetatype.cpp
View File

@ -3274,11 +3274,10 @@ static const QtPrivate::QMetaTypeInterface *interfaceForType(int typeId)
QMetaType::QMetaType(int typeId) : QMetaType(interfaceForType(typeId)) {}
/*! \fn size_t qHash(QMetaType type, size_t seed = 0)
\relates QMetaType
/*!
\fn size_t qHash(QMetaType key, size_t seed)
\qhashold{QMetaType}
\since 6.4
Returns the hash value for the \a type, using \a seed to seed the calculation.
*/
namespace QtPrivate {

5
src/corelib/mimetypes/qmimetype.cpp
View File

@ -123,10 +123,7 @@ bool comparesEqual(const QMimeType &lhs, const QMimeType &rhs) noexcept
/*!
\since 5.6
\relates QMimeType
Returns the hash value for \a key, using
\a seed to seed the calculation.
\qhashold{QMimeType}
*/
size_t qHash(const QMimeType &key, size_t seed) noexcept
{

4
src/corelib/plugin/quuid.cpp
View File

@ -996,9 +996,9 @@ QDebug operator<<(QDebug dbg, const QUuid &id)
#endif
/*!
\fn size_t qHash(const QUuid &key, size_t seed)
\since 5.0
\relates QUuid
Returns a hash of the UUID \a uuid, using \a seed to seed the calculation.
\qhashold{QUuid}
*/
size_t qHash(const QUuid &uuid, size_t seed) noexcept
{

5
src/corelib/text/qbytearray.cpp
View File

@ -5123,10 +5123,7 @@ emscripten::val QByteArray::toEcmaUint8Array()
*/
/*!
\relates QByteArray::FromBase64Result
Returns the hash value for \a key, using
\a seed to seed the calculation.
\qhashold{QByteArray::FromBase64Result}
*/
size_t qHash(const QByteArray::FromBase64Result &key, size_t seed) noexcept
{

5
src/corelib/text/qlocale.cpp
View File

@ -1196,10 +1196,7 @@ bool QLocale::equals(const QLocale &other) const noexcept
/*!
\since 5.6
\relates QLocale
Returns the hash value for \a key, using
\a seed to seed the calculation.
\qhashold{QLocale}
*/
size_t qHash(const QLocale &key, size_t seed) noexcept
{

6
src/corelib/text/qstringview.cpp
View File

@ -162,6 +162,12 @@ QT_BEGIN_NAMESPACE
\sa reverse_iterator, const_iterator
*/
/*!
\fn size_t qHash(QStringView key, size_t seed)
\since 5.10
\qhashold{QStringView}
*/
/*!
\fn QStringView::QStringView()

12
src/corelib/time/qdatetime.cpp
View File

@ -6288,10 +6288,8 @@ QDebug operator<<(QDebug dbg, const QDateTime &date)
#endif // debug_stream && datestring
/*! \fn size_t qHash(const QDateTime &key, size_t seed = 0)
\relates QHash
\qhashold{QHash}
\since 5.0
Returns the hash value for the \a key, using \a seed to seed the calculation.
*/
size_t qHash(const QDateTime &key, size_t seed)
{
@ -6303,10 +6301,8 @@ size_t qHash(const QDateTime &key, size_t seed)
}
/*! \fn size_t qHash(QDate key, size_t seed = 0)
\relates QHash
\qhashold{QHash}
\since 5.0
Returns the hash value for the \a key, using \a seed to seed the calculation.
*/
size_t qHash(QDate key, size_t seed) noexcept
{
@ -6314,10 +6310,8 @@ size_t qHash(QDate key, size_t seed) noexcept
}
/*! \fn size_t qHash(QTime key, size_t seed = 0)
\relates QHash
\qhashold{QHash}
\since 5.0
Returns the hash value for the \a key, using \a seed to seed the calculation.
*/
size_t qHash(QTime key, size_t seed) noexcept
{

139
src/corelib/tools/qhash.cpp
View File

@ -1098,11 +1098,7 @@ uint qt_hash(QStringView key, uint chained) noexcept
/*!
\fn template <typename T1, typename T2> size_t qHash(const std::pair<T1, T2> &key, size_t seed = 0)
\since 5.7
\relates QHash
Returns the hash value for the \a key, using \a seed to seed the calculation.
Types \c T1 and \c T2 must be supported by qHash().
\qhashbuiltinTS{T1}{T2}
*/
/*!
@ -1244,141 +1240,104 @@ uint qt_hash(QStringView key, uint chained) noexcept
*/
/*! \fn size_t qHash(char key, size_t seed = 0)
\relates QHash
\since 5.0
Returns the hash value for the \a key, using \a seed to seed the calculation.
\qhashbuiltin
*/
/*! \fn size_t qHash(uchar key, size_t seed = 0)
\relates QHash
\since 5.0
Returns the hash value for the \a key, using \a seed to seed the calculation.
\qhashbuiltin
*/
/*! \fn size_t qHash(signed char key, size_t seed = 0)
\relates QHash
\since 5.0
Returns the hash value for the \a key, using \a seed to seed the calculation.
\qhashbuiltin
*/
/*! \fn size_t qHash(ushort key, size_t seed = 0)
\relates QHash
\since 5.0
Returns the hash value for the \a key, using \a seed to seed the calculation.
\qhashbuiltin
*/
/*! \fn size_t qHash(short key, size_t seed = 0)
\relates QHash
\since 5.0
Returns the hash value for the \a key, using \a seed to seed the calculation.
\qhashbuiltin
*/
/*! \fn size_t qHash(uint key, size_t seed = 0)
\relates QHash
\since 5.0
Returns the hash value for the \a key, using \a seed to seed the calculation.
\qhashbuiltin
*/
/*! \fn size_t qHash(int key, size_t seed = 0)
\relates QHash
\since 5.0
Returns the hash value for the \a key, using \a seed to seed the calculation.
\qhashbuiltin
*/
/*! \fn size_t qHash(ulong key, size_t seed = 0)
\relates QHash
\since 5.0
Returns the hash value for the \a key, using \a seed to seed the calculation.
\qhashbuiltin
*/
/*! \fn size_t qHash(long key, size_t seed = 0)
\relates QHash
\since 5.0
Returns the hash value for the \a key, using \a seed to seed the calculation.
\qhashbuiltin
*/
/*! \fn size_t qHash(quint64 key, size_t seed = 0)
\relates QHash
\since 5.0
Returns the hash value for the \a key, using \a seed to seed the calculation.
\qhashbuiltin
*/
/*! \fn size_t qHash(qint64 key, size_t seed = 0)
\relates QHash
\since 5.0
Returns the hash value for the \a key, using \a seed to seed the calculation.
\qhashbuiltin
*/
/*! \fn size_t qHash(quint128 key, size_t seed = 0)
\relates QHash
\since 6.8
Returns the hash value for the \a key, using \a seed to seed the calculation.
\qhashbuiltin
\note This function is only available on platforms that support a native
128-bit integer type.
*/
/*! \fn size_t qHash(qint128 key, size_t seed = 0)
\relates QHash
\since 6.8
Returns the hash value for the \a key, using \a seed to seed the calculation.
\qhashbuiltin
\note This function is only available on platforms that support a native
128-bit integer type.
*/
/*! \fn size_t qHash(char8_t key, size_t seed = 0)
\relates QHash
\since 6.0
Returns the hash value for the \a key, using \a seed to seed the calculation.
\qhashbuiltin
*/
/*! \fn size_t qHash(char16_t key, size_t seed = 0)
\relates QHash
\since 6.0
Returns the hash value for the \a key, using \a seed to seed the calculation.
\qhashbuiltin
*/
/*! \fn size_t qHash(char32_t key, size_t seed = 0)
\relates QHash
\since 6.0
Returns the hash value for the \a key, using \a seed to seed the calculation.
\qhashbuiltin
*/
/*! \fn size_t qHash(wchar_t key, size_t seed = 0)
\relates QHash
\since 6.0
Returns the hash value for the \a key, using \a seed to seed the calculation.
\qhashbuiltin
*/
/*! \fn size_t qHash(float key, size_t seed = 0) noexcept
\relates QHash
\since 5.3
Returns the hash value for the \a key, using \a seed to seed the calculation.
\qhashbuiltin
*/
/*! \relates QHash
/*!
\since 5.3
Returns the hash value for the \a key, using \a seed to seed the calculation.
\qhashbuiltin
*/
size_t qHash(double key, size_t seed) noexcept
{
@ -1393,10 +1352,9 @@ size_t qHash(double key, size_t seed) noexcept
}
}
/*! \relates QHash
/*!
\since 5.3
Returns the hash value for the \a key, using \a seed to seed the calculation.
\qhashbuiltin
*/
size_t qHash(long double key, size_t seed) noexcept
{
@ -1412,66 +1370,43 @@ size_t qHash(long double key, size_t seed) noexcept
}
/*! \fn size_t qHash(const QChar key, size_t seed = 0)
\relates QHash
\since 5.0
Returns the hash value for the \a key, using \a seed to seed the calculation.
\qhashold{QHash}
*/
/*! \fn size_t qHash(const QByteArray &key, size_t seed = 0)
\relates QHash
\since 5.0
Returns the hash value for the \a key, using \a seed to seed the calculation.
\qhashold{QHash}
*/
/*! \fn size_t qHash(const QByteArrayView &key, size_t seed = 0)
\relates QHash
\since 6.0
Returns the hash value for the \a key, using \a seed to seed the calculation.
\qhashold{QHash}
*/
/*! \fn size_t qHash(const QBitArray &key, size_t seed = 0)
\relates QHash
\since 5.0
Returns the hash value for the \a key, using \a seed to seed the calculation.
\qhashold{QHash}
*/
/*! \fn size_t qHash(const QString &key, size_t seed = 0)
\relates QHash
\since 5.0
Returns the hash value for the \a key, using \a seed to seed the calculation.
*/
/*! \fn size_t qHash(QStringView key, size_t seed = 0)
\relates QStringView
\since 5.10
Returns the hash value for the \a key, using \a seed to seed the calculation.
\qhashold{QHash}
*/
/*! \fn size_t qHash(QLatin1StringView key, size_t seed = 0)
\relates QHash
\since 5.0
Returns the hash value for the \a key, using \a seed to seed the calculation.
\qhashold{QHash}
*/
/*! \fn template <class T> size_t qHash(const T *key, size_t seed = 0)
\relates QHash
\since 5.0
Returns the hash value for the \a key, using \a seed to seed the calculation.
\qhashbuiltin
*/
/*! \fn size_t qHash(std::nullptr_t key, size_t seed = 0)
\relates QHash
\since 6.0
Returns the hash value for the \a key, using \a seed to seed the calculation.
\qhashbuiltin
*/
/*! \fn template<typename T> bool qHashEquals(const T &a, const T &b)
@ -3867,21 +3802,13 @@ size_t qHash(long double key, size_t seed) noexcept
/*!
\fn template <class Key, class T> size_t qHash(const QHash<Key, T> &key, size_t seed = 0)
\since 5.8
\relates QHash
Returns the hash value for the \a key, using \a seed to seed the calculation.
Type \c T must be supported by qHash().
\qhasholdTS{QHash}{Key}{T}
*/
/*!
\fn template <class Key, class T> size_t qHash(const QMultiHash<Key, T> &key, size_t seed = 0)
\since 5.8
\relates QMultiHash
Returns the hash value for the \a key, using \a seed to seed the calculation.
Type \c T must be supported by qHash().
\qhasholdTS{QMultiHash}{Key}{T}
*/
/*! \fn template <typename Key, typename T, typename Predicate> qsizetype erase_if(QHash<Key, T> &hash, Predicate pred)

7
src/corelib/tools/qlist.qdoc
View File

@ -429,12 +429,7 @@
/*!
\fn template <typename T> size_t qHash(const QList<T> &key, size_t seed = 0)
\since 5.6
\relates QList
Returns the hash value for \a key,
using \a seed to seed the calculation.
This function requires qHash() to be overloaded for the value type \c T.
\qhasholdT{QList}{T}
*/
/*! \fn template <typename T> qsizetype QList<T>::size() const

5
src/corelib/tools/qmap.qdoc
View File

@ -1391,8 +1391,5 @@
/*!
\fn template <class Key, class T> size_t QMap<Key, T>::qHash(const QMap &key, size_t seed) noexcept
\since 6.8
Returns the hash value for \a key, using \a seed to seed the calculation.
Types \c Key and \c T must be supported by qHash().
\qhashTS{QMap}{Key}{T}
*/

6
src/corelib/tools/qpoint.cpp
View File

@ -450,12 +450,8 @@ QDebug operator<<(QDebug dbg, const QPointF &p)
#endif
/*!
\fn size_t qHash(QPoint key, size_t seed = 0)
\relates QHash
\qhashold{QHash}
\since 6.0
Returns the hash value for the \a key, using \a seed to seed the
calculation.
*/
size_t qHash(QPoint key, size_t seed) noexcept
{

4
src/corelib/tools/qset.qdoc
View File

@ -868,11 +868,9 @@
/*!
\fn template <class T> size_t qHash(const QSet<T> &key, size_t seed = 0)
\relates QHash
\qhasholdT{QHash}{T}
\since 5.5
Returns the hash value for the \a key, using \a seed to seed the calculation.
The hash value is independent of the order of elements in \a key, that is, sets
that contain the same elements hash to the same value.
*/

5
src/corelib/tools/qsharedpointer.cpp
View File

@ -974,10 +974,7 @@
/*!
\fn template <class T> qHash(const QSharedPointer<T> &key, size_t seed)
\relates QSharedPointer
Returns the hash value for \a key, using \a seed to seed the calculation.
\qhashold{QSharedPointer}
\since 5.0
*/

4
src/corelib/tools/qtaggedpointer.qdoc
View File

@ -187,7 +187,5 @@
/*!
\fn template <typename T, typename Tag> qHash(QTaggedPointer<T, Tag> key, std::size_t seed = 0)
\relates QTaggedPointer
Returns the hash value for the \a key, using \a seed to seed the calculation.
\qhashold{QTaggedPointer}
*/

5
src/corelib/tools/qtyperevision.cpp
View File

@ -203,11 +203,8 @@ QDebug operator<<(QDebug debug, const QTypeRevision &revision)
#endif
/*!
\relates QHash
\qhashold{QHash}
\since 6.0
Returns the hash value for the \a key, using \a seed to seed the
calculation.
*/
size_t qHash(const QTypeRevision &key, size_t seed)
{

5
src/corelib/tools/qvarlengtharray.qdoc
View File

@ -950,11 +950,8 @@
/*!
\fn template <typename T, qsizetype Prealloc> size_t qHash(const QVarLengthArray<T, Prealloc> &key, size_t seed = 0)
\relates QVarLengthArray
\qhasholdT{QVarLengthArray}{T}
\since 5.14
Returns the hash value for \a key, using \a seed to seed the
calculation.
*/
/*! \fn template <typename T, qsizetype Prealloc> template <typename AT = T> qsizetype QVarLengthArray<T, Prealloc>::removeAll(const AT &t)

5
src/corelib/tools/qversionnumber.cpp
View File

@ -571,11 +571,8 @@ QDebug operator<<(QDebug debug, const QVersionNumber &version)
#endif
/*!
\relates QHash
\qhashold{QHash}
\since 5.6
Returns the hash value for the \a key, using \a seed to seed the
calculation.
*/
size_t qHash(const QVersionNumber &key, size_t seed)
{

3
src/gui/image/qpixmapcache.cpp
View File

@ -220,8 +220,7 @@ QT_END_INCLUDE_NAMESPACE
/*!
\fn size_t QPixmapCache::Key::qHash(const Key &key, size_t seed)
\since 6.6
Returns the hash value for the \a key, using \a seed to seed the calculation.
\qhash{QPixmapCache::Key}
*/
size_t QPixmapCache::Key::hash(size_t seed) const noexcept
{

5
src/gui/kernel/qkeysequence.cpp
View File

@ -1410,10 +1410,7 @@ bool QKeySequence::operator==(const QKeySequence &other) const
/*!
\since 5.6
\relates QKeySequence
Calculates the hash value of \a key, using
\a seed to seed the calculation.
\qhashold{QKeySequence}
*/
size_t qHash(const QKeySequence &key, size_t seed) noexcept
{

4
src/gui/kernel/qpointingdevice.cpp
View File

@ -810,10 +810,8 @@ qint64 QPointingDeviceUniqueId::numericId() const noexcept
*/
/*!
\relates QPointingDeviceUniqueId
\qhashold{QPointingDeviceUniqueId}
\since 5.8
Returns the hash value for \a key, using \a seed to seed the calculation.
*/
size_t qHash(QPointingDeviceUniqueId key, size_t seed) noexcept
{

5
src/gui/painting/qtransform.cpp
View File

@ -784,10 +784,7 @@ bool QTransform::operator==(const QTransform &o) const
/*!
\since 5.6
\relates QTransform
Returns the hash value for \a key, using
\a seed to seed the calculation.
\qhashold{QTransform}
*/
size_t qHash(const QTransform &key, size_t seed) noexcept
{

40
src/gui/rhi/qrhi.cpp
View File

@ -1223,9 +1223,8 @@ QRhiDepthStencilClearValue::QRhiDepthStencilClearValue(float d, quint32 s)
*/
/*!
\fn size_t QRhiDepthStencilClearValue::qHash(const QRhiDepthStencilClearValue &v, size_t seed = 0) noexcept
\return the hash value for \a v, using \a seed to seed the calculation.
\fn size_t QRhiDepthStencilClearValue::qHash(const QRhiDepthStencilClearValue &key, size_t seed)
\qhash{QRhiDepthStencilClearValue}
*/
#ifndef QT_NO_DEBUG_STREAM
@ -1344,9 +1343,8 @@ QRhiViewport::QRhiViewport(float x, float y, float w, float h, float minDepth, f
*/
/*!
\fn size_t QRhiViewport::qHash(const QRhiViewport &v, size_t seed = 0) noexcept
\return the hash value for \a v, using \a seed to seed the calculation.
\fn size_t QRhiViewport::qHash(const QRhiViewport &key, size_t seed)
\qhash{QRhiViewport}
*/
#ifndef QT_NO_DEBUG_STREAM
@ -1438,9 +1436,8 @@ QRhiScissor::QRhiScissor(int x, int y, int w, int h)
*/
/*!
\fn size_t QRhiScissor::qHash(const QRhiScissor &v, size_t seed = 0) noexcept
\return the hash value for \a v, using \a seed to seed the calculation.
\fn size_t QRhiScissor::qHash(const QRhiScissor &key, size_t seed)
\qhash{QRhiScissor}
*/
#ifndef QT_NO_DEBUG_STREAM
@ -1591,9 +1588,8 @@ QRhiVertexInputBinding::QRhiVertexInputBinding(quint32 stride, Classification cl
*/
/*!
\fn size_t QRhiVertexInputBinding::qHash(const QRhiVertexInputBinding &v, size_t seed = 0) noexcept
\return the hash value for \a v, using \a seed to seed the calculation.
\fn size_t QRhiVertexInputBinding::qHash(const QRhiVertexInputBinding &key, size_t seed)
\qhash{QRhiVertexInputBinding}
*/
#ifndef QT_NO_DEBUG_STREAM
@ -1830,9 +1826,8 @@ QRhiVertexInputAttribute::QRhiVertexInputAttribute(int binding, int location, Fo
*/
/*!
\fn size_t QRhiVertexInputAttribute::qHash(const QRhiVertexInputAttribute &v, size_t seed = 0) noexcept
\return the hash value for \a v, using \a seed to seed the calculation.
\fn size_t QRhiVertexInputAttribute::qHash(const QRhiVertexInputAttribute &key, size_t seed)
\qhash{QRhiVertexInputAttribute}
*/
#ifndef QT_NO_DEBUG_STREAM
@ -2074,9 +2069,8 @@ quint32 QRhiImplementation::byteSizePerVertexForVertexInputFormat(QRhiVertexInpu
*/
/*!
\fn size_t QRhiVertexInputLayout::qHash(const QRhiVertexInputLayout &v, size_t seed = 0) noexcept
\return the hash value for \a v, using \a seed to seed the calculation.
\fn size_t QRhiVertexInputLayout::qHash(const QRhiVertexInputLayout &key, size_t seed)
\qhash{QRhiVertexInputLayout}
*/
#ifndef QT_NO_DEBUG_STREAM
@ -2220,9 +2214,8 @@ QRhiShaderStage::QRhiShaderStage(Type type, const QShader &shader, QShader::Vari
*/
/*!
\fn size_t QRhiShaderStage::qHash(const QRhiShaderStage &v, size_t seed = 0) noexcept
\return the hash value for \a v, using \a seed to seed the calculation.
\fn size_t QRhiShaderStage::qHash(const QRhiShaderStage &key, size_t seed)
\qhash{QRhiShaderStage}
*/
#ifndef QT_NO_DEBUG_STREAM
@ -6274,9 +6267,8 @@ bool operator!=(const QRhiShaderResourceBinding &a, const QRhiShaderResourceBind
}
/*!
\return the hash value for \a b, using \a seed to seed the calculation.
\relates QRhiShaderResourceBinding
\fn size_t qHash(const QRhiShaderResourceBinding &key, size_t seed)
\qhashold{QRhiShaderResourceBinding}
*/
size_t qHash(const QRhiShaderResourceBinding &b, size_t seed) noexcept
{

15
src/gui/rhi/qshader.cpp
View File

@ -794,9 +794,8 @@ bool operator==(const QShader &lhs, const QShader &rhs) noexcept
*/
/*!
Returns the hash value for \a s, using \a seed to seed the calculation.
\relates QShader
\fn size_t qHash(const QShader &key, size_t seed)
\qhashold{QShader}
*/
size_t qHash(const QShader &s, size_t seed) noexcept
{
@ -901,9 +900,8 @@ bool operator<(const QShaderKey &lhs, const QShaderKey &rhs) noexcept
*/
/*!
Returns the hash value for \a k, using \a seed to seed the calculation.
\relates QShaderKey
\fn size_t qHash(const QShaderKey &key, size_t seed)
\qhashold{QShaderKey}
*/
size_t qHash(const QShaderKey &k, size_t seed) noexcept
{
@ -934,9 +932,8 @@ bool operator==(const QShaderCode &lhs, const QShaderCode &rhs) noexcept
*/
/*!
Returns the hash value for \a k, using \a seed to seed the calculation.
\relates QShaderCode
\fn size_t qHash(const QShaderCode &key, size_t seed)
\qhashold{QShaderCode}
*/
size_t qHash(const QShaderCode &k, size_t seed) noexcept
{

9
src/gui/text/qfont.cpp
View File

@ -2183,10 +2183,8 @@ QString QFont::toString() const
}
/*!
Returns the hash value for \a font. If specified, \a seed is used
to initialize the hash.
\relates QFont
\fn size_t qHash(const QFont &key, size_t seed)
\qhashold{QFont}
\since 5.3
*/
size_t qHash(const QFont &font, size_t seed) noexcept
@ -2342,8 +2340,7 @@ void QFont::cacheStatistics()
/*!
\fn size_t QFont::Tag::qHash(QFont::Tag key, size_t seed) noexcept
Returns the hash value for \a key, using \a seed to seed the calculation.
\qhash{QFont::Tag}
*/
/*!

6
src/gui/text/qrawfont.cpp
View File

@ -279,10 +279,8 @@ bool QRawFont::operator==(const QRawFont &other) const
}
/*!
Returns the hash value for \a font. If specified, \a seed is used
to initialize the hash.
\relates QRawFont
\fn size_t qHash(const QRawFont &key, size_t seed)
\qhashold{QRawFont}
\since 5.8
*/
size_t qHash(const QRawFont &font, size_t seed) noexcept

10
src/gui/vulkan/qvulkaninstance.cpp
View File

@ -301,10 +301,7 @@ QVulkanInstance::~QVulkanInstance()
/*!
\fn size_t qHash(const QVulkanLayer &key, size_t seed = 0)
\since 5.10
\relates QVulkanLayer
Returns the hash value for the \a key, using \a seed to seed the
calculation.
\qhashold{QVulkanLayer}
*/
/*!
@ -345,10 +342,7 @@ QVulkanInstance::~QVulkanInstance()
/*!
\fn size_t qHash(const QVulkanExtension &key, size_t seed = 0)
\since 5.10
\relates QVulkanExtension
Returns the hash value for the \a key, using \a seed to seed the
calculation.
\qhashold{QVulkanExtension}
*/
/*!

3
src/network/access/qhttp1configuration.cpp
View File

@ -129,8 +129,7 @@ qsizetype QHttp1Configuration::numberOfConnectionsPerHost() const
/*!
\fn size_t QHttp1Configuration::qHash(const QHttp1Configuration &key, size_t seed)
\since 6.5
Returns the hash value for the \a key, using \a seed to seed the calculation.
\qhash{QHttp1Configuration}
*/
/*!

3
src/network/kernel/qhostaddress.cpp
View File

@ -1257,8 +1257,7 @@ QDebug operator<<(QDebug d, const QHostAddress &address)
/*!
\since 5.0
\relates QHostAddress
Returns a hash of the host address \a key, using \a seed to seed the calculation.
\qhashold{QHostAddress}
*/
size_t qHash(const QHostAddress &key, size_t seed) noexcept
{

5
src/network/ssl/qocspresponse.cpp
View File

@ -200,10 +200,9 @@ bool QOcspResponse::isEqual(const QOcspResponse &other) const
}
/*!
Returns the hash value for the \a response, using \a seed to seed the calculation.
\fn size_t qHash(const QOcspResponse &key, size_t seed)
\since 5.13
\relates QHash
\qhashold{QHash}
*/
size_t qHash(const QOcspResponse &response, size_t seed) noexcept
{

3
src/network/ssl/qsslcertificate.cpp
View File

@ -971,9 +971,8 @@ QString QSslCertificate::subjectDisplayName() const
}
/*!
Returns the hash value for the \a key, using \a seed to seed the calculation.
\since 5.4
\relates QHash
\qhashold{QHash}
*/
size_t qHash(const QSslCertificate &key, size_t seed) noexcept
{

6
src/network/ssl/qssldiffiehellmanparameters.cpp
View File

@ -305,11 +305,9 @@ QDebug operator<<(QDebug debug, const QSslDiffieHellmanParameters &dhparam)
#endif
/*!
\fn size_t qHash(const QSslDiffieHellmanParameters &key, size_t seed)
\since 5.8
\relates QSslDiffieHellmanParameters
Returns an hash value for \a dhparam, using \a seed to seed
the calculation.
\qhashold{QSslDiffieHellmanParameters}
*/
size_t qHash(const QSslDiffieHellmanParameters &dhparam, size_t seed) noexcept
{

7
src/network/ssl/qsslellipticcurve.cpp
View File

@ -160,12 +160,9 @@ bool QSslEllipticCurve::isTlsNamedCurve() const noexcept
*/
/*!
\fn size_t qHash(QSslEllipticCurve curve, size_t seed = 0)
\fn size_t qHash(QSslEllipticCurve key, size_t seed)
\since 5.5
\relates QHash
Returns an hash value for the curve \a curve, using \a seed to seed
the calculation.
\qhashold{QHash}
*/
#ifndef QT_NO_DEBUG_STREAM

3
src/network/ssl/qsslerror.cpp
View File

@ -327,9 +327,8 @@ QSslCertificate QSslError::certificate() const
}
/*!
Returns the hash value for the \a key, using \a seed to seed the calculation.
\since 5.4
\relates QHash
\qhashold{QHash}
*/
size_t qHash(const QSslError &key, size_t seed) noexcept
{

4
src/widgets/kernel/qsizepolicy.cpp
View File

@ -283,9 +283,7 @@ void QSizePolicy::setControlType(ControlType type) noexcept
/*!
\fn size_t QSizePolicy::qHash(QSizePolicy key, size_t seed = 0)
\since 5.6
Returns the hash value for \a key, using
\a seed to seed the calculation.
\qhash{QSizePolicy}
*/
/*!