QHttpHeaders Class

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

Documentación de la función de miembro

[noexcept] QHttpHeaders::QHttpHeaders()

Crea un nuevo objeto QHttpHeaders.

QHttpHeaders::QHttpHeaders(const QHttpHeaders &other)

Crea una copia de other.

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

Mover-construye el objeto a partir de other, que quedará empty.

[noexcept] QHttpHeaders::~QHttpHeaders()

Elimina el objeto headers.

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

Añade una entrada de cabecera con name y value y devuelve true si tiene éxito.

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

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

void QHttpHeaders::clear()

Borra todas las entradas de la cabecera.

Véase también size().

QByteArray QHttpHeaders::combinedValue(QAnyStringView name) const

Devuelve los valores de la cabecera name en una cadena combinada por comas. Devuelve un null QByteArray si la cabecera con name no existe.

Ver también values(QAnyStringView).

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

bool QHttpHeaders::contains(QAnyStringView name) const

Devuelve si las cabeceras contienen cabecera con name.

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

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

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

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

Esta función se introdujo en Qt 6.10.

Ver también setDateTimeValue(), dateTimeValues(QAnyStringView nombre), y dateTimeValueAt(qsizetype i).

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

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 a un objeto QDateTime siguiendo los formatos de fecha HTTP estándar. El índice i debe ser válido.

Esta función se introdujo en Qt 6.10.

Ver también dateTimeValue(QAnyStringView nombre) y dateTimeValues(QAnyStringView nombre).

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

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

Esta función se introdujo en Qt 6.10.

Ver 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 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 cabecera 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)

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

Devuelve el valor de la primera cabecera válida name interpretada como un entero de 64 bits. Si la cabecera no existe o no puede ser interpretada 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 se introdujo en Qt 6.10.

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

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

Esta función se introdujo en Qt 6.10.

Ver también intValues(QAnyStringView nombre) y intValue(QAnyStringView nombre).

[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 puede ser interpretada 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 se introdujo en Qt 6.10.

[noexcept] bool QHttpHeaders::isEmpty() const

Devuelve true si las cabeceras tienen tamaño 0; en caso contrario devuelve false.

Véase también size().

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

Devuelve el nombre de la cabecera en el índice i. El índice i debe ser válido (véase size()).

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

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

void QHttpHeaders::removeAll(QAnyStringView name)

Elimina el encabezado name.

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

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

void QHttpHeaders::removeAt(qsizetype i)

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

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

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

Sustituye la entrada de la cabecera 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.

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

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

Si QHttpHeaders ya contiene name, sustituye su valor por newValue y elimina posibles entradas adicionales de name. Si name no existía, añade una nueva entrada. Devuelve true si tiene éxito.

Esta función es un método práctico para establecer una única cabecera name: newValue. Para la mayoría de las cabeceras el orden relativo no importa, lo que permite reutilizar una entrada existente si existe.

Esta función se introdujo en Qt 6.8.

Ver también replaceOrAppend(QAnyStringView, QAnyStringView).

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

void QHttpHeaders::reserve(qsizetype size)

Intenta asignar memoria para al menos size entradas de cabecera.

Si sabe de antemano cuántas entradas de cabecera habrá, puede llamar a esta función para evitar reasignaciones y fragmentación de memoria.

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

Establece el valor del nombre de la cabecera name a dateTime, siguiendo el formato estándar HTTP IMF-fixdate. Si la cabecera no existe, añade una nueva.

Esta función se introdujo en Qt 6.10.

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

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

Esta función se introdujo en Qt 6.10.

[noexcept] qsizetype QHttpHeaders::size() const

Devuelve el número de entradas de cabecera.

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

Cambia este 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 cabecera como una lista de pares (nombre, valor). Los nombres de cabecera no distinguen entre mayúsculas y minúsculas, y los nombres devueltos están en minúsculas.

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

Devuelve las entradas de cabecera como un hash de nombre a valor(es). Los nombres de cabecera no distinguen entre mayúsculas y minúsculas, y los nombres devueltos están en minúsculas.

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

Devuelve las entradas de encabezado como un mapa de nombre a valor(es). Los nombres de cabecera no distinguen entre mayúsculas y minúsculas, y los nombres devueltos se escriben en minúsculas.

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

Devuelve el valor de la (primera) cabecera name, o defaultValue si no existe.

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

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

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

Devuelve el valor de la cabecera 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 de la cabecera name en una lista. Devuelve una lista vacía si la cabecera con name no existe.

Ver también values(QHttpHeaders::WellKnownHeader).

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

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

Devuelve un nombre de cabecera correspondiente a la name proporcionada como vista.

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

Move-asigna other y devuelve una referencia a este objeto.

other se dejará empty.

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

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