QHashSeed Struct
| Encabezado: | #include <QHashSeed> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Core) target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake: | QT += core |
| Desde: | Qt 6.2 |
Funciones públicas
| QHashSeed(size_t data = 0) | |
| operator size_t() const |
Miembros públicos estáticos
| QHashSeed | globalSeed() |
| void | resetRandomGlobalSeed() |
| void | setDeterministicGlobalSeed() |
Descripción detallada
La clase QHashSeed se utiliza para transmitir la semilla de QHash. La utiliza internamente QHash y proporciona tres funciones de miembro estáticas que permiten a los usuarios obtener el hash y restablecerlo.
QHash Las funciones qHash() implementan lo que se conoce como «hash salado». El objetivo es que diferentes aplicaciones y diferentes instancias de la misma aplicación generen valores de hash distintos para la misma entrada, lo que hace que el orden de los elementos en QHash sea impredecible para los observadores externos. Esto mejora la resistencia de las aplicaciones frente a ataques que intentan forzar a las tablas de hash a entrar en modo degenerado.
La mayoría de las aplicaciones no tendrán que gestionar directamente la semilla de hash, ya que QHash se encargará de ello cuando sea necesario. No obstante, es posible que las aplicaciones deseen utilizarla para sus propios fines, del mismo modo que lo hace QHash: como un valor aleatorio global de la aplicación (pero véase también QRandomGenerator ). Tenga en cuenta que la semilla de hash global puede cambiar durante el ciclo de vida de la aplicación, si se llama a la función resetRandomGlobalSeed(). Los usuarios del hash global deben almacenar el valor que estén utilizando y no dar por sentado que lo volverán a obtener.
Esta clase también implementa una funcionalidad para establecer la semilla de hash en un valor determinista, lo que las funciones qHash() interpretarán como que deben utilizar también una función de hash fija para sus datos. Esta funcionalidad está pensada únicamente para su uso en la depuración de aplicaciones. Este comportamiento también se puede controlar estableciendo la variable de entorno QT_HASH_SEED en el valor cero (se ignora cualquier otro valor).
Véase también QHash y QRandomGenerator.
Documentación de las funciones miembro
[constexpr] QHashSeed::QHashSeed(size_t data = 0)
Crea un nuevo objeto `QHashSeed` utilizando ` data ` como semilla.
[static noexcept] QHashSeed QHashSeed::globalSeed()
Devuelve la semilla global actual de QHash. El valor devuelto por esta función será cero si se ha llamado a setDeterministicGlobalSeed() o si la variable de entorno QT_HASH_SEED está establecida en cero.
Nota: Esta función es segura para subprocesos.
[static] void QHashSeed::resetRandomGlobalSeed()
Reinicia la semilla de hash de Qt con un nuevo valor aleatorio. No es necesario llamar a esta función, pero puede ser conveniente hacerlo en aplicaciones de larga duración tras un periodo prolongado en el que la información sobre su hash haya podido quedar expuesta a posibles atacantes.
Si la variable de entorno QT_HASH_SEED está establecida en cero, llamar a esta función no tendrá ningún efecto.
Qt nunca llama a esta función durante la ejecución de la aplicación, pero, a menos que la variable QT_HASH_SEED esté establecida en 0, la semilla de hash devuelta por globalSeed() será un valor aleatorio, como si se hubiera llamado a esta función.
Nota: Esta función es segura para subprocesos.
[static] void QHashSeed::setDeterministicGlobalSeed()
Establece la semilla del hash de Qt en un valor determinista (cero) y solicita a las funciones qHash() que utilicen una función de hash predeterminada. Este modo solo resulta útil para la depuración y no debe utilizarse en código de producción.
El funcionamiento normal se puede restablecer llamando a resetRandomGlobalSeed().
Nota: Esta función es segura para subprocesos.
[constexpr noexcept] QHashSeed::operator size_t() const
Convierte la semilla del hash devuelta en un ` size_t`.
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.