QCryptographicHash Class
La clase QCryptographicHash permite generar hash criptográficos. Más información ...
| Encabezado: | #include <QCryptographicHash> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Core) target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake: | QT += core |
Nota: Todas las funciones de esta clase son reentrantes.
Tipos públicos
| enum | Algorithm { Md4, Md5, Sha1, Sha224, Sha256, …, Blake2s_256 } |
Funciones públicas
| QCryptographicHash(QCryptographicHash::Algorithm method) | |
(since 6.5) | QCryptographicHash(QCryptographicHash &&other) |
| ~QCryptographicHash() | |
| void | addData(QByteArrayView bytes) |
| bool | addData(QIODevice *device) |
(since 6.5) QCryptographicHash::Algorithm | algorithm() const |
| void | reset() |
| QByteArray | result() const |
(since 6.3) QByteArrayView | resultView() const |
(since 6.5) void | swap(QCryptographicHash &other) |
(since 6.5) QCryptographicHash & | operator=(QCryptographicHash &&other) |
Miembros públicos estáticos
| QByteArray | hash(QByteArrayView data, QCryptographicHash::Algorithm method) |
(since 6.8) QByteArrayView | hashInto(QSpan<char> buffer, QByteArrayView data, QCryptographicHash::Algorithm method) |
(since 6.8) QByteArrayView | hashInto(QSpan<char> buffer, QSpan<const QByteArrayView> data, QCryptographicHash::Algorithm method) |
(since 6.8) QByteArrayView | hashInto(QSpan<std::byte> buffer, QByteArrayView data, QCryptographicHash::Algorithm method) |
(since 6.8) QByteArrayView | hashInto(QSpan<std::byte> buffer, QSpan<const QByteArrayView> data, QCryptographicHash::Algorithm method) |
(since 6.8) QByteArrayView | hashInto(QSpan<uchar> buffer, QByteArrayView data, QCryptographicHash::Algorithm method) |
(since 6.8) QByteArrayView | hashInto(QSpan<uchar> buffer, QSpan<const QByteArrayView> data, QCryptographicHash::Algorithm method) |
| int | hashLength(QCryptographicHash::Algorithm method) |
(since 6.5) bool | supportsAlgorithm(QCryptographicHash::Algorithm method) |
Descripción detallada
QCryptographicHash se puede utilizar para generar hash criptográficos de datos binarios o de texto.
Consulte la documentación de la enumeración « QCryptographicHash::Algorithm » para obtener una lista de los algoritmos compatibles.
Documentación sobre los tipos de los miembros
enum QCryptographicHash::Algorithm
Nota: En las versiones de Qt anteriores a la 5.9, cuando se solicitaba generar una suma de comprobación SHA-3, ` QCryptographicHash ` calculaba en realidad Keccak. Si necesitas compatibilidad con las sumas de comprobación SHA-3 generadas por esas versiones de Qt, utiliza los enumeradores ` Keccak_ `. Como alternativa, si se requiere compatibilidad con el código fuente, define la macro ` QT_SHA3_KECCAK_COMPAT`.
| Constante | Valor | Descripción |
|---|---|---|
QCryptographicHash::Md4 | 0 | Genera una suma de hash MD4 |
QCryptographicHash::Md5 | 1 | Genera una suma de hash MD5 |
QCryptographicHash::Sha1 | 2 | Generar una suma hash SHA-1 |
QCryptographicHash::Sha224 | 3 | Generar una suma hash SHA-224 (SHA-2). Introducido en Qt 5.0 |
QCryptographicHash::Sha256 | 4 | Generar una suma hash SHA-256 (SHA-2). Introducido en Qt 5.0 |
QCryptographicHash::Sha384 | 5 | Generar una suma hash SHA-384 (SHA-2). Introducido en Qt 5.0 |
QCryptographicHash::Sha512 | 6 | Generar una suma hash SHA-512 (SHA-2). Introducido en Qt 5.0 |
QCryptographicHash::Sha3_224 | RealSha3_224 | Genera una suma hash SHA3-224. Introducido en Qt 5.1 |
QCryptographicHash::Sha3_256 | RealSha3_256 | Genera una suma hash SHA3-256. Introducido en Qt 5.1 |
QCryptographicHash::Sha3_384 | RealSha3_384 | Genera una suma hash SHA3-384. Introducido en Qt 5.1 |
QCryptographicHash::Sha3_512 | RealSha3_512 | Genera una suma hash SHA3-512. Introducido en Qt 5.1 |
QCryptographicHash::Keccak_224 | 7 | Genera una suma hash Keccak-224. Introducido en Qt 5.9.2 |
QCryptographicHash::Keccak_256 | 8 | Genera una suma hash Keccak-256. Introducido en Qt 5.9.2 |
QCryptographicHash::Keccak_384 | 9 | Genera una suma hash Keccak-384. Introducido en Qt 5.9.2 |
QCryptographicHash::Keccak_512 | 10 | Genera una suma hash Keccak-512. Introducido en Qt 5.9.2 |
QCryptographicHash::Blake2b_160 | 15 | Genera una suma hash BLAKE2b-160. Introducida en Qt 6.0 |
QCryptographicHash::Blake2b_256 | 16 | Genera una suma hash BLAKE2b-256. Introducido en Qt 6.0 |
QCryptographicHash::Blake2b_384 | 17 | Genera una suma hash BLAKE2b-384. Introducido en Qt 6.0 |
QCryptographicHash::Blake2b_512 | 18 | Genera una suma hash BLAKE2b-512. Introducido en Qt 6.0 |
QCryptographicHash::Blake2s_128 | 19 | Genera una suma hash BLAKE2s-128. Introducido en Qt 6.0 |
QCryptographicHash::Blake2s_160 | 20 | Genera una suma hash BLAKE2s-160. Introducida en Qt 6.0 |
QCryptographicHash::Blake2s_224 | 21 | Genera una suma hash BLAKE2s-224. Introducida en Qt 6.0 |
QCryptographicHash::Blake2s_256 | 22 | Genera una suma hash BLAKE2s-256. Introducido en Qt 6.0 |
Documentación de las funciones miembro
[explicit] QCryptographicHash::QCryptographicHash(QCryptographicHash::Algorithm method)
Crea un objeto que se puede utilizar para generar un hash criptográfico a partir de datos mediante method.
[noexcept, since 6.5] QCryptographicHash::QCryptographicHash(QCryptographicHash &&other)
Crea un nuevo objeto `QCryptographicHash` a partir de ` other`.
Nota: El objeto del que se ha realizado la migración, ` other `, queda en un estado parcialmente formado, en el que las únicas operaciones válidas son la destrucción y la asignación de un nuevo valor.
Esta función se introdujo en Qt 6.5.
[noexcept] QCryptographicHash::~QCryptographicHash()
Destruye el objeto.
[noexcept] void QCryptographicHash::addData(QByteArrayView bytes)
Añade los caracteres de bytes al hash criptográfico.
Nota: En las versiones de Qt anteriores a la 6.3, esta función aceptaba QByteArray, y no QByteArrayView.
bool QCryptographicHash::addData(QIODevice *device)
Lee los datos del archivo abierto QIODevice device hasta el final y calcula su hash. Devuelve true si la lectura se ha realizado correctamente.
[noexcept, since 6.5] QCryptographicHash::Algorithm QCryptographicHash::algorithm() const
Devuelve el algoritmo utilizado para generar el hash criptográfico.
Esta función se introdujo en Qt 6.5.
[static] QByteArray QCryptographicHash::hash(QByteArrayView data, QCryptographicHash::Algorithm method)
Devuelve el hash de data utilizando method.
Nota: En las versiones de Qt anteriores a la 6.3, esta función aceptaba QByteArray, no QByteArrayView.
Véase también hashInto().
[static noexcept, since 6.8] QByteArrayView QCryptographicHash::hashInto(QSpan<char> buffer, QByteArrayView data, QCryptographicHash::Algorithm method)
[static noexcept, since 6.8] QByteArrayView QCryptographicHash::hashInto(QSpan<char> buffer, QSpan<const QByteArrayView> data, QCryptographicHash::Algorithm method)
[static noexcept, since 6.8] QByteArrayView QCryptographicHash::hashInto(QSpan<std::byte> buffer, QByteArrayView data, QCryptographicHash::Algorithm method)
[static noexcept, since 6.8] QByteArrayView QCryptographicHash::hashInto(QSpan<std::byte> buffer, QSpan<const QByteArrayView> data, QCryptographicHash::Algorithm method)
[static noexcept, since 6.8] QByteArrayView QCryptographicHash::hashInto(QSpan<uchar> buffer, QByteArrayView data, QCryptographicHash::Algorithm method)
[static noexcept, since 6.8] QByteArrayView QCryptographicHash::hashInto(QSpan<uchar> buffer, QSpan<const QByteArrayView> data, QCryptographicHash::Algorithm method)
Devuelve el hash de ` data ` utilizando ` method`, y almacena el resultado en ` buffer `.
Si data es un span, añade todas las vistas de la matriz de bytes al hash, en el orden indicado.
El valor devuelto será un subspan de buffer, a menos que buffer tenga un tamaño insuficiente, en cuyo caso se devuelve un QByteArrayView nulo.
Estas funciones se introdujeron en Qt 6.8.
Véase también ` hash()`.
[static] int QCryptographicHash::hashLength(QCryptographicHash::Algorithm method)
Devuelve el tamaño, en bytes, del resultado del hash seleccionado method.
[noexcept] void QCryptographicHash::reset()
Restablece el objeto.
QByteArray QCryptographicHash::result() const
Devuelve el valor hash final.
Véase también resultView() y QByteArray::toHex().
[noexcept, since 6.3] QByteArrayView QCryptographicHash::resultView() const
Devuelve el valor hash final.
Ten en cuenta que la vista devuelta solo sigue siendo válida mientras el objeto ` QCryptographicHash ` no se modifique por otros medios.
Esta función se introdujo en Qt 6.3.
Véase también result().
[static, since 6.5] bool QCryptographicHash::supportsAlgorithm(QCryptographicHash::Algorithm method)
Devuelve si el algoritmo seleccionado method es compatible y si result() devolverá un valor cuando se utilice method.
Nota: OpenSSL se encargará de proporcionar esta información cuando se utilice como proveedor; de lo contrario, se devolverá true, ya que la implementación que no es de OpenSSL no tiene ninguna restricción. Devolvemos false si no conseguimos consultar a OpenSSL.
Esta función se introdujo en Qt 6.5.
[noexcept, since 6.5] void QCryptographicHash::swap(QCryptographicHash &other)
Intercambia este hash criptográfico con other. Esta operación es muy rápida y nunca falla.
Esta función se introdujo en Qt 6.5.
[noexcept, since 6.5] QCryptographicHash &QCryptographicHash::operator=(QCryptographicHash &&other)
La operación «move-assigns» asigna other a esta instancia de QCryptographicHash.
Nota: El objeto del que se realiza el traslado, other, pasa a un estado parcialmente formado, en el que las únicas operaciones válidas son la destrucción y la asignación de un nuevo valor.
Esta función se introdujo en Qt 6.5.
© 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.