QMessageAuthenticationCode Class

Documentation sur les fonctions membres

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

Construit un objet permettant de générer un hachage cryptographique à partir de données à l'aide de la méthode method et de la clé key.

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

La fonction `move` construit un nouvel objet `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 également resultView() et result().

bool QMessageAuthenticationCode::addData(QIODevice *device)

Lit les données du fichier ouvert QIODevice device jusqu'à la fin et les ajoute à message. Renvoie true si la lecture s'est déroulée correctement.

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

Ajoute les length 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 à l'aide de la clé key et de la méthode method.

Voir également hashInto().

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

La valeur renvoyée sera un sous-span de ` buffer`, sauf si ` buffer ` n’est pas suffisamment grand, auquel cas un ` QByteArrayView ` nul est renvoyé.

Ces fonctions ont été introduites dans Qt 6.8.

Voir également hash().

[noexcept] void QMessageAuthenticationCode::reset()

Réinitialise les données des messages. L'appel de cette fonction n'a aucune incidence sur la clé.

QByteArray QMessageAuthenticationCode::result() const

Renvoie le code d'authentification final.

Voir également resultView() et QByteArray::toHex().

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

Renvoie la valeur de hachage finale.

Notez que la vue renvoyée ne reste valide que 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 l'key e secrète. 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

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

Préférez passer les clés initiales en tant qu’argument du constructeur :

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

Vous pouvez utiliser std::optional pour différer 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)

Permet de remplacer ce code d'authentification de message par other. Cette opération est très rapide et ne rencontre jamais d'échec.

Cette fonction a été introduite dans Qt 6.6.

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

Cette opération attribue l'other à cette instance de QMessageAuthenticationCode.

Cette fonction a été introduite dans Qt 6.6.