En esta página

QHttpHeaders Class

QHttpHeaders es una clase destinada a almacenar encabezados HTTP. Más información...

Encabezado: #include <QHttpHeaders>
CMake: find_package(Qt6 REQUIRED COMPONENTS Network)
target_link_libraries(mytarget PRIVATE Qt6::Network)
qmake: QT += network
Desde: Qt 6.7

Tipos públicos

enum class WellKnownHeader { AIM, Accept, AcceptAdditions, AcceptCH, AcceptDatetime, …, ProtocolQuery }

Funciones públicas

QHttpHeaders()
QHttpHeaders(const QHttpHeaders &other)
QHttpHeaders(QHttpHeaders &&other)
~QHttpHeaders()
bool append(QAnyStringView name, QAnyStringView value)
bool append(QHttpHeaders::WellKnownHeader name, QAnyStringView value)
void clear()
QByteArray combinedValue(QAnyStringView name) const
QByteArray combinedValue(QHttpHeaders::WellKnownHeader name) const
bool contains(QAnyStringView name) const
bool contains(QHttpHeaders::WellKnownHeader name) const
(since 6.10) std::optional<QDateTime> dateTimeValue(QAnyStringView name) const
(since 6.10) std::optional<QDateTime> dateTimeValue(QHttpHeaders::WellKnownHeader name) const
(since 6.10) std::optional<QDateTime> dateTimeValueAt(qsizetype i) const
(since 6.10) std::optional<QList<QDateTime>> dateTimeValues(QAnyStringView name) const
(since 6.10) std::optional<QList<QDateTime>> dateTimeValues(QHttpHeaders::WellKnownHeader name) const
bool insert(qsizetype i, QAnyStringView name, QAnyStringView value)
bool insert(qsizetype i, QHttpHeaders::WellKnownHeader name, QAnyStringView value)
(since 6.10) std::optional<qint64> intValue(QAnyStringView name) const
(since 6.10) std::optional<qint64> intValue(QHttpHeaders::WellKnownHeader name) const
(since 6.10) std::optional<qint64> intValueAt(qsizetype i) const
(since 6.10) std::optional<QList<qint64>> intValues(QAnyStringView name) const
(since 6.10) std::optional<QList<qint64>> intValues(QHttpHeaders::WellKnownHeader name) const
bool isEmpty() const
QLatin1StringView nameAt(qsizetype i) const
(since 6.12) std::optional<QHttpHeaderRangeSet> rangeValues() const
void removeAll(QAnyStringView name)
void removeAll(QHttpHeaders::WellKnownHeader name)
void removeAt(qsizetype i)
bool replace(qsizetype i, QAnyStringView name, QAnyStringView newValue)
bool replace(qsizetype i, QHttpHeaders::WellKnownHeader name, QAnyStringView newValue)
(since 6.8) bool replaceOrAppend(QHttpHeaders::WellKnownHeader name, QAnyStringView newValue)
bool replaceOrAppend(QAnyStringView name, QAnyStringView newValue)
void reserve(qsizetype size)
(since 6.10) void setDateTimeValue(QAnyStringView name, const QDateTime &dateTime)
(since 6.10) void setDateTimeValue(QHttpHeaders::WellKnownHeader name, const QDateTime &dateTime)
(since 6.12) void setRangeValues(const QHttpHeaderRangeSet &ranges)
qsizetype size() const
void swap(QHttpHeaders &other)
QList<std::pair<QByteArray, QByteArray>> toListOfPairs() const
QMultiHash<QByteArray, QByteArray> toMultiHash() const
QMultiMap<QByteArray, QByteArray> toMultiMap() const
QByteArrayView value(QAnyStringView name, QByteArrayView defaultValue = {}) const
QByteArrayView value(QHttpHeaders::WellKnownHeader name, QByteArrayView defaultValue = {}) const
QByteArrayView valueAt(qsizetype i) const
QList<QByteArray> values(QAnyStringView name) const
QList<QByteArray> values(QHttpHeaders::WellKnownHeader name) const
QHttpHeaders &operator=(QHttpHeaders &&other)
QHttpHeaders &operator=(const QHttpHeaders &other)

