(0ba673a6b731f9adb4c57a6a8374eefac45b99aa)

#include "qhttpheaders.h"
#include <QtNetwork/private/qnetworkrequest_p.h>
#include <private/qoffsetstringarray_p.h>
#include <QtCore/qcompare.h>
#include <QtCore/qhash.h>
#include <QtCore/qloggingcategory.h>
#include <QtCore/qmap.h>
#include <QtCore/qset.h>
#include <QtCore/qttypetraits.h>
#include <QtCore/qxpfunctional.h>
#include <q20algorithm.h>
#include <string_view>
#include <variant>

Include dependency graph for qhttpheaders.cpp:

Go to the source code of this file.

Classes
struct	HeaderName
struct	Header
class	QHttpHeadersPrivate

Functions
	Q_STATIC_LOGGING_CATEGORY (lcQHttpHeaders, "qt.network.http.headers")
static QByteArray	fieldToByteArray (QLatin1StringView s) noexcept
static QByteArray	fieldToByteArray (QUtf8StringView s) noexcept
static QByteArray	fieldToByteArray (QStringView s)
static QByteArray	normalizedName (QAnyStringView name)
static bool	headerNameValidImpl (QUtf8StringView) noexcept
auto	headerNameMatches (const HeaderName &name)
QDebug	operator<< (QDebug debug, const QHttpHeaders &headers)
QDataStream &	operator<< (QDataStream &out, const QHttpHeaders &headers)
QDataStream &	operator>> (QDataStream &in, QHttpHeaders &headers)
static bool	headerNameValidImpl (QLatin1StringView name) noexcept
static bool	headerNameValidImpl (QStringView name) noexcept
static bool	isValidHttpHeaderNameField (QAnyStringView name) noexcept
static bool	headerValueValidImpl (QLatin1StringView value) noexcept
static bool	headerValueValidImpl (QUtf8StringView value) noexcept
static bool	headerValueValidImpl (QStringView value) noexcept
static bool	isValidHttpHeaderValueField (QAnyStringView value) noexcept
static QByteArray	normalizedValue (QAnyStringView value)

Variables
static constexpr auto	headerNames
static constexpr quint8	orderedHeaderNameIndexes []
constexpr auto	NonWellKnownHeader = QHttpHeaders::WellKnownHeader{-1}
static constexpr auto	isValidHttpHeaderNameChar
static constexpr auto	isValidHttpHeaderValueChar

Function Documentation

◆ fieldToByteArray() [1/3]

QByteArray fieldToByteArray ( QLatin1StringView s )

staticnoexcept

Definition at line 685 of file qhttpheaders.cpp.

◆ fieldToByteArray() [2/3]

QByteArray fieldToByteArray ( QStringView s )

static

Definition at line 695 of file qhttpheaders.cpp.

◆ fieldToByteArray() [3/3]

QByteArray fieldToByteArray ( QUtf8StringView s )

staticnoexcept

Definition at line 690 of file qhttpheaders.cpp.

◆ headerNameMatches()

auto headerNameMatches ( const HeaderName & name )

Definition at line 826 of file qhttpheaders.cpp.

Referenced by QHttpHeaders::contains(), QHttpHeaders::contains(), QHttpHeadersPrivate::removeAll(), and QHttpHeadersPrivate::replaceOrAppend().

Here is the caller graph for this function:

◆ headerNameValidImpl() [1/3]

bool headerNameValidImpl ( QLatin1StringView name )

staticnoexcept

Definition at line 1110 of file qhttpheaders.cpp.

References isValidHttpHeaderNameChar.

◆ headerNameValidImpl() [2/3]

bool headerNameValidImpl ( QStringView name )

staticnoexcept

Definition at line 1123 of file qhttpheaders.cpp.

◆ headerNameValidImpl() [3/3]

bool headerNameValidImpl ( QUtf8StringView name )

staticnoexcept

Definition at line 1115 of file qhttpheaders.cpp.

◆ headerValueValidImpl() [1/3]

bool headerValueValidImpl ( QLatin1StringView value )

staticnoexcept

Definition at line 1159 of file qhttpheaders.cpp.

References isValidHttpHeaderValueChar.

◆ headerValueValidImpl() [2/3]

bool headerValueValidImpl ( QStringView value )

staticnoexcept

Definition at line 1173 of file qhttpheaders.cpp.

◆ headerValueValidImpl() [3/3]

bool headerValueValidImpl ( QUtf8StringView value )

staticnoexcept

Definition at line 1164 of file qhttpheaders.cpp.

References isValidHttpHeaderValueChar.

◆ isValidHttpHeaderNameField()

bool isValidHttpHeaderNameField ( QAnyStringView name )

staticnoexcept

Definition at line 1130 of file qhttpheaders.cpp.

◆ isValidHttpHeaderValueField()

bool isValidHttpHeaderValueField ( QAnyStringView value )

staticnoexcept

Definition at line 1180 of file qhttpheaders.cpp.

◆ normalizedName()

QByteArray normalizedName ( QAnyStringView name )

