QMessageAuthenticationCode Class

Dokumentation zu den Member-Funktionen

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

Erstellt ein Objekt, mit dem sich anhand der Methode „ method “ und des Schlüssels „ key “ ein kryptografischer Hash aus Daten generieren lässt.

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

Erstellt mittels „Move“ ein neues `QMessageAuthenticationCode`-Objekt aus ` other`.

Diese Funktion wurde in Qt 6.6 eingeführt.

[noexcept] QMessageAuthenticationCode::~QMessageAuthenticationCode()

Löscht das Objekt.

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

Fügt „ data “ zur Nachricht hinzu.

Siehe auch resultView() und result().

bool QMessageAuthenticationCode::addData(QIODevice *device)

Liest die Daten aus der geöffneten Datei „ QIODevice “ ( device ), bis das Ende erreicht ist, und fügt sie der Nachricht hinzu. Gibt „ true “ zurück, wenn das Einlesen erfolgreich war.

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

Fügt die ersten length Zeichen von data zur Nachricht hinzu.

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

Gibt den Authentifizierungscode für die Nachricht message unter Verwendung des Schlüssels key und der Methode method zurück.

Siehe auch ` hashInto()`.

Gibt den Authentifizierungscode für die Nachricht zurück (message oder, bei den Überladungen von QSpan, die Verkettung von messageParts) unter Verwendung des Schlüssels key und der Methode method.

Der Rückgabewert ist ein Teilbereich von ` buffer`, es sei denn, ` buffer ` ist nicht groß genug; in diesem Fall wird ein `null`-Wert für ` QByteArrayView ` zurückgegeben.

Diese Funktionen wurden in Qt 6.8 eingeführt.

Siehe auch ` hash()`.

[noexcept] void QMessageAuthenticationCode::reset()

Setzt die Nachrichtendaten zurück. Der Aufruf dieser Funktion hat keine Auswirkungen auf den Schlüssel.

QByteArray QMessageAuthenticationCode::result() const

Gibt den endgültigen Authentifizierungscode zurück.

Siehe auch resultView() und QByteArray::toHex().

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

Gibt den endgültigen Hash-Wert zurück.

Beachten Sie, dass die zurückgegebene Ansicht nur so lange gültig bleibt, wie das Objekt „ QMessageAuthenticationCode “ nicht auf andere Weise verändert wird.

Diese Funktion wurde in Qt 6.6 eingeführt.

Siehe auch ` result()`.

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

Legt den geheimen Schlüssel „ key “ fest. Der Aufruf dieser Funktion setzt den Objektzustand automatisch zurück.

Um eine optimale Leistung zu erzielen, rufen Sie diese Funktion nur auf, um den aktiven Schlüssel zu ändern, nicht jedoch, um einen Anfangsschlüssel festzulegen, wie in

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

Übergeben Sie Anfangsschlüssel vorzugsweise als Konstruktorargument:

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

Sie können `std::optional` verwenden, um die Erstellung eines ` QMessageAuthenticationCode ` zu verzögern, bis Sie den Schlüssel kennen:

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

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

Ersetzt diesen Nachrichtenauthentifizierungscode durch other. Dieser Vorgang ist sehr schnell und schlägt niemals fehl.

Diese Funktion wurde in Qt 6.6 eingeführt.

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

Weist „ other “ dieser „ QMessageAuthenticationCode “-Instanz zu.

Diese Funktion wurde in Qt 6.6 eingeführt.