QMessageAuthenticationCode Class

Documentation sur les fonctions membres

[explicit] QMessageAuthenticationCode::QMessageAuthenticationCode(QCryptographicHash::Algorithm method, QByteArrayView key = {})

Construit un objet qui peut être utilisé pour créer un hachage cryptographique à partir de données en utilisant la méthode method et la clé key.

[noexcept, since 6.6] QMessageAuthenticationCode::QMessageAuthenticationCode(QMessageAuthenticationCode &&other)

Move-construit un nouveau QMessageAuthenticationCode à partir de other.

Cette fonction a été introduite dans Qt 6.6.

[noexcept] QMessageAuthenticationCode::~QMessageAuthenticationCode()

Détruit l'objet.

[noexcept] void QMessageAuthenticationCode::addData(QByteArrayView data)

Ajoute data au message.

Voir aussi resultView() et result().

bool QMessageAuthenticationCode::addData(QIODevice *device)

Lit les données de la page ouverte QIODevice device jusqu'à ce qu'elle se termine et les ajoute au message. Retourne true si la lecture a réussi.

void QMessageAuthenticationCode::addData(const char *data, qsizetype length)

length Ajoute les premiers caractères de data au message.

[static] QByteArray QMessageAuthenticationCode::hash(QByteArrayView message, QByteArrayView key, QCryptographicHash::Algorithm method)

Renvoie le code d'authentification du message message en utilisant la clé key et la méthode method.

Voir aussi hashInto().

Renvoie le code d'authentification du message (message ou, pour les surcharges QSpan, la concaténation de messageParts) en utilisant la clé key et la méthode method.

La valeur de retour sera un sous-espace de buffer, à moins que buffer ne soit pas de taille suffisante, auquel cas QByteArrayView sera renvoyé à l'état nul.

Ces fonctions ont été introduites dans Qt 6.8.

Voir aussi hash().

[noexcept] void QMessageAuthenticationCode::reset()

Réinitialise les données du message. L'appel à cette fonction n'affecte pas la clé.

QByteArray QMessageAuthenticationCode::result() const

Renvoie le code d'authentification final.

Voir aussi resultView() et QByteArray::toHex().

[noexcept, since 6.6] QByteArrayView QMessageAuthenticationCode::resultView() const

Renvoie la valeur de hachage finale.

Notez que la vue renvoyée reste valide tant que l'objet QMessageAuthenticationCode n'est pas modifié par d'autres moyens.

Cette fonction a été introduite dans Qt 6.6.

Voir aussi result().

[noexcept] void QMessageAuthenticationCode::setKey(QByteArrayView key)

Définit le secret key. L'appel de cette fonction réinitialise automatiquement l'état de l'objet.

Pour des performances optimales, n'appelez cette fonction que pour modifier la clé active, et non pour définir une clé initiale, comme dans l'exemple suivant

QMessageAuthenticationCode mac(method);
mac.setKey(key); // does extra work
use(mac);

Il est préférable de transmettre les clés initiales en tant qu'argument du constructeur :

QMessageAuthenticationCode mac(method, key); // OK, optimal
use(mac);

Vous pouvez utiliser std::optional pour retarder la construction d'un QMessageAuthenticationCode jusqu'à ce que vous connaissiez la clé :

std::optional<QMessageAuthenticationCode> mac;
~~~
key = ~~~;
mac.emplace(method, key);
use(*mac);

[noexcept, since 6.6] void QMessageAuthenticationCode::swap(QMessageAuthenticationCode &other)

Remplace ce code d'authentification des messages par other. Cette opération est très rapide et n'échoue jamais.

Cette fonction a été introduite dans Qt 6.6.

[noexcept, since 6.6] QMessageAuthenticationCode &QMessageAuthenticationCode::operator=(QMessageAuthenticationCode &&other)

Move-assigne other à cette instance QMessageAuthenticationCode.

Cette fonction a été introduite dans Qt 6.6.