QHttpHeaders Class

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

Fonction membre Documentation

[noexcept] QHttpHeaders::QHttpHeaders()

Crée un nouvel objet QHttpHeaders.

QHttpHeaders::QHttpHeaders(const QHttpHeaders &other)

Crée une copie de other.

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

Move-construit l'objet à partir de other, qui sera laissé à empty.

[noexcept] QHttpHeaders::~QHttpHeaders()

Se débarrasse de l'objet "headers".

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

Ajoute une entrée d'en-tête avec name et value et renvoie true en cas de succès.

Voir aussi append(QHttpHeaders::WellKnownHeader, QAnyStringView) et Allowed field name and value characters.

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

void QHttpHeaders::clear()

Efface toutes les entrées d'en-tête.

Voir aussi size().

QByteArray QHttpHeaders::combinedValue(QAnyStringView name) const

Renvoie les valeurs de l'en-tête name dans une chaîne de caractères combinée par des virgules. Renvoie une adresse null QByteArray si l'en-tête name n'existe pas.

Voir aussi values(QAnyStringView).

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

bool QHttpHeaders::contains(QAnyStringView name) const

Retourne si les en-têtes contiennent un en-tête avec name.

Voir aussi contains(QHttpHeaders::WellKnownHeader).

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

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

Convertit la première valeur d'en-tête trouvée de name en un objet QDateTime, en respectant les formats de date HTTP standard. Si l'en-tête n'existe pas ou contient un QDateTime invalide, elle renvoie std::nullopt.

Cette fonction a été introduite dans Qt 6.10.

Voir aussi setDateTimeValue(), dateTimeValues(QAnyStringView name), et dateTimeValueAt(qsizetype i).

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

Cette fonction a été introduite dans Qt 6.10.

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

Convertit la valeur de l'en-tête à l'index i en un objet QDateTime en respectant les formats de date HTTP standard. L'index i doit être valide.

Cette fonction a été introduite dans Qt 6.10.

Voir aussi dateTimeValue(QAnyStringView name) et dateTimeValues(QAnyStringView name).

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

Renvoie toutes les valeurs d'en-tête de name dans une liste d'objets QDateTime, en respectant les formats de date HTTP standard. Si aucune valeur de date et d'heure valide n'est trouvée, elle renvoie std::nullopt.

Cette fonction a été introduite dans Qt 6.10.

Voir aussi dateTimeValue(QAnyStringView name) et dateTimeValueAt(qsizetype i).

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

Cette fonction a été introduite dans Qt 6.10.

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

Crée un nouvel objet QHttpHeaders qui est alimenté par headers.

Voir aussi Allowed field name and value characters.

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

Crée un nouvel objet QHttpHeaders qui est alimenté par headers.

Voir aussi Allowed field name and value characters.

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

Crée un nouvel objet QHttpHeaders qui est alimenté par headers.

Voir aussi Allowed field name and value characters.

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

Insère une entrée d'en-tête à l'index i, avec name et value. L'index doit être valide (voir size()). Retourne si l'insertion a réussi.

Voir aussi append(), insert(qsizetype, QHttpHeaders::WellKnownHeader, QAnyStringView), size(), et 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

Renvoie la valeur du premier en-tête valide name interprété comme un entier de 64 bits. Si l'en-tête n'existe pas ou ne peut être interprété comme un entier, la fonction renvoie std::nullopt.

Cette fonction a été introduite dans Qt 6.10.

Voir aussi intValues(QAnyStringView name) et intValueAt(qsizetype i).

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

Cette fonction a été introduite dans Qt 6.10.

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

Renvoie la valeur de l'en-tête interprétée comme un entier de 64 bits à l'index i. L'index i doit être valide.

Cette fonction a été introduite dans Qt 6.10.

Voir aussi intValues(QAnyStringView name) et intValue(QAnyStringView name).

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

Renvoie les valeurs de l'en-tête name interprétées comme des entiers de 64 bits dans une liste. Si l'en-tête n'existe pas ou ne peut être interprété comme un entier, la fonction renvoie std::nullopt.

Cette fonction a été introduite dans Qt 6.10.

