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) |
Elementos no miembros relacionados
(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:
namedebe estar compuesto por caracteres ASCII visibles y no debe estar vacíovaluepuede estar compuesto por bytes arbitrarios, siempre que se respeten las reglas de codificación específicas del encabezado y del caso de uso.valuepuede 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, myheadervalue2Sin 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.
| Constante | Valor |
|---|---|
QHttpHeaders::WellKnownHeader::AIM | 0 |
QHttpHeaders::WellKnownHeader::Accept | 1 |
QHttpHeaders::WellKnownHeader::AcceptAdditions | 2 |
QHttpHeaders::WellKnownHeader::AcceptCH | 3 |
QHttpHeaders::WellKnownHeader::AcceptDatetime | 4 |
QHttpHeaders::WellKnownHeader::AcceptEncoding | 5 |
QHttpHeaders::WellKnownHeader::AcceptFeatures | 6 |
QHttpHeaders::WellKnownHeader::AcceptLanguage | 7 |
QHttpHeaders::WellKnownHeader::AcceptPatch | 8 |
QHttpHeaders::WellKnownHeader::AcceptPost | 9 |
QHttpHeaders::WellKnownHeader::AcceptRanges | 10 |
QHttpHeaders::WellKnownHeader::AcceptSignature | 11 |
QHttpHeaders::WellKnownHeader::AccessControlAllowCredentials | 12 |
QHttpHeaders::WellKnownHeader::AccessControlAllowHeaders | 13 |
QHttpHeaders::WellKnownHeader::AccessControlAllowMethods | 14 |
QHttpHeaders::WellKnownHeader::AccessControlAllowOrigin | 15 |
QHttpHeaders::WellKnownHeader::AccessControlExposeHeaders | 16 |
QHttpHeaders::WellKnownHeader::AccessControlMaxAge | 17 |
QHttpHeaders::WellKnownHeader::AccessControlRequestHeaders | 18 |
QHttpHeaders::WellKnownHeader::AccessControlRequestMethod | 19 |
QHttpHeaders::WellKnownHeader::Age | 20 |
QHttpHeaders::WellKnownHeader::Allow | 21 |
QHttpHeaders::WellKnownHeader::ALPN | 22 |
QHttpHeaders::WellKnownHeader::AltSvc | 23 |
QHttpHeaders::WellKnownHeader::AltUsed | 24 |
QHttpHeaders::WellKnownHeader::Alternates | 25 |
QHttpHeaders::WellKnownHeader::ApplyToRedirectRef | 26 |
QHttpHeaders::WellKnownHeader::AuthenticationControl | 27 |
QHttpHeaders::WellKnownHeader::AuthenticationInfo | 28 |
QHttpHeaders::WellKnownHeader::Authorization | 29 |
QHttpHeaders::WellKnownHeader::CacheControl | 30 |
QHttpHeaders::WellKnownHeader::CacheStatus | 31 |
QHttpHeaders::WellKnownHeader::CalManagedID | 32 |
QHttpHeaders::WellKnownHeader::CalDAVTimezones | 33 |
QHttpHeaders::WellKnownHeader::CapsuleProtocol | 34 |
QHttpHeaders::WellKnownHeader::CDNCacheControl | 35 |
QHttpHeaders::WellKnownHeader::CDNLoop | 36 |
QHttpHeaders::WellKnownHeader::CertNotAfter | 37 |
QHttpHeaders::WellKnownHeader::CertNotBefore | 38 |
QHttpHeaders::WellKnownHeader::ClearSiteData | 39 |
QHttpHeaders::WellKnownHeader::ClientCert | 40 |
QHttpHeaders::WellKnownHeader::ClientCertChain | 41 |
QHttpHeaders::WellKnownHeader::Close | 42 |
QHttpHeaders::WellKnownHeader::Connection | 43 |
QHttpHeaders::WellKnownHeader::ContentDigest | 44 |
QHttpHeaders::WellKnownHeader::ContentDisposition | 45 |
QHttpHeaders::WellKnownHeader::ContentEncoding | 46 |
QHttpHeaders::WellKnownHeader::ContentID | 47 |
QHttpHeaders::WellKnownHeader::ContentLanguage | 48 |
QHttpHeaders::WellKnownHeader::ContentLength | 49 |
QHttpHeaders::WellKnownHeader::ContentLocation | 50 |
QHttpHeaders::WellKnownHeader::ContentRange | 51 |
QHttpHeaders::WellKnownHeader::ContentSecurityPolicy | 52 |
QHttpHeaders::WellKnownHeader::ContentSecurityPolicyReportOnly | 53 |
QHttpHeaders::WellKnownHeader::ContentType | 54 |
QHttpHeaders::WellKnownHeader::Cookie | 55 |
QHttpHeaders::WellKnownHeader::CrossOriginEmbedderPolicy | 56 |
QHttpHeaders::WellKnownHeader::CrossOriginEmbedderPolicyReportOnly | 57 |
QHttpHeaders::WellKnownHeader::CrossOriginOpenerPolicy | 58 |
QHttpHeaders::WellKnownHeader::CrossOriginOpenerPolicyReportOnly | 59 |
QHttpHeaders::WellKnownHeader::CrossOriginResourcePolicy | 60 |
QHttpHeaders::WellKnownHeader::DASL | 61 |
QHttpHeaders::WellKnownHeader::Date | 62 |
QHttpHeaders::WellKnownHeader::DAV | 63 |
QHttpHeaders::WellKnownHeader::DeltaBase | 64 |
QHttpHeaders::WellKnownHeader::Depth | 65 |
QHttpHeaders::WellKnownHeader::Destination | 66 |
QHttpHeaders::WellKnownHeader::DifferentialID | 67 |
QHttpHeaders::WellKnownHeader::DPoP | 68 |
QHttpHeaders::WellKnownHeader::DPoPNonce | 69 |
QHttpHeaders::WellKnownHeader::EarlyData | 70 |
QHttpHeaders::WellKnownHeader::ETag | 71 |
QHttpHeaders::WellKnownHeader::Expect | 72 |
QHttpHeaders::WellKnownHeader::ExpectCT | 73 |
QHttpHeaders::WellKnownHeader::Expires | 74 |
QHttpHeaders::WellKnownHeader::Forwarded | 75 |
QHttpHeaders::WellKnownHeader::From | 76 |
QHttpHeaders::WellKnownHeader::Hobareg | 77 |
QHttpHeaders::WellKnownHeader::Host | 78 |
QHttpHeaders::WellKnownHeader::If | 79 |
QHttpHeaders::WellKnownHeader::IfMatch | 80 |
QHttpHeaders::WellKnownHeader::IfModifiedSince | 81 |
QHttpHeaders::WellKnownHeader::IfNoneMatch | 82 |
QHttpHeaders::WellKnownHeader::IfRange | 83 |
QHttpHeaders::WellKnownHeader::IfScheduleTagMatch | 84 |
QHttpHeaders::WellKnownHeader::IfUnmodifiedSince | 85 |
QHttpHeaders::WellKnownHeader::IM | 86 |
QHttpHeaders::WellKnownHeader::IncludeReferredTokenBindingID | 87 |
QHttpHeaders::WellKnownHeader::KeepAlive | 88 |
QHttpHeaders::WellKnownHeader::Label | 89 |
QHttpHeaders::WellKnownHeader::LastEventID | 90 |
QHttpHeaders::WellKnownHeader::LastModified | 91 |
QHttpHeaders::WellKnownHeader::Link | 92 |
QHttpHeaders::WellKnownHeader::Location | 93 |
QHttpHeaders::WellKnownHeader::LockToken | 94 |
QHttpHeaders::WellKnownHeader::MaxForwards | 95 |
QHttpHeaders::WellKnownHeader::MementoDatetime | 96 |
QHttpHeaders::WellKnownHeader::Meter | 97 |
QHttpHeaders::WellKnownHeader::MIMEVersion | 98 |
QHttpHeaders::WellKnownHeader::Negotiate | 99 |
QHttpHeaders::WellKnownHeader::NEL | 100 |
QHttpHeaders::WellKnownHeader::ODataEntityId | 101 |
QHttpHeaders::WellKnownHeader::ODataIsolation | 102 |
QHttpHeaders::WellKnownHeader::ODataMaxVersion | 103 |
QHttpHeaders::WellKnownHeader::ODataVersion | 104 |
QHttpHeaders::WellKnownHeader::OptionalWWWAuthenticate | 105 |
QHttpHeaders::WellKnownHeader::OrderingType | 106 |
QHttpHeaders::WellKnownHeader::Origin | 107 |
QHttpHeaders::WellKnownHeader::OriginAgentCluster | 108 |
QHttpHeaders::WellKnownHeader::OSCORE | 109 |
QHttpHeaders::WellKnownHeader::OSLCCoreVersion | 110 |
QHttpHeaders::WellKnownHeader::Overwrite | 111 |
QHttpHeaders::WellKnownHeader::PingFrom | 112 |
QHttpHeaders::WellKnownHeader::PingTo | 113 |
QHttpHeaders::WellKnownHeader::Position | 114 |
QHttpHeaders::WellKnownHeader::Prefer | 115 |
QHttpHeaders::WellKnownHeader::PreferenceApplied | 116 |
QHttpHeaders::WellKnownHeader::Priority | 117 |
QHttpHeaders::WellKnownHeader::ProxyAuthenticate | 118 |
QHttpHeaders::WellKnownHeader::ProxyAuthenticationInfo | 119 |
QHttpHeaders::WellKnownHeader::ProxyAuthorization | 120 |
QHttpHeaders::WellKnownHeader::ProxyStatus | 121 |
QHttpHeaders::WellKnownHeader::PublicKeyPins | 122 |
QHttpHeaders::WellKnownHeader::PublicKeyPinsReportOnly | 123 |
QHttpHeaders::WellKnownHeader::Range | 124 |
QHttpHeaders::WellKnownHeader::RedirectRef | 125 |
QHttpHeaders::WellKnownHeader::Referer | 126 |
QHttpHeaders::WellKnownHeader::Refresh | 127 |
QHttpHeaders::WellKnownHeader::ReplayNonce | 128 |
QHttpHeaders::WellKnownHeader::ReprDigest | 129 |
QHttpHeaders::WellKnownHeader::RetryAfter | 130 |
QHttpHeaders::WellKnownHeader::ScheduleReply | 131 |
QHttpHeaders::WellKnownHeader::ScheduleTag | 132 |
QHttpHeaders::WellKnownHeader::SecPurpose | 133 |
QHttpHeaders::WellKnownHeader::SecTokenBinding | 134 |
QHttpHeaders::WellKnownHeader::SecWebSocketAccept | 135 |
QHttpHeaders::WellKnownHeader::SecWebSocketExtensions | 136 |
QHttpHeaders::WellKnownHeader::SecWebSocketKey | 137 |
QHttpHeaders::WellKnownHeader::SecWebSocketProtocol | 138 |
QHttpHeaders::WellKnownHeader::SecWebSocketVersion | 139 |
QHttpHeaders::WellKnownHeader::Server | 140 |
QHttpHeaders::WellKnownHeader::ServerTiming | 141 |
QHttpHeaders::WellKnownHeader::SetCookie | 142 |
QHttpHeaders::WellKnownHeader::Signature | 143 |
QHttpHeaders::WellKnownHeader::SignatureInput | 144 |
QHttpHeaders::WellKnownHeader::SLUG | 145 |
QHttpHeaders::WellKnownHeader::SoapAction | 146 |
QHttpHeaders::WellKnownHeader::StatusURI | 147 |
QHttpHeaders::WellKnownHeader::StrictTransportSecurity | 148 |
QHttpHeaders::WellKnownHeader::Sunset | 149 |
QHttpHeaders::WellKnownHeader::SurrogateCapability | 150 |
QHttpHeaders::WellKnownHeader::SurrogateControl | 151 |
QHttpHeaders::WellKnownHeader::TCN | 152 |
QHttpHeaders::WellKnownHeader::TE | 153 |
QHttpHeaders::WellKnownHeader::Timeout | 154 |
QHttpHeaders::WellKnownHeader::Topic | 155 |
QHttpHeaders::WellKnownHeader::Traceparent | 156 |
QHttpHeaders::WellKnownHeader::Tracestate | 157 |
QHttpHeaders::WellKnownHeader::Trailer | 158 |
QHttpHeaders::WellKnownHeader::TransferEncoding | 159 |
QHttpHeaders::WellKnownHeader::TTL | 160 |
QHttpHeaders::WellKnownHeader::Upgrade | 161 |
QHttpHeaders::WellKnownHeader::Urgency | 162 |
QHttpHeaders::WellKnownHeader::UserAgent | 163 |
QHttpHeaders::WellKnownHeader::VariantVary | 164 |
QHttpHeaders::WellKnownHeader::Vary | 165 |
QHttpHeaders::WellKnownHeader::Via | 166 |
QHttpHeaders::WellKnownHeader::WantContentDigest | 167 |
QHttpHeaders::WellKnownHeader::WantReprDigest | 168 |
QHttpHeaders::WellKnownHeader::WWWAuthenticate | 169 |
QHttpHeaders::WellKnownHeader::XContentTypeOptions | 170 |
QHttpHeaders::WellKnownHeader::XFrameOptions | 171 |
QHttpHeaders::WellKnownHeader::AcceptCharset | 172 |
QHttpHeaders::WellKnownHeader::CPEPInfo | 173 |
QHttpHeaders::WellKnownHeader::Pragma | 174 |
QHttpHeaders::WellKnownHeader::ProtocolInfo | 175 |
QHttpHeaders::WellKnownHeader::ProtocolQuery | 176 |
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::nulloptyend=500, lo que representa los últimos 500 bytes. - Si se especifican ambos (p. ej., «bytes=0-499»), el QHttpHeaderRangeSpec tendrá
start=0yend=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.