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 的副本。

[noexcept] 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)

该函数重载了append(QAnyStringView, QAnyStringView)。

void QHttpHeaders::clear()

清除所有标头条目。

另请参阅 size().

QByteArray QHttpHeaders::combinedValue(QAnyStringView name) const

以逗号连接的字符串形式返回name 头的值。如果带有name 的标头不存在，则返回null QByteArray 。

另请参阅 values(QAnyStringView)。

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

该函数重载了combinedValue(QAnyStringView)。

bool QHttpHeaders::contains(QAnyStringView name) const

返回头信息是否包含带有name 的头信息。

另请参阅 contains(QHttpHeaders::WellKnownHeader)。

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

该函数重载了 has(QAnyStringView)。

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

创建一个新的QHttpHeaders 对象，该对象由headers 填充。

另请参阅 Allowed field name and value characters 。

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

创建一个新的QHttpHeaders 对象，该对象由headers 填充。

另请参阅 Allowed field name and value characters 。

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

创建一个新的QHttpHeaders 对象，该对象由headers 填充。

另请参阅 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)

该函数重载了insert(qsizetype, QAnyStringView, QAnyStringView)。

[noexcept] bool QHttpHeaders::isEmpty() const

如果标头大小为 0，则返回true ；否则返回false 。

另请参阅 size() 。

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

返回索引i 中的标头名称。索引i 必须有效（参见size() ）。

标头名称不区分大小写，返回的名称小写。

另请参阅 size() 和valueAt()。

void QHttpHeaders::removeAll(QAnyStringView name)

移除头name 。

另请参阅 removeAt() 和removeAll(QHttpHeaders::WellKnownHeader)。

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

该函数重载了removeAll(QAnyStringView)。

void QHttpHeaders::removeAt(qsizetype i)

删除索引i 上的标头。索引i 必须有效（参见size()).

另请参阅 removeAll(QHttpHeaders::WellKnownHeader)、removeAll(QAnyStringView) 和size() 。

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

用name 和newValue 替换索引i 中的页眉条目。索引必须有效（参见size() ）。返回替换是否成功。

另请参阅 append(),replace(qsizetype, QHttpHeaders::WellKnownHeader, QAnyStringView),size() 和Allowed field name and value characters 。

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

该函数重载了replace(qsizetype, QAnyStringView, QAnyStringView)。

[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)

此函数重载 replaceOrAppend(WellKnownHeader, QAnyStringView)。

void QHttpHeaders::reserve(qsizetype size)

尝试为至少size 头文件分配内存。

如果事先知道将有多少个报头条目，则可以调用此函数来防止重新分配和内存碎片。

[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

该函数重载了value （QAnyStringView、QByteArrayView）。

[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

该函数重载了values(QAnyStringView)。

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

返回与作为视图提供的name 相对应的页眉名称。

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

Move-assignsother 并返回对该对象的引用。

other 将离开 。empty

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

指定other 的内容，并返回对该对象的引用。