Voir aussi intValue(QAnyStringView name) et intValueAt(qsizetype i).

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

Cette fonction a été introduite dans Qt 6.10.

[noexcept] bool QHttpHeaders::isEmpty() const

Renvoie true si les en-têtes ont une taille de 0 ; sinon, renvoie false.

Voir aussi size().

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

Renvoie le nom de l'en-tête à l'index i. L'index i doit être valide (voir size()).

Les noms d'en-tête ne sont pas sensibles à la casse et les noms retournés sont en minuscules.

Voir aussi size() et valueAt().

void QHttpHeaders::removeAll(QAnyStringView name)

Supprime l'en-tête name.

Voir aussi removeAt() et removeAll(QHttpHeaders::WellKnownHeader).

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

void QHttpHeaders::removeAt(qsizetype i)

Supprime l'en-tête à l'index i. L'index i doit être valide (voir size()).

Voir aussi removeAll(QHttpHeaders::WellKnownHeader), removeAll(QAnyStringView) et size().

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

Remplace l'entrée de l'en-tête à l'index i, par name et newValue. L'index doit être valide (voir size()). Retourne si le remplacement a réussi.

Voir aussi append(), replace(qsizetype, QHttpHeaders::WellKnownHeader, QAnyStringView), size(), et 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 contient déjà name, remplace sa valeur par newValue et supprime les éventuelles entrées name supplémentaires. Si name n'existait pas, il ajoute une nouvelle entrée. Retourne true en cas de succès.

Cette fonction est une méthode pratique pour définir un en-tête unique name: newValue. Pour la plupart des en-têtes, l'ordre relatif n'a pas d'importance, ce qui permet de réutiliser une entrée existante s'il y en a une.

Cette fonction a été introduite dans Qt 6.8.

Voir aussi replaceOrAppend(QAnyStringView, QAnyStringView).

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

void QHttpHeaders::reserve(qsizetype size)

Tente d'allouer de la mémoire pour au moins size entrées d'en-tête.

Si vous connaissez à l'avance le nombre d'entrées d'en-tête, vous pouvez appeler cette fonction pour éviter les réallocations et la fragmentation de la mémoire.

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

Définit la valeur du nom de l'en-tête name en dateTime, selon le format standard HTTP IMF-fixdate. Si l'en-tête n'existe pas, il en ajoute un nouveau.

Cette fonction a été introduite dans Qt 6.10.

Voir aussi dateTimeValue(QAnyStringView name) et dateTimeValueAt(qsizetype i).

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

Cette fonction a été introduite dans Qt 6.10.

[noexcept] qsizetype QHttpHeaders::size() const

Renvoie le nombre d'entrées d'en-tête.

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

Remplace ce site QHttpHeaders par other. Cette opération est très rapide et n'échoue jamais.

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

Renvoie les entrées d'en-tête sous la forme d'une liste de paires (nom, valeur). Les noms d'en-tête sont insensibles à la casse et les noms renvoyés sont en minuscules.

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

Renvoie les entrées de l'en-tête sous la forme d'un hachage du nom à la (aux) valeur(s). Les noms des en-têtes sont insensibles à la casse et les noms retournés sont en minuscules.

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

Renvoie les entrées de l'en-tête sous la forme d'une carte de noms à valeurs. Les noms des en-têtes sont insensibles à la casse et les noms retournés sont en minuscules.

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

Renvoie la valeur du (premier) en-tête name, ou defaultValue s'il n'existe pas.

Voir aussi value(QHttpHeaders::WellKnownHeader, QByteArrayView).

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

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

Renvoie la valeur de l'en-tête à l'index i. L'index i doit être valide (voir size()).

Voir aussi size(), value(), values(), combinedValue() et nameAt().

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

Renvoie les valeurs de l'en-tête name dans une liste. Retourne une liste vide si l'en-tête name n'existe pas.

Voir aussi values(QHttpHeaders::WellKnownHeader).

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

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

Renvoie un nom d'en-tête correspondant à l'adresse name fournie sous forme de vue.

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

Move-assigne other et renvoie une référence à cet objet.

other sera laissé à empty.

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

Affecte le contenu de other et renvoie une référence à cet objet.