static

Definition at line 700 of file qhttpheaders.cpp.

◆ normalizedValue()

QByteArray normalizedValue ( QAnyStringView value )

static

Definition at line 1188 of file qhttpheaders.cpp.

◆ operator<<() [1/2]

QDataStream & operator<<	(	QDataStream &	out,
		const QHttpHeaders &	headers )

Definition at line 1067 of file qhttpheaders.cpp.

◆ operator<<() [2/2]

QDebug operator<<	(	QDebug	debug,
		const QHttpHeaders &	headers )

Definition at line 1039 of file qhttpheaders.cpp.

◆ operator>>()

QDataStream & operator>>	(	QDataStream &	in,
		QHttpHeaders &	headers )

Definition at line 1083 of file qhttpheaders.cpp.

◆ Q_STATIC_LOGGING_CATEGORY()

Q_STATIC_LOGGING_CATEGORY	(	lcQHttpHeaders	,
		"qt.network.http.headers"	)

Variable Documentation

◆ headerNames

constexpr auto headerNames

staticconstexpr

\class QHttpHeaders
\since 6.7
\ingroup
\inmodule QtNetwork

\brief QHttpHeaders is a class for holding HTTP headers.

The class is an interface type for Qt networking APIs that
use or consume such headers.

\section1 Allowed field name and value characters

An HTTP header consists of \e name and \e value.
When setting these, QHttpHeaders validates \e name and \e value
to only contain characters allowed by the HTTP RFCs. For detailed
information see
\l {https://datatracker.ietf.org/doc/html/rfc9110#name-field-values}
{RFC 9110 Chapters 5.1 and 5.5}.

In all, this means:
\list
    \li \c name must consist of visible ASCII characters, and must not be
        empty
    \li \c value may consist of arbitrary bytes, as long as header
        and use case specific encoding rules are adhered to. \c value
        may be empty
\endlist

The setters of this class automatically remove any leading or trailing
whitespaces from \e value, as they must be ignored during the
\e value processing.

\section1 Combining values

Most HTTP header values can be combined with a single comma \c {','}
plus an optional whitespace, and the semantic meaning is preserved.
As an example, these two should be semantically similar:
\badcode

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

However, there is a notable exception to this rule: \l {https://datatracker.ietf.org/doc/html/rfc9110#name-field-order} {Set-Cookie}. Due to this and the possibility of custom use cases, QHttpHeaders does not automatically combine the values.

Definition at line 95 of file qhttpheaders.cpp.

◆ isValidHttpHeaderNameChar

constexpr auto isValidHttpHeaderNameChar

staticconstexpr

Initial value:

                                                = [](uchar c) noexcept
{
    
    return (('A' <= c && c <= 'Z')
            || ('a' <= c && c <= 'z')
            || ('0' <= c && c <= '9')
            || ('#' <= c && c <= '\'')
            || ('^' <= c && c <= '`')
            || c == '|' || c == '~' || c == '!' || c == '*' || c == '+' || c == '-' || c == '.');
}

Definition at line 1092 of file qhttpheaders.cpp.

Referenced by headerNameValidImpl().

◆ isValidHttpHeaderValueChar

constexpr auto isValidHttpHeaderValueChar

staticconstexpr

Initial value:

                                                 = [](uchar c) noexcept
{
    
    return (c >= 0x80 
        || (0x20 <= c && c <= 0x7E) 
        || (c == 0x09)); 
}

Definition at line 1142 of file qhttpheaders.cpp.

Referenced by headerValueValidImpl(), and headerValueValidImpl().

◆ NonWellKnownHeader

auto NonWellKnownHeader = QHttpHeaders::WellKnownHeader{-1}

constexpr

Definition at line 683 of file qhttpheaders.cpp.

◆ orderedHeaderNameIndexes

constexpr quint8 orderedHeaderNameIndexes

staticconstexpr

Definition at line 312 of file qhttpheaders.cpp.

(0ba673a6b731f9adb4c57a6a8374eefac45b99aa)

Classes

Functions

Variables

Function Documentation

◆ fieldToByteArray() [1/3]

◆ fieldToByteArray() [2/3]

◆ fieldToByteArray() [3/3]

◆ headerNameMatches()

◆ headerNameValidImpl() [1/3]

◆ headerNameValidImpl() [2/3]

◆ headerNameValidImpl() [3/3]

◆ headerValueValidImpl() [1/3]

◆ headerValueValidImpl() [2/3]

◆ headerValueValidImpl() [3/3]

◆ isValidHttpHeaderNameField()

◆ isValidHttpHeaderValueField()

◆ normalizedName()

◆ normalizedValue()

◆ operator<<() [1/2]

◆ operator<<() [2/2]

◆ operator>>()

◆ Q_STATIC_LOGGING_CATEGORY()

Variable Documentation

◆ headerNames

◆ isValidHttpHeaderNameChar

◆ isValidHttpHeaderValueChar

◆ NonWellKnownHeader

◆ orderedHeaderNameIndexes