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 의 크기가 충분하지 않은 경우에는 null QByteArrayView 이 반환됩니다.

이 함수들은 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에서 도입되었습니다.