Miembros públicos estáticos

QHttpHeaders fromListOfPairs(const QList<std::pair<QByteArray, QByteArray>> &headers)
QHttpHeaders fromMultiHash(const QMultiHash<QByteArray, QByteArray> &headers)
QHttpHeaders fromMultiMap(const QMultiMap<QByteArray, QByteArray> &headers)
QByteArrayView wellKnownHeaderName(QHttpHeaders::WellKnownHeader name)
(since 6.12) QDataStream &operator<<(QDataStream &out, const QHttpHeaders &headers)
QDebug operator<<(QDebug debug, const QHttpHeaders &headers)
(since 6.12) QDataStream &operator>>(QDataStream &in, QHttpHeaders &headers)

Descripción detallada

La clase es un tipo de interfaz para las API de Qt Network que utilizan o consumen dichos encabezados.

Caracteres permitidos en los nombres y valores de los campos

Un encabezado HTTP consta de un nombre y un valor. Al configurarlos, QHttpHeaders comprueba que el nombre y el valor solo contengan caracteres permitidos por los RFC de HTTP. Para obtener información detallada, consulta los capítulos 5.1 y 5.5 del RFC 9110.

En resumen, esto significa que:

  • name debe estar compuesto por caracteres ASCII visibles y no debe estar vacío
  • value puede estar compuesto por bytes arbitrarios, siempre que se respeten las reglas de codificación específicas del encabezado y del caso de uso. value puede estar vacío

Los métodos setter de esta clase eliminan automáticamente cualquier espacio en blanco al principio o al final del valor, ya que deben ignorarse durante el procesamiento del mismo.

Combinación de valores

La mayoría de los valores de los encabezados HTTP se pueden combinar con una sola coma ',' más un espacio en blanco opcional, conservándose así el significado semántico. A modo de ejemplo, estos dos deberían ser semánticamente similares:

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

Sin embargo, hay una excepción notable a esta regla: Set-Cookie. Debido a esto y a la posibilidad de casos de uso personalizados, QHttpHeaders no combina automáticamente los valores.

Rendimiento

La mayoría de las funciones de QHttpHeaders ofrecen sobrecargas tanto de tipo « QHttpHeaders::WellKnownHeader » como de tipo « QAnyStringView ». Desde el punto de vista del uso de memoria y del cálculo, se recomienda utilizar las sobrecargas de tipo « QHttpHeaders::WellKnownHeader ».

Documentación sobre los tipos de miembros

enum class QHttpHeaders::WellKnownHeader

Lista de encabezados conocidos según el registro de la IANA.

