Back to Qt.io
Contact Us Blog Download Qt

QCryptographicHash Class

QCryptographicHash クラスは、暗号ハッシュを生成する方法を提供する。詳細...

Header: #include <QCryptographicHash>
CMake: find_package(Qt6 REQUIRED COMPONENTS Core)
target_link_libraries(mytarget PRIVATE Qt6::Core)
qmake: QT += core

注意:このクラスの関数はすべてリエントラントです。

パブリック型

enum Algorithm { Md4, Md5, Sha1, Sha224, Sha256, …, Blake2s_256 }

パブリック関数

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)

静的パブリックメンバ

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)

詳しい説明

QCryptographicHash は、バイナリまたはテキストデータの暗号ハッシュを生成するために使用できます。

サポートされているアルゴリズムの一覧については、QCryptographicHash::Algorithm enum のドキュメントを参照してください。

メンバ型のドキュメント

enum QCryptographicHash::Algorithm

注意: Qt 5.9 より前のバージョンでは、SHA3 ハッシュの合計を生成するように要求された場合、QCryptographicHash は実際に Keccak を計算しました。これらのバージョンの Qt で生成された SHA-3 ハッシュとの互換性が必要な場合は、Keccak_ の列挙型を使用してください。また、ソースとの互換性が必要な場合は、マクロQT_SHA3_KECCAK_COMPAT を定義してください。

定数値説明
QCryptographicHash::Md40MD4 ハッシュ和を生成します。
QCryptographicHash::Md51MD5 ハッシュ和を生成する
QCryptographicHash::Sha12SHA-1ハッシュ合計を生成する
QCryptographicHash::Sha2243SHA-224 ハッシュ和 (SHA-2) を生成します。Qt 5.0 で導入されました。
QCryptographicHash::Sha2564SHA-256 ハッシュ和 (SHA-2) を生成します。Qt 5.0 で導入。
QCryptographicHash::Sha3845SHA-384 ハッシュ和 (SHA-2) を生成します。Qt 5.0 で導入。
QCryptographicHash::Sha5126SHA-512 ハッシュ和 (SHA-2) を生成します。Qt 5.0 で導入。
QCryptographicHash::Sha3_224RealSha3_224SHA3-224 ハッシュ和を生成します。Qt 5.1 で導入。
QCryptographicHash::Sha3_256RealSha3_256SHA3-256 ハッシュ和を生成します。Qt 5.1 で導入。
QCryptographicHash::Sha3_384RealSha3_384SHA3-384 ハッシュ和を生成します。Qt 5.1 で導入。
QCryptographicHash::Sha3_512RealSha3_512SHA3-512 ハッシュ和を生成します。Qt 5.1 で導入。
QCryptographicHash::Keccak_2247Keccak-224 ハッシュ和を生成します。Qt 5.9.2 で導入。
QCryptographicHash::Keccak_2568Keccak-256 ハッシュ和を生成します。Qt 5.9.2 で導入。
QCryptographicHash::Keccak_3849Keccak-384 ハッシュ和を生成します。Qt 5.9.2 で導入。
QCryptographicHash::Keccak_51210Keccak-512 ハッシュ和を生成します。Qt 5.9.2 で導入。
QCryptographicHash::Blake2b_16015BLAKE2b-160 ハッシュ和を生成します。Qt 6.0 で導入。
QCryptographicHash::Blake2b_25616BLAKE2b-256 ハッシュ和を生成します。Qt 6.0 で導入。
QCryptographicHash::Blake2b_38417BLAKE2b-384 ハッシュ和を生成します。Qt 6.0 で導入。
QCryptographicHash::Blake2b_51218BLAKE2b-512 ハッシュ和を生成します。Qt 6.0 で導入。
QCryptographicHash::Blake2s_12819BLAKE2s-128 ハッシュ和を生成します。Qt 6.0 で導入。
QCryptographicHash::Blake2s_16020BLAKE2s-160 ハッシュ和を生成します。Qt 6.0 で導入。
QCryptographicHash::Blake2s_22421BLAKE2s-224 ハッシュ和を生成します。Qt 6.0 で導入。
QCryptographicHash::Blake2s_25622BLAKE2s-256 ハッシュ和を生成します。Qt 6.0 で導入。

メンバ関数ドキュメント

[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)

method を使ってdata のハッシュを返し、結果を格納するためにbuffer を使います。

data がスパンである場合、すべてのバイト配列ビューを与えられた順序でハッシュに追加します。

buffer のサイズが足りない場合を除き、戻り値はbuffer のサブスパンとなり、その場合は nullQByteArrayView が返されます。

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

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

[explicit] QCryptographicHash::QCryptographicHash(QCryptographicHash::Algorithm method)

method を使用してデータから暗号ハッシュを作成するために使用できるオブジェクトを構築します。

[noexcept, since 6.5] QCryptographicHash::QCryptographicHash(QCryptographicHash &&other)

移動-other から新しい QCryptographicHash を構築します。

注意: 移動元のオブジェクトother は部分的に形成された状態に置かれ、有効な操作は破棄と新しい値の割り当てのみです。

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

[noexcept] QCryptographicHash::~QCryptographicHash()

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

[noexcept] void QCryptographicHash::addData(QByteArrayView bytes)

bytes の文字を暗号ハッシュに追加します。

注意： Qt 6.3より前のバージョンでは、この関数はQByteArrayView ではなくQByteArray を取ります。

bool QCryptographicHash::addData(QIODevice *device)

開いているQIODevice device から終了するまでデータを読み込み、ハッシュ化します。読み込みに成功した場合はtrue を返します。

[noexcept, since 6.5] QCryptographicHash::Algorithm QCryptographicHash::algorithm() const

暗号化ハッシュの生成に使用されたアルゴリズムを返します。

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

[static] QByteArray QCryptographicHash::hash(QByteArrayView data, QCryptographicHash::Algorithm method)

method を使用してdata のハッシュを返します。

注意: Qt 6.3 より前のバージョンでは、この関数はQByteArrayView ではなくQByteArray を受け取っていました。

hashInto()も参照 。

[static] int QCryptographicHash::hashLength(QCryptographicHash::Algorithm method)

選択したハッシュmethod の出力サイズをバイト単位で返します。

[noexcept] void QCryptographicHash::reset()

オブジェクトをリセットします。

QByteArray QCryptographicHash::result() const

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

resultView() およびQByteArray::toHex() も参照 。

[noexcept, since 6.3] QByteArrayView QCryptographicHash::resultView() const

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

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

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

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

[static, since 6.5] bool QCryptographicHash::supportsAlgorithm(QCryptographicHash::Algorithm method)

選択されたアルゴリズムmethod がサポートされているかどうか、またresult() がmethod を使用したときに値を返すかどうかを返します。

注意: プロバイダとして使用される場合、OpenSSL がこの情報を提供する責任を負います。そうでない場合、OpenSSL 以外の実装には制限がないため、true が返されます。OpenSSL への問い合わせに失敗した場合はfalse を返します。

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

[noexcept, since 6.5] void QCryptographicHash::swap(QCryptographicHash &other)

暗号ハッシュother をこの暗号ハッシュと交換します。この操作は非常に高速で、失敗することはありません。

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

[noexcept, since 6.5] QCryptographicHash &QCryptographicHash::operator=(QCryptographicHash &&other)

other をこのQCryptographicHash インスタンスに移動します。

注意： 移動元のオブジェクトother は、部分的に形成された状態に置かれます。この状態では、有効な操作は破壊と新しい値の割り当てだけです。

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

本ドキュメントに含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。