QHttpHeaders Class

// Values as separate header entries
myheadername: myheadervalue1
myheadername: myheadervalue2
// Combined value
myheadername: myheadervalue1, myheadervalue2

멤버 함수 문서

[noexcept] QHttpHeaders::QHttpHeaders()

새로운 QHttpHeaders 객체를 생성합니다.

QHttpHeaders::QHttpHeaders(const QHttpHeaders &other)

other 의 복사본을 생성합니다.

[constexpr noexcept default] QHttpHeaders::QHttpHeaders(QHttpHeaders &&other)

other 에서 객체를 이동 생성하며, 는 그대로 유지됩니다 empty.

[noexcept] QHttpHeaders::~QHttpHeaders()

헤더 객체를 제거합니다.

bool QHttpHeaders::append(QAnyStringView name, QAnyStringView value)

name 와 value 를 가진 헤더 항목을 추가하고, 성공하면 true 를 반환합니다.

append(QHttpHeaders::WellKnownHeader, QAnyStringView) 및 Allowed field name and value characters도 참조하십시오 .

bool QHttpHeaders::append(QHttpHeaders::WellKnownHeader name, QAnyStringView value)

void QHttpHeaders::clear()

모든 헤더 항목을 지웁니다.

size()도 참조하십시오 .

QByteArray QHttpHeaders::combinedValue(QAnyStringView name) const

name 헤더의 값을 쉼표로 구분된 문자열로 반환합니다. name 값을 가진 헤더가 존재하지 않으면 null QByteArray 를 반환합니다.

values(QAnyStringView)도 참조하십시오 .

QByteArray QHttpHeaders::combinedValue(QHttpHeaders::WellKnownHeader name) const

bool QHttpHeaders::contains(QAnyStringView name) const

헤더에 name 가 포함되어 있는지 여부를 반환합니다.

contains(QHttpHeaders::WellKnownHeader)항목도 참조하십시오 .

bool QHttpHeaders::contains(QHttpHeaders::WellKnownHeader name) const

[since 6.10] std::optional<QDateTime> QHttpHeaders::dateTimeValue(QAnyStringView name) const

표준 HTTP 날짜 형식에 따라 ` name `에서 처음 발견된 헤더 값을 ` QDateTime ` 객체로 변환합니다. 헤더가 존재하지 않거나 유효하지 않은 ` QDateTime`을 포함하는 경우, ` std::nullopt`을 반환합니다.

이 함수는 Qt 6.10에서 도입되었습니다.

setDateTimeValue(), dateTimeValues(QAnyStringView name) 및 dateTimeValueAt(qsizetype i)도 참조하십시오 .

[since 6.10] std::optional<QDateTime> QHttpHeaders::dateTimeValue(QHttpHeaders::WellKnownHeader name) const

이 함수는 Qt 6.10에서 도입되었습니다.

[since 6.10] std::optional<QDateTime> QHttpHeaders::dateTimeValueAt(qsizetype i) const

인덱스 i 에 있는 헤더 값을 표준 HTTP 날짜 형식에 따라 QDateTime 객체로 변환합니다. 인덱스 i 은 유효해야 합니다.

이 함수는 Qt 6.10에서 도입되었습니다.

dateTimeValue(QAnyStringView name) 및 dateTimeValues(QAnyStringView name)도 참조하십시오 .

[since 6.10] std::optional<QList<QDateTime>> QHttpHeaders::dateTimeValues(QAnyStringView name) const

name 의 모든 헤더 값을 표준 HTTP 날짜 형식에 따라 ` QDateTime ` 객체 목록으로 반환합니다. 유효한 날짜-시간 값이 발견되지 않으면 ` std::nullopt`를 반환합니다.

이 함수는 Qt 6.10에서 도입되었습니다.

dateTimeValue(QAnyStringView name) 및 dateTimeValueAt(qsizetype i)도 참조하십시오 .

[since 6.10] std::optional<QList<QDateTime>> QHttpHeaders::dateTimeValues(QHttpHeaders::WellKnownHeader name) const

이 함수는 Qt 6.10에서 도입되었습니다.

[static] QHttpHeaders QHttpHeaders::fromListOfPairs(const QList<std::pair<QByteArray, QByteArray>> &headers)

headers 의 값이 설정된 새로운 QHttpHeaders 객체를 생성합니다.