ConstanteValor
QHttpHeaders::WellKnownHeader::AIM0
QHttpHeaders::WellKnownHeader::Accept1
QHttpHeaders::WellKnownHeader::AcceptAdditions2
QHttpHeaders::WellKnownHeader::AcceptCH3
QHttpHeaders::WellKnownHeader::AcceptDatetime4
QHttpHeaders::WellKnownHeader::AcceptEncoding5
QHttpHeaders::WellKnownHeader::AcceptFeatures6
QHttpHeaders::WellKnownHeader::AcceptLanguage7
QHttpHeaders::WellKnownHeader::AcceptPatch8
QHttpHeaders::WellKnownHeader::AcceptPost9
QHttpHeaders::WellKnownHeader::AcceptRanges10
QHttpHeaders::WellKnownHeader::AcceptSignature11
QHttpHeaders::WellKnownHeader::AccessControlAllowCredentials12
QHttpHeaders::WellKnownHeader::AccessControlAllowHeaders13
QHttpHeaders::WellKnownHeader::AccessControlAllowMethods14
QHttpHeaders::WellKnownHeader::AccessControlAllowOrigin15
QHttpHeaders::WellKnownHeader::AccessControlExposeHeaders16
QHttpHeaders::WellKnownHeader::AccessControlMaxAge17
QHttpHeaders::WellKnownHeader::AccessControlRequestHeaders18
QHttpHeaders::WellKnownHeader::AccessControlRequestMethod19
QHttpHeaders::WellKnownHeader::Age20
QHttpHeaders::WellKnownHeader::Allow21
QHttpHeaders::WellKnownHeader::ALPN22
QHttpHeaders::WellKnownHeader::AltSvc23
QHttpHeaders::WellKnownHeader::AltUsed24
QHttpHeaders::WellKnownHeader::Alternates25
QHttpHeaders::WellKnownHeader::ApplyToRedirectRef26
QHttpHeaders::WellKnownHeader::AuthenticationControl27
QHttpHeaders::WellKnownHeader::AuthenticationInfo28
QHttpHeaders::WellKnownHeader::Authorization29
QHttpHeaders::WellKnownHeader::CacheControl30
QHttpHeaders::WellKnownHeader::CacheStatus31
QHttpHeaders::WellKnownHeader::CalManagedID32
QHttpHeaders::WellKnownHeader::CalDAVTimezones33
QHttpHeaders::WellKnownHeader::CapsuleProtocol34
QHttpHeaders::WellKnownHeader::CDNCacheControl35
QHttpHeaders::WellKnownHeader::CDNLoop36
QHttpHeaders::WellKnownHeader::CertNotAfter37
QHttpHeaders::WellKnownHeader::CertNotBefore38
QHttpHeaders::WellKnownHeader::ClearSiteData39
QHttpHeaders::WellKnownHeader::ClientCert40
QHttpHeaders::WellKnownHeader::ClientCertChain41
QHttpHeaders::WellKnownHeader::Close42
QHttpHeaders::WellKnownHeader::Connection43
QHttpHeaders::WellKnownHeader::ContentDigest44
QHttpHeaders::WellKnownHeader::ContentDisposition45
QHttpHeaders::WellKnownHeader::ContentEncoding46
QHttpHeaders::WellKnownHeader::ContentID47
QHttpHeaders::WellKnownHeader::ContentLanguage48
QHttpHeaders::WellKnownHeader::ContentLength49
QHttpHeaders::WellKnownHeader::ContentLocation50
QHttpHeaders::WellKnownHeader::ContentRange51
QHttpHeaders::WellKnownHeader::ContentSecurityPolicy52
QHttpHeaders::WellKnownHeader::ContentSecurityPolicyReportOnly53
QHttpHeaders::WellKnownHeader::ContentType54
QHttpHeaders::WellKnownHeader::Cookie55
QHttpHeaders::WellKnownHeader::CrossOriginEmbedderPolicy56
QHttpHeaders::WellKnownHeader::CrossOriginEmbedderPolicyReportOnly57
QHttpHeaders::WellKnownHeader::CrossOriginOpenerPolicy58
QHttpHeaders::WellKnownHeader::CrossOriginOpenerPolicyReportOnly59
QHttpHeaders::WellKnownHeader::CrossOriginResourcePolicy60
QHttpHeaders::WellKnownHeader::DASL61
QHttpHeaders::WellKnownHeader::Date62
QHttpHeaders::WellKnownHeader::DAV63
QHttpHeaders::WellKnownHeader::DeltaBase64
QHttpHeaders::WellKnownHeader::Depth65
QHttpHeaders::WellKnownHeader::Destination66
QHttpHeaders::WellKnownHeader::DifferentialID67
QHttpHeaders::WellKnownHeader::DPoP68
QHttpHeaders::WellKnownHeader::DPoPNonce69
QHttpHeaders::WellKnownHeader::EarlyData70
QHttpHeaders::WellKnownHeader::ETag71
QHttpHeaders::WellKnownHeader::Expect72
QHttpHeaders::WellKnownHeader::ExpectCT73
QHttpHeaders::WellKnownHeader::Expires74
QHttpHeaders::WellKnownHeader::Forwarded75
QHttpHeaders::WellKnownHeader::From76
QHttpHeaders::WellKnownHeader::Hobareg77
QHttpHeaders::WellKnownHeader::Host78
QHttpHeaders::WellKnownHeader::If79
QHttpHeaders::WellKnownHeader::IfMatch80
QHttpHeaders::WellKnownHeader::IfModifiedSince81
QHttpHeaders::WellKnownHeader::IfNoneMatch82
QHttpHeaders::WellKnownHeader::IfRange83
QHttpHeaders::WellKnownHeader::IfScheduleTagMatch84
QHttpHeaders::WellKnownHeader::IfUnmodifiedSince85
QHttpHeaders::WellKnownHeader::IM86
QHttpHeaders::WellKnownHeader::IncludeReferredTokenBindingID87
QHttpHeaders::WellKnownHeader::KeepAlive88
QHttpHeaders::WellKnownHeader::Label89
QHttpHeaders::WellKnownHeader::LastEventID90
QHttpHeaders::WellKnownHeader::LastModified91
QHttpHeaders::WellKnownHeader::Link92
QHttpHeaders::WellKnownHeader::Location93
QHttpHeaders::WellKnownHeader::LockToken94
QHttpHeaders::WellKnownHeader::MaxForwards95
QHttpHeaders::WellKnownHeader::MementoDatetime96
QHttpHeaders::WellKnownHeader::Meter97
QHttpHeaders::WellKnownHeader::MIMEVersion98
QHttpHeaders::WellKnownHeader::Negotiate99
QHttpHeaders::WellKnownHeader::NEL100
QHttpHeaders::WellKnownHeader::ODataEntityId101
QHttpHeaders::WellKnownHeader::ODataIsolation102
QHttpHeaders::WellKnownHeader::ODataMaxVersion103
QHttpHeaders::WellKnownHeader::ODataVersion104
QHttpHeaders::WellKnownHeader::OptionalWWWAuthenticate105
QHttpHeaders::WellKnownHeader::OrderingType106
QHttpHeaders::WellKnownHeader::Origin107
QHttpHeaders::WellKnownHeader::OriginAgentCluster108
QHttpHeaders::WellKnownHeader::OSCORE109
QHttpHeaders::WellKnownHeader::OSLCCoreVersion110
QHttpHeaders::WellKnownHeader::Overwrite111
QHttpHeaders::WellKnownHeader::PingFrom112
QHttpHeaders::WellKnownHeader::PingTo113
QHttpHeaders::WellKnownHeader::Position114
QHttpHeaders::WellKnownHeader::Prefer115
QHttpHeaders::WellKnownHeader::PreferenceApplied116
QHttpHeaders::WellKnownHeader::Priority117
QHttpHeaders::WellKnownHeader::ProxyAuthenticate118
QHttpHeaders::WellKnownHeader::ProxyAuthenticationInfo119
QHttpHeaders::WellKnownHeader::ProxyAuthorization120
QHttpHeaders::WellKnownHeader::ProxyStatus121
QHttpHeaders::WellKnownHeader::PublicKeyPins122
QHttpHeaders::WellKnownHeader::PublicKeyPinsReportOnly123
QHttpHeaders::WellKnownHeader::Range124
QHttpHeaders::WellKnownHeader::RedirectRef125
QHttpHeaders::WellKnownHeader::Referer126
QHttpHeaders::WellKnownHeader::Refresh127
QHttpHeaders::WellKnownHeader::ReplayNonce128
QHttpHeaders::WellKnownHeader::ReprDigest129
QHttpHeaders::WellKnownHeader::RetryAfter130
QHttpHeaders::WellKnownHeader::ScheduleReply131
QHttpHeaders::WellKnownHeader::ScheduleTag132
QHttpHeaders::WellKnownHeader::SecPurpose133
QHttpHeaders::WellKnownHeader::SecTokenBinding134
QHttpHeaders::WellKnownHeader::SecWebSocketAccept135
QHttpHeaders::WellKnownHeader::SecWebSocketExtensions136
QHttpHeaders::WellKnownHeader::SecWebSocketKey137
QHttpHeaders::WellKnownHeader::SecWebSocketProtocol138
QHttpHeaders::WellKnownHeader::SecWebSocketVersion139
QHttpHeaders::WellKnownHeader::Server140
QHttpHeaders::WellKnownHeader::ServerTiming141
QHttpHeaders::WellKnownHeader::SetCookie142
QHttpHeaders::WellKnownHeader::Signature143
QHttpHeaders::WellKnownHeader::SignatureInput144
QHttpHeaders::WellKnownHeader::SLUG145
QHttpHeaders::WellKnownHeader::SoapAction146
QHttpHeaders::WellKnownHeader::StatusURI147
QHttpHeaders::WellKnownHeader::StrictTransportSecurity148
QHttpHeaders::WellKnownHeader::Sunset149
QHttpHeaders::WellKnownHeader::SurrogateCapability150
QHttpHeaders::WellKnownHeader::SurrogateControl151
QHttpHeaders::WellKnownHeader::TCN152
QHttpHeaders::WellKnownHeader::TE153
QHttpHeaders::WellKnownHeader::Timeout154
QHttpHeaders::WellKnownHeader::Topic155
QHttpHeaders::WellKnownHeader::Traceparent156
QHttpHeaders::WellKnownHeader::Tracestate157
QHttpHeaders::WellKnownHeader::Trailer158
QHttpHeaders::WellKnownHeader::TransferEncoding159
QHttpHeaders::WellKnownHeader::TTL160
QHttpHeaders::WellKnownHeader::Upgrade161
QHttpHeaders::WellKnownHeader::Urgency162
QHttpHeaders::WellKnownHeader::UserAgent163
QHttpHeaders::WellKnownHeader::VariantVary164
QHttpHeaders::WellKnownHeader::Vary165
QHttpHeaders::WellKnownHeader::Via166
QHttpHeaders::WellKnownHeader::WantContentDigest167
QHttpHeaders::WellKnownHeader::WantReprDigest168
QHttpHeaders::WellKnownHeader::WWWAuthenticate169
QHttpHeaders::WellKnownHeader::XContentTypeOptions170
QHttpHeaders::WellKnownHeader::XFrameOptions171
QHttpHeaders::WellKnownHeader::AcceptCharset172
QHttpHeaders::WellKnownHeader::CPEPInfo173
QHttpHeaders::WellKnownHeader::Pragma174
QHttpHeaders::WellKnownHeader::ProtocolInfo175
QHttpHeaders::WellKnownHeader::ProtocolQuery176

