summaryrefslogtreecommitdiffstats
path: root/src/corelib/tools/qmessageauthenticationcode.h
blob: 7c5edfa7bfb5401e0ea386817238d1872b77a999 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
// Copyright (C) 2013 Ruslan Nigmatullin <euroelessar@yandex.ru>
// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR LGPL-3.0-only OR GPL-2.0-only OR GPL-3.0-only

#ifndef QMESSAGEAUTHENTICATIONCODE_H
#define QMESSAGEAUTHENTICATIONCODE_H

#include <QtCore/qcryptographichash.h>

QT_BEGIN_NAMESPACE


class QMessageAuthenticationCodePrivate;
class QIODevice;

// implemented in qcryptographichash.cpp
class Q_CORE_EXPORT QMessageAuthenticationCode
{
public:
#if QT_CORE_REMOVED_SINCE(6, 6)
    explicit QMessageAuthenticationCode(QCryptographicHash::Algorithm method,
                                        const QByteArray &key);
#endif
    explicit QMessageAuthenticationCode(QCryptographicHash::Algorithm method,
                                        QByteArrayView key = {});

    QMessageAuthenticationCode(QMessageAuthenticationCode &&other) noexcept
        : d{std::exchange(other.d, nullptr)} {}
    ~QMessageAuthenticationCode();

    QT_MOVE_ASSIGNMENT_OPERATOR_IMPL_VIA_MOVE_AND_SWAP(QMessageAuthenticationCode)
    void swap(QMessageAuthenticationCode &other) noexcept
    { qt_ptr_swap(d, other.d); }

    void reset() noexcept;

#if QT_CORE_REMOVED_SINCE(6, 6)
    void setKey(const QByteArray &key);
#endif
    void setKey(QByteArrayView key) noexcept;

    void addData(const char *data, qsizetype length);
#if QT_CORE_REMOVED_SINCE(6, 6)
    void addData(const QByteArray &data);
#endif
    void addData(QByteArrayView data) noexcept;
    bool addData(QIODevice *device);

    QByteArrayView resultView() const noexcept;
    QByteArray result() const;

#if QT_CORE_REMOVED_SINCE(6, 6)
    static QByteArray hash(const QByteArray &message, const QByteArray &key,
                           QCryptographicHash::Algorithm method);
#endif
    static QByteArray hash(QByteArrayView message, QByteArrayView key,
                           QCryptographicHash::Algorithm method);

    static QByteArrayView
    hashInto(QSpan<char> buffer, QByteArrayView message, QByteArrayView key,
             QCryptographicHash::Algorithm method) noexcept
    { return hashInto(as_writable_bytes(buffer), {&message, 1}, key, method); }
    static QByteArrayView
    hashInto(QSpan<uchar> buffer, QByteArrayView message, QByteArrayView key,
             QCryptographicHash::Algorithm method) noexcept
    { return hashInto(as_writable_bytes(buffer), {&message, 1}, key, method); }
    static QByteArrayView
    hashInto(QSpan<std::byte> buffer, QByteArrayView message,
             QByteArrayView key, QCryptographicHash::Algorithm method) noexcept
    { return hashInto(buffer, {&message, 1}, key, method); }
    static QByteArrayView
    hashInto(QSpan<char> buffer, QSpan<const QByteArrayView> messageParts,
             QByteArrayView key, QCryptographicHash::Algorithm method) noexcept
    { return hashInto(as_writable_bytes(buffer), messageParts, key, method); }
    static QByteArrayView
    hashInto(QSpan<uchar> buffer, QSpan<const QByteArrayView> messageParts,
             QByteArrayView key, QCryptographicHash::Algorithm method) noexcept
    { return hashInto(as_writable_bytes(buffer), messageParts, key, method); }
    static QByteArrayView
    hashInto(QSpan<std::byte> buffer, QSpan<const QByteArrayView> message,
             QByteArrayView key, QCryptographicHash::Algorithm method) noexcept;

private:
    Q_DISABLE_COPY(QMessageAuthenticationCode)
    QMessageAuthenticationCodePrivate *d;
};

QT_END_NAMESPACE

#endif