Allowed field name and value characters도 참조하십시오 .

[static] QHttpHeaders QHttpHeaders::fromMultiHash(const QMultiHash<QByteArray, QByteArray> &headers)

headers 의 값이 설정된 새로운 QHttpHeaders 객체를 생성합니다.

Allowed field name and value characters도 참조하십시오 .

[static] QHttpHeaders QHttpHeaders::fromMultiMap(const QMultiMap<QByteArray, QByteArray> &headers)

headers 의 값이 채워진 새로운 QHttpHeaders 객체를 생성합니다.

Allowed field name and value characters도 참조하십시오 .

bool QHttpHeaders::insert(qsizetype i, QAnyStringView name, QAnyStringView value)

인덱스 i 에 헤더 항목을 삽입하며, name 및 value 를 지정합니다. 인덱스는 유효해야 합니다( size() 참조). 삽입이 성공했는지 여부를 반환합니다.

append(), insert(qsizetype, QHttpHeaders::WellKnownHeader, QAnyStringView), size() 및 Allowed field name and value characters도 참조하십시오 .

bool QHttpHeaders::insert(qsizetype i, QHttpHeaders::WellKnownHeader name, QAnyStringView value)

[noexcept, since 6.10] std::optional<qint64> QHttpHeaders::intValue(QAnyStringView name) const

첫 번째 유효한 헤더 name 의 값을 64비트 정수로 해석하여 반환합니다. 헤더가 존재하지 않거나 정수로 구문 분석할 수 없는 경우, ` std::nullopt`을 반환합니다.

이 함수는 Qt 6.10에서 도입되었습니다.

intValues(QAnyStringView name) 및 intValueAt(qsizetype i)도 참조하십시오 .

[noexcept, since 6.10] std::optional<qint64> QHttpHeaders::intValue(QHttpHeaders::WellKnownHeader name) const

이 함수는 Qt 6.10에서 도입되었습니다.

[noexcept, since 6.10] std::optional<qint64> QHttpHeaders::intValueAt(qsizetype i) const

i 인덱스에서 64비트 정수로 해석된 헤더 값을 반환합니다. i 인덱스는 유효해야 합니다.

이 함수는 Qt 6.10에서 도입되었습니다.

intValues(QAnyStringView name) 및 intValue(QAnyStringView name)도 참조하십시오 .

[since 6.10] std::optional<QList<qint64>> QHttpHeaders::intValues(QAnyStringView name) const

name 헤더의 값을 64비트 정수로 해석하여 목록 형태로 반환합니다. 헤더가 존재하지 않거나 정수로 파싱할 수 없는 경우, std::nullopt 를 반환합니다.

이 함수는 Qt 6.10에서 도입되었습니다.

intValue(QAnyStringView name) 및 intValueAt(qsizetype i)도 참조하십시오 .

[since 6.10] std::optional<QList<qint64>> QHttpHeaders::intValues(QHttpHeaders::WellKnownHeader name) const

이 함수는 Qt 6.10에서 도입되었습니다.

[noexcept] bool QHttpHeaders::isEmpty() const

헤더의 크기가 0인 경우 ` true `을 반환하고, 그렇지 않은 경우 ` false`을 반환합니다.

size()도 참조하십시오 .

[noexcept] QLatin1StringView QHttpHeaders::nameAt(qsizetype i) const

i 인덱스에 있는 헤더 이름을 반환합니다. i 인덱스는 유효해야 합니다( size() 참조).

헤더 이름은 대소문자를 구분하지 않으며, 반환되는 이름은 소문자로 변환됩니다.

size() 및 valueAt()도 참조하십시오 .

[since 6.12] std::optional<QHttpHeaderRangeSet> QHttpHeaders::rangeValues() const

Range HTTP 헤더 필드의 범위를 반환하거나, 구문 분석에 실패한 경우 std::nullopt 를 반환합니다.

각 범위는 바이트 범위를 나타냅니다. RFC 9110에 따르면:

• 시작 범위는 지정되었으나 끝 범위가 지정되지 않은 경우(예: "bytes=500-"), ` QHttpHeaderRangeSpec ` 값은 ` start=500 ` 및 ` end=std::nullopt`이 됩니다.
• 끝이 지정되었으나 시작이 지정되지 않은 경우(예: "bytes=-500"), QHttpHeaderRangeSpec 에는 start=std::nullopt 및 end=500 이 포함되며, 이는 마지막 500바이트를 나타냅니다.
• 양쪽이 모두 지정된 경우(예: "bytes=0-499"), QHttpHeaderRangeSpec 에는 start=0 및 end=499 가 포함됩니다.