Documentación de las funciones de los miembros

[noexcept] QHttpHeaders::QHttpHeaders()

Crea un nuevo objeto QHttpHeaders.

QHttpHeaders::QHttpHeaders(const QHttpHeaders &other)

Crea una copia de other.

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

Crea el objeto mediante la construcción por movimiento a partir de other, que quedará en empty.

[noexcept] QHttpHeaders::~QHttpHeaders()

Elimina el objeto «headers».

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

Añade una entrada de encabezado con name y value y devuelve true si la operación se realiza correctamente.

Véase también append(QHttpHeaders::WellKnownHeader, QAnyStringView) y Allowed field name and value characters.

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

Esta función sobrescribe la función « QHttpHeaders::append » (QAnyStringView, QAnyStringView).

void QHttpHeaders::clear()

Borra todas las entradas de la cabecera.

Véase también ` size()`.

QByteArray QHttpHeaders::combinedValue(QAnyStringView name) const

Devuelve los valores del encabezado « name » en una cadena separada por comas. Devuelve un « null » QByteArray si el encabezado con name no existe.

Nota: Es posible queacceder a los valores del encabezado «Set-Cookie» de esta forma no funcione como se espera. Se trata de una excepción notable en el RFC de HTTP, ya que sus valores no pueden combinarse de esta manera. Es preferible utilizar values() en su lugar.

