Qt
Internal/Contributor docs for the Qt SDK. <b>Note:</b> These are NOT official API docs; those are found <a href='https://doc.qt.io/'>here</a>.
|
#include "qhttpheaders.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 <q20algorithm.h>
#include <string_view>
#include <variant>
Go to the source code of this file.
Classes | |
struct | HeaderName |
struct | Header |
class | QHttpHeadersPrivate |
Variables | |
static constexpr auto | headerNames |
static constexpr quint8 | orderedHeaderNameIndexes [] |
static constexpr auto | isValidHttpHeaderNameChar |
static constexpr auto | isValidHttpHeaderValueChar |
|
staticnoexcept |
Definition at line 675 of file qhttpheaders.cpp.
References QByteArray().
Referenced by normalizedName(), and normalizedValue().
|
static |
Definition at line 685 of file qhttpheaders.cpp.
|
staticnoexcept |
Definition at line 680 of file qhttpheaders.cpp.
References QByteArray().
auto headerNameMatches | ( | const HeaderName & | name | ) |
Definition at line 778 of file qhttpheaders.cpp.
References header().
Referenced by QHttpHeaders::contains(), QHttpHeaders::contains(), QHttpHeadersPrivate::removeAll(), and QHttpHeadersPrivate::replaceOrAppend().
|
staticnoexcept |
Definition at line 1009 of file qhttpheaders.cpp.
References isValidHttpHeaderNameChar.
Referenced by headerNameValidImpl(), and isValidHttpHeaderNameField().
|
staticnoexcept |
Definition at line 1022 of file qhttpheaders.cpp.
|
staticnoexcept |
Definition at line 1014 of file qhttpheaders.cpp.
References headerNameValidImpl().
|
staticnoexcept |
Definition at line 1058 of file qhttpheaders.cpp.
References isValidHttpHeaderValueChar.
Referenced by isValidHttpHeaderValueField().
|
staticnoexcept |
Definition at line 1072 of file qhttpheaders.cpp.
|
staticnoexcept |
Definition at line 1063 of file qhttpheaders.cpp.
References isValidHttpHeaderValueChar.
|
staticnoexcept |
Definition at line 1029 of file qhttpheaders.cpp.
References headerNameValidImpl(), and qCWarning.
Referenced by QHttpHeaders::append(), QHttpHeaders::insert(), QHttpHeaders::replace(), and QHttpHeaders::replaceOrAppend().
|
staticnoexcept |
Definition at line 1079 of file qhttpheaders.cpp.
References headerValueValidImpl(), and qCWarning.
Referenced by QHttpHeaders::append(), QHttpHeaders::append(), QHttpHeaders::insert(), QHttpHeaders::insert(), QHttpHeaders::replace(), QHttpHeaders::replace(), QHttpHeaders::replaceOrAppend(), and QHttpHeaders::replaceOrAppend().
|
static |
Definition at line 690 of file qhttpheaders.cpp.
References fieldToByteArray().
Referenced by HeaderName::HeaderName(), QDBusConnectionPrivate::findSlot(), QDBusConnectionPrivate::prepareHook(), and QDBusPendingCallPrivate::setReplyCallback().
|
static |
Definition at line 1087 of file qhttpheaders.cpp.
References fieldToByteArray().
Referenced by QHttpHeaders::append(), QHttpHeaders::append(), QHttpHeaders::insert(), QHttpHeaders::insert(), QHttpHeaders::replace(), QHttpHeaders::replace(), QHttpHeaders::replaceOrAppend(), and QHttpHeaders::replaceOrAppend().
QDebug operator<< | ( | QDebug | debug, |
const QHttpHeaders & | headers ) |
Definition at line 972 of file qhttpheaders.cpp.
QT_BEGIN_NAMESPACE Q_LOGGING_CATEGORY | ( | lcQHttpHeaders | , |
"qt.network.http.headers" | ) |
|
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 89 of file qhttpheaders.cpp.
Referenced by HeaderName::asByteArray(), HeaderName::asView(), HeaderName::toWellKnownHeader(), and QHttpHeaders::wellKnownHeaderName().
|
staticconstexpr |
Definition at line 991 of file qhttpheaders.cpp.
Referenced by headerNameValidImpl().
|
staticconstexpr |
Definition at line 1041 of file qhttpheaders.cpp.
Referenced by headerValueValidImpl(), and headerValueValidImpl().
|
staticconstexpr |
Definition at line 306 of file qhttpheaders.cpp.
Referenced by HeaderName::toWellKnownHeader().