범위는 헤더에 나타나는 순서대로 반환됩니다.

구문 분석은 다음과 같이 수행됩니다:

• Range 헤더가 없는 경우, 빈 범위 집합이 반환됩니다.
• RFC 9110 섹션 14.2에 따르면, "bytes" 이외의 단위(예: "seconds=1-2")를 포함하는 Range 헤더는 무시됩니다. 이러한 무시된 헤더로 인해 구문 분석이 실패하지는 않습니다.
• Range 헤더가 "bytes" 단위를 사용하지만 형식이 잘못된 경우(예: 하이픈 누락, 유효하지 않은 문자 포함, 유효하지 않은 숫자 포함), 이 함수는 ` std::nullopt`를 반환합니다.

이 함수는 Qt 6.12에서 도입되었습니다.

setRangeValues 및 WellKnownHeader::Range도 참조하십시오 .

void QHttpHeaders::removeAll(QAnyStringView name)

name 헤더를 제거합니다.

removeAt() 및 removeAll(QHttpHeaders::WellKnownHeader)도 참조하십시오 .

void QHttpHeaders::removeAll(QHttpHeaders::WellKnownHeader name)

void QHttpHeaders::removeAt(qsizetype i)

인덱스 i 에 있는 헤더를 제거합니다. 인덱스 i 는 유효해야 합니다( size() 참조).

removeAll(QHttpHeaders::WellKnownHeader), removeAll(QAnyStringView) 및 size()도 참조하십시오 .

bool QHttpHeaders::replace(qsizetype i, QAnyStringView name, QAnyStringView newValue)

인덱스 i 에 있는 헤더 항목을 name 및 newValue 로 대체합니다. 인덱스는 유효해야 합니다( size() 참조). 대체가 성공했는지 여부를 반환합니다.

append(), replace(qsizetype, QHttpHeaders::WellKnownHeader, QAnyStringView), size(), 및 Allowed field name and value characters도 참조하십시오 .

bool QHttpHeaders::replace(qsizetype i, QHttpHeaders::WellKnownHeader name, QAnyStringView newValue)

[since 6.8] bool QHttpHeaders::replaceOrAppend(QHttpHeaders::WellKnownHeader name, QAnyStringView newValue)

QHttpHeaders 에 이미 name 가 포함되어 있다면, 그 값을 newValue 로 대체하고, 추가로 있을 수 있는 name 항목을 제거합니다. name 가 존재하지 않는 경우, 새로운 항목을 추가합니다. 성공하면 true 를 반환합니다.

이 함수는 고유한 name: newValue 헤더를 설정하기 위한 편의 메서드입니다. 대부분의 헤더의 경우 상대적 순서는 중요하지 않으므로, 기존 항목이 존재하면 이를 재사용할 수 있습니다.

이 함수는 Qt 6.8에서 도입되었습니다.

replaceOrAppend(QAnyStringView, QAnyStringView)항목도 참조하십시오 .

bool QHttpHeaders::replaceOrAppend(QAnyStringView name, QAnyStringView newValue)

void QHttpHeaders::reserve(qsizetype size)

size 개 이상의 헤더 항목에 대한 메모리를 할당하려고 시도합니다.

헤더 항목의 개수를 미리 알고 있는 경우, 이 함수를 호출하여 재할당 및 메모리 단편화를 방지할 수 있습니다.

[since 6.10] void QHttpHeaders::setDateTimeValue(QAnyStringView name, const QDateTime &dateTime)

표준 HTTP IMF-fixdate 형식에 따라 헤더 이름 name 의 값을 dateTime 로 설정합니다. 해당 헤더가 존재하지 않으면 새로운 헤더를 추가합니다.

이 함수는 Qt 6.10에서 도입되었습니다.

dateTimeValue(QAnyStringView name) 및 dateTimeValueAt(qsizetype i)도 참조하십시오 .

[since 6.10] void QHttpHeaders::setDateTimeValue(QHttpHeaders::WellKnownHeader name, const QDateTime &dateTime)