Véase también values(QAnyStringView).

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

Esta función sobrecarga la función « QHttpHeaders::combinedValue » (QAnyStringView).

bool QHttpHeaders::contains(QAnyStringView name) const

Devuelve si los encabezados contienen un encabezado con el valor « name ».

Véase también « contains » (QHttpHeaders::WellKnownHeader).

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

Esta función sobrescribe QHttpHeaders::has(QAnyStringView).

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

Convierte el primer valor de encabezado encontrado de « name » en un objeto « QDateTime », siguiendo los formatos de fecha estándar de HTTP. Si el encabezado no existe o contiene un « QDateTime » no válido, devuelve « std::nullopt ».

Esta función se introdujo en Qt 6.10.

Véase también setDateTimeValue(), dateTimeValues(QAnyStringView name) y dateTimeValueAt(qsizetype i).

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

Esta función sobrescribe la función « QHttpHeaders::dateTimeValue » (QAnyStringView).

Esta función se introdujo en Qt 6.10.

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

Convierte el valor del encabezado en el índice i en un objeto QDateTime siguiendo los formatos de fecha estándar de HTTP. El índice i debe ser válido.

Esta función se introdujo en Qt 6.10.

Véase también dateTimeValue(nombre de QAnyStringView) y dateTimeValues(nombre de QAnyStringView).

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

