QMessageAuthenticationCode Class

メンバ関数のドキュメント

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

method メソッドとキーkey を使用して、データから暗号ハッシュを生成するために使用できるオブジェクトを構築します。

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

other から新しい QMessageAuthenticationCode をムーブコンストラクタで生成します。

この関数は Qt 6.6 で導入されました。

[noexcept] QMessageAuthenticationCode::~QMessageAuthenticationCode()

オブジェクトを破棄します。

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

メッセージに「data 」を追加します。

resultView() およびresult()も参照してください 。

bool QMessageAuthenticationCode::addData(QIODevice *device)

開いているQIODevice device からデータが終了するまで読み込み、それをmessageに追加します。読み込みが成功した場合はtrue を返します。

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

data の先頭からlength 文字分をメッセージに追加します。

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

キー `key ` およびメソッド `method` を使用して、メッセージ `message ` の認証コードを返します。

hashInto()も参照してください 。

キーkey およびメソッドmethod を使用して、メッセージの認証コード（message 、またはQSpan のオーバーロードの場合はmessageParts の連結）を返します。

戻り値はbuffer のサブスパンとなります。ただし、buffer のサイズが不十分な場合は、nullQByteArrayView が返されます。

これらの関数は Qt 6.8 で導入されました。

hash()も参照してください 。

[noexcept] void QMessageAuthenticationCode::reset()

メッセージデータをリセットします。この関数を呼び出しても、キーには影響しません。

QByteArray QMessageAuthenticationCode::result() const

最終的な認証コードを返します。

resultView() およびQByteArray::toHex()も参照してください 。

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

最終的なハッシュ値を返します。

なお、返されたビューは、QMessageAuthenticationCode オブジェクトが他の手段によって変更されない限り、有効であることに注意してください。

この関数は Qt 6.6 で導入されました。

result()も参照してください 。

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

key のシークレットを設定します。この関数を呼び出すと、オブジェクトの状態が自動的にリセットされます。

パフォーマンスを最適化するには、この関数はアクティブなキーを変更する場合にのみ呼び出し、次のように初期キーを設定するために使用しないでください。

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

初期キーは、コンストラクタの引数として渡すことを推奨します：

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

キーが判明するまでQMessageAuthenticationCode の生成を遅延させるには、std::optionalを使用できます:

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

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

このメッセージ認証コードをother と交換します。この処理は非常に高速で、失敗することはありません。

この関数は Qt 6.6 で導入されました。

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

other をこのQMessageAuthenticationCode インスタンスに割り当てます。

この関数は Qt 6.6 で導入されました。