이 함수는 Qt 6.10에서 도입되었습니다.

[since 6.12] void QHttpHeaders::setRangeValues(const QHttpHeaderRangeSet &ranges)

Range HTTP 헤더 필드를 지정된 ranges 목록으로 설정합니다.

범위는 "바이트(bytes)" 단위로 형식화되며, ` ranges `가 이를 저장하는 순서대로 나열됩니다. 각 ` QHttpHeaderRangeSpec`에 대해:

• 시작점만 있는 범위(예: QHttpHeaderRangeSpec(500, std::nullopt))는 "500-" 형식으로 표시됩니다.
• 끝점만 있는 범위(예: QHttpHeaderRangeSpec(std::nullopt, 500))는 "-500" 형식으로 표시되며, 이는 마지막 500바이트를 나타냅니다.
• 시작과 끝이 모두 지정된 범위(예: QHttpHeaderRangeSpec(0, 499))는 "0-499" 로 형식화됩니다.

여러 범위가 제공된 경우, 쉼표로 연결됩니다(예: "bytes=0-499, 1000-").

ranges 가 비어 있는 경우, Range 헤더가 제거됩니다.

이 함수는 Qt 6.12에서 도입되었습니다.

rangeValues() 및 WellKnownHeader::Range도 참조하십시오 .

[noexcept] qsizetype QHttpHeaders::size() const

헤더 항목의 개수를 반환합니다.

[noexcept] void QHttpHeaders::swap(QHttpHeaders &other)

QHttpHeaders 를 other 로 교체합니다. 이 작업은 매우 빠르며 절대 실패하지 않습니다.

QList<std::pair<QByteArray, QByteArray>> QHttpHeaders::toListOfPairs() const

헤더 항목을 (이름, 값) 짝으로 구성된 목록으로 반환합니다. 헤더 이름은 대소문자를 구분하지 않으며, 반환되는 이름은 소문자로 변환됩니다.

QMultiHash<QByteArray, QByteArray> QHttpHeaders::toMultiHash() const

헤더 항목을 이름과 값(들)의 해시 형태로 반환합니다. 헤더 이름은 대소문자를 구분하지 않으며, 반환되는 이름은 소문자로 변환됩니다.

QMultiMap<QByteArray, QByteArray> QHttpHeaders::toMultiMap() const

헤더 항목을 ‘이름’과 ‘값(들)’의 맵 형태로 반환합니다. 헤더 이름은 대소문자를 구분하지 않으며, 반환되는 이름은 소문자로 변환됩니다.

[noexcept] QByteArrayView QHttpHeaders::value(QAnyStringView name, QByteArrayView defaultValue = {}) const

name 의 (첫 번째) 헤더 값을 반환하며, 해당 헤더가 존재하지 않을 경우 defaultValue 를 반환합니다.

value(QHttpHeaders::WellKnownHeader, QByteArrayView)도 참조하십시오 .

[noexcept] QByteArrayView QHttpHeaders::value(QHttpHeaders::WellKnownHeader name, QByteArrayView defaultValue = {}) const

[noexcept] QByteArrayView QHttpHeaders::valueAt(qsizetype i) const

i 인덱스에 있는 헤더 값을 반환합니다. i 인덱스는 유효해야 합니다( size() 참조).

size(), value(), values(), combinedValue() 및 nameAt()도 참조하십시오 .

QList<QByteArray> QHttpHeaders::values(QAnyStringView name) const

name 헤더의 값들을 목록 형태로 반환합니다. name 헤더가 존재하지 않으면 빈 목록을 반환합니다.

values(QHttpHeaders::WellKnownHeader)도 참조하십시오 .

QList<QByteArray> QHttpHeaders::values(QHttpHeaders::WellKnownHeader name) const

[static noexcept] QByteArrayView QHttpHeaders::wellKnownHeaderName(QHttpHeaders::WellKnownHeader name)

지정된 ` name `에 해당하는 헤더 이름을 뷰로 반환합니다.

[noexcept] QHttpHeaders &QHttpHeaders::operator=(QHttpHeaders &&other)

other 에 값을 할당하고 이 객체에 대한 참조를 반환합니다.

other empty 가 남게 됩니다.

QHttpHeaders &QHttpHeaders::operator=(const QHttpHeaders &other)

other 의 내용을 할당하고, 이 객체에 대한 참조를 반환합니다.