Devuelve todos los valores de los encabezados de name en una lista de objetos QDateTime, siguiendo los formatos de fecha estándar de HTTP. Si no se encuentran valores de fecha y hora válidos, devuelve std::nullopt.

Esta función se introdujo en Qt 6.10.

Véase también dateTimeValue(QAnyStringView name) y dateTimeValueAt(qsizetype i).

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

Esta función sobrecarga la función « QHttpHeaders::dateTimeValues » (QAnyStringView).

Esta función se introdujo en Qt 6.10.

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

Crea un nuevo objeto ` QHttpHeaders ` que se rellena con ` headers`.

Véase también Allowed field name and value characters.

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

Crea un nuevo objeto ` QHttpHeaders ` que se rellena con ` headers`.

Véase también Allowed field name and value characters.

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

Crea un nuevo objeto ` QHttpHeaders ` que se rellena con ` headers`.

Véase también Allowed field name and value characters.

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

Inserta una entrada de encabezado en el índice i, con name y value. El índice debe ser válido (véase size()). Devuelve si la inserción se ha realizado correctamente.

Véase también append(), insert(qsizetype, QHttpHeaders::WellKnownHeader, QAnyStringView), size() y Allowed field name and value characters.

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

Esta función sobrescribe la función « QHttpHeaders::insert » (qsizetype, QAnyStringView, QAnyStringView).

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

Devuelve el valor del primer encabezado válido name interpretado como un entero de 64 bits. Si el encabezado no existe o no se puede analizar como un entero, devuelve std::nullopt.

Esta función se introdujo en Qt 6.10.

Véase también intValues(QAnyStringView name) y intValueAt(qsizetype i).

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

Esta función sobrescribe la función « QHttpHeaders::intValue » (QAnyStringView).

Esta función se introdujo en Qt 6.10.

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

Devuelve el valor del encabezado, interpretado como un entero de 64 bits, en el índice i. El índice i debe ser válido.

Esta función se introdujo en Qt 6.10.

Véase también intValues(nombre de QAnyStringView) y intValue(nombre de QAnyStringView).

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

Devuelve los valores de la cabecera « name », interpretados como enteros de 64 bits, en una lista. Si la cabecera no existe o no se puede analizar como un entero, devuelve « std::nullopt ».

Esta función se introdujo en Qt 6.10.

Véase también intValue(QAnyStringView name) y intValueAt(qsizetype i).

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

Esta función sobrescribe la función ` QHttpHeaders::intValues` (QAnyStringView).

Esta función se introdujo en Qt 6.10.

[noexcept] bool QHttpHeaders::isEmpty() const

Devuelve ` true ` si los encabezados tienen tamaño 0; en caso contrario, devuelve ` false`.

Véase también size().

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

Devuelve el nombre del encabezado en el índice i. El índice i debe ser válido (véase size()).

Los nombres de los encabezados no distinguen entre mayúsculas y minúsculas, y los nombres devueltos se muestran en minúsculas.

Véase también size() y valueAt().

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

Devuelve los rangos de los campos del encabezado HTTP « Range », o « std::nullopt » si el análisis ha fallado.

Cada rango representa un rango de bytes. Según el RFC 9110:

  • Si se especifica el inicio pero no el final (p. ej., «bytes=500-»), el campo « QHttpHeaderRangeSpec » tendrá los valores « start=500 » y « end=std::nullopt ».
  • Si se especifica el final pero no el inicio (p. ej., «bytes=-500»), el « QHttpHeaderRangeSpec » tendrá start=std::nullopt y end=500, lo que representa los últimos 500 bytes.
  • Si se especifican ambos (p. ej., «bytes=0-499»), el QHttpHeaderRangeSpec tendrá start=0 y end=499.

Los rangos se devuelven en el orden en que aparecen en los encabezados.

El análisis se realiza de la siguiente manera:

  • Si no hay ningún encabezado « Range », se devuelve un conjunto de rangos vacío.
  • Según la sección 14.2 de la RFC 9110, se ignora cualquier encabezado « Range » que contenga una unidad distinta de «bytes» (por ejemplo, «seconds=1-2»). Estos encabezados ignorados no provocan que el análisis falle.
  • Si un encabezado « Range » utiliza la unidad «bytes» pero tiene un formato incorrecto (por ejemplo, le falta el guion, contiene caracteres no válidos o números no válidos), la función devuelve « std::nullopt ».

Esta función se introdujo en Qt 6.12.

Véase también « setRangeValues » y « WellKnownHeader::Range ».

void QHttpHeaders::removeAll(QAnyStringView name)

Elimina el encabezado « name ».

Véase también removeAt() y removeAll(QHttpHeaders::WellKnownHeader).

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

Esta función sobrecarga el método « QHttpHeaders::removeAll » (QAnyStringView).

void QHttpHeaders::removeAt(qsizetype i)

Elimina el encabezado en el índice i. El índice i debe ser válido (véase size()).

Véase también removeAll(QHttpHeaders::WellKnownHeader), removeAll(QAnyStringView) y size().

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

Sustituye la entrada del encabezado en el índice i por name y newValue. El índice debe ser válido (véase size()). Devuelve si la sustitución se ha realizado correctamente.

Véase también append(), replace(qsizetype, QHttpHeaders::WellKnownHeader, QAnyStringView), size() y Allowed field name and value characters.

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

Esta función sobrescribe « QHttpHeaders::replace » (qsizetype, QAnyStringView, QAnyStringView).

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

Si « QHttpHeaders » ya contiene « name », sustituye su valor por « newValue » y elimina las posibles entradas adicionales de « name ». Si « name » no existía, añade una nueva entrada. Devuelve « true » si la operación se realiza correctamente.

Esta función es un método práctico para establecer un encabezado único ` name `: ` newValue `. Para la mayoría de los encabezados, el orden relativo no importa, lo que permite reutilizar una entrada existente si hay alguna.

Esta función se introdujo en Qt 6.8.

Véase también replaceOrAppend(QAnyStringView, QAnyStringView).

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

Esta función sobrescribe QHttpHeaders::replaceOrAppend(WellKnownHeader, QAnyStringView).

void QHttpHeaders::reserve(qsizetype size)

Intenta asignar memoria para al menos size entradas de encabezado.

Si sabes de antemano cuántas entradas de encabezado habrá, puedes llamar a esta función para evitar reasignaciones y la fragmentación de la memoria.

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

Establece el valor del nombre de encabezado « name » en « dateTime », siguiendo el formato estándar HTTP IMF-fixdate. Si el encabezado no existe, añade uno nuevo.

Esta función se introdujo en Qt 6.10.

Véase también « dateTimeValue» (nombre de QAnyStringView) y « dateTimeValueAt » (qsizetype i).

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

Esta función sobrescribe QHttpHeaders::setDateTimeValue(QAnyStringView).

Esta función se introdujo en Qt 6.10.

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

Establece el campo de encabezado HTTP « Range » con la lista especificada de « ranges ».

Los rangos se formatean utilizando la unidad «bytes», en el orden en que los contiene ranges. Para cada QHttpHeaderRangeSpec:

  • Un rango que solo tenga un inicio (p. ej., QHttpHeaderRangeSpec(500, std::nullopt)) se formatea como "500-".
  • Un rango que solo tiene un final (p. ej., QHttpHeaderRangeSpec(std::nullopt, 500)) se formatea como "-500", lo que representa los últimos 500 bytes.
  • Un rango con punto inicial y final (p. ej., QHttpHeaderRangeSpec(0, 499)) se formatea como "0-499".

Si se proporcionan varios rangos, se unirán mediante comas, por ejemplo: "bytes=0-499, 1000-".

Si « ranges » está vacío, se elimina el encabezado « Range ».

Esta función se introdujo en Qt 6.12.

Véase también rangeValues() y WellKnownHeader::Range.

[noexcept] qsizetype QHttpHeaders::size() const

Devuelve el número de entradas de la cabecera.

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

Cambia esta dirección QHttpHeaders por other. Esta operación es muy rápida y nunca falla.

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

Devuelve las entradas de la cabecera como una lista de pares (nombre, valor). Los nombres de las cabeceras no distinguen entre mayúsculas y minúsculas, y los nombres devueltos se escriben en minúsculas.

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

Devuelve las entradas de los encabezados en forma de hash, con el nombre como clave y los valores correspondientes. Los nombres de los encabezados no distinguen entre mayúsculas y minúsculas, y los nombres devueltos se escriben en minúsculas.

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

Devuelve las entradas de los encabezados en forma de mapa en el que cada clave corresponde a uno o varios valores. Los nombres de los encabezados no distinguen entre mayúsculas y minúsculas, y los nombres devueltos se muestran en minúsculas.

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

Devuelve el valor del (primer) encabezado name, o defaultValue si no existe.

Véase también value(QHttpHeaders::WellKnownHeader, QByteArrayView).

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

Esta función sobrescribe « QHttpHeaders::value » (QAnyStringView, QByteArrayView).

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

Devuelve el valor del encabezado en el índice i. El índice i debe ser válido (véase size()).

Véase también size(), value(), values(), combinedValue() y nameAt().

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

Devuelve los valores del encabezado name en una lista. Devuelve una lista vacía si no existe el encabezado con name.

Véase también values(QHttpHeaders::WellKnownHeader).

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

Esta función sobrecarga el método ` QHttpHeaders::values` (QAnyStringView).

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

Devuelve el nombre de una cabecera correspondiente a la « name » proporcionada como vista.

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

La asignación por valor other y devuelve una referencia a este objeto.

other empty quedará sin modificar.

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

Asigna el contenido de ` other ` y devuelve una referencia a este objeto.

Elementos no miembros relacionados

[since 6.12] QDataStream &operator<<(QDataStream &out, const QHttpHeaders &headers)

Escribe ` headers ` en el flujo ` out `.

Esta función se introdujo en Qt 6.12.

Véase también «Serialización detipos de datos de Qt».

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

Escribe « headers » en el flujo « debug ».

[since 6.12] QDataStream &operator>>(QDataStream &in, QHttpHeaders &headers)

Lee los encabezados del flujo « in » y los guarda en « headers ».

Esta función se introdujo en Qt 6.12.

Véase también «Serialización detipos de datos de Qt».

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.