QHttpHeaders Class

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

Documentation des fonctions membres

[noexcept] QHttpHeaders::QHttpHeaders()

Crée un nouvel objet QHttpHeaders.

QHttpHeaders::QHttpHeaders(const QHttpHeaders &other)

Crée une copie de other.

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

Construit l'objet à partir de other, qui restera accessible à l'adresse empty.

[noexcept] QHttpHeaders::~QHttpHeaders()

Supprime 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 également 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 sous la forme d'une chaîne de caractères séparée par des virgules. Renvoie une erreur « null » QByteArray si l'en-tête name n'existe pas.

Voir également values(QAnyStringView).

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

bool QHttpHeaders::contains(QAnyStringView name) const

Indique si les en-têtes contiennent un en-tête « name ».

Voir également 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 type « name » en un objet « QDateTime », conformément aux formats de date HTTP standard. Si l'en-tête n'existe pas ou contient une valeur « QDateTime » non valide, la fonction renvoie « std::nullopt ».

Cette fonction a été introduite dans Qt 6.10.

Voir également 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 ` respectant les formats de date HTTP standard. L'index i doit être valide.

Cette fonction a été introduite dans Qt 6.10.

Voir également dateTimeValue(nom de QAnyStringView) et dateTimeValues(nom de QAnyStringView).

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

Renvoie toutes les valeurs d'en-tête de name sous la forme d'une liste d'objets QDateTime, conformément aux formats de date HTTP standard. Si aucune valeur de date-heure valide n'est trouvée, renvoie std::nullopt.

Cette fonction a été introduite dans Qt 6.10.

Voir également 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 ` dont les propriétés sont renseignées avec ` headers`.

Voir également Allowed field name and value characters.

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

Crée un nouvel objet ` QHttpHeaders ` dont les propriétés sont renseignées avec ` headers`.

Voir également Allowed field name and value characters.

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

Crée un nouvel objet ` QHttpHeaders ` dont les propriétés sont renseignées avec ` headers`.

Voir également 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()). Renvoie si l'insertion a réussi.

Voir également 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ée comme un entier de 64 bits. Si l'en-tête n'existe pas ou ne peut pas être analysé comme un entier, renvoie std::nullopt.

Cette fonction a été introduite dans Qt 6.10.

Voir également 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 également ` intValues(nom de QAnyStringView)` et ` intValue(nom de QAnyStringView)`.

[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 64 bits, sous forme de liste. Si l'en-tête n'existe pas ou ne peut pas être analysée comme un entier, la fonction renvoie std::nullopt.

Cette fonction a été introduite dans Qt 6.10.

Voir également 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 la taille des en-têtes est égale à 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 renvoyés sont mis en minuscules.

Voir également size() et valueAt().

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

Renvoie les plages des champs d'en-tête HTTP « Range », ou « std::nullopt » si l'analyse a échoué.

Chaque plage correspond à une plage d’octets. Conformément à la RFC 9110 :

• Si le début est spécifié mais pas la fin (par exemple, « bytes=500- »), l’ QHttpHeaderRangeSpec aura les valeurs suivantes : start=500 et end=std::nullopt.
• Si la fin est spécifiée mais pas le début (par exemple, « bytes=-500 »), l’ QHttpHeaderRangeSpec aura les valeurs start=std::nullopt et end=500, représentant les 500 derniers octets.
• Si les deux sont spécifiés (par exemple, « bytes=0-499 »), l'QHttpHeaderRangeSpec ra start=0 et end=499.

Les plages sont renvoyées dans l’ordre dans lequel elles apparaissent dans les en-têtes.

L’analyse s’effectue comme suit :

• Si aucun en-tête « Range » n’est présent, un ensemble de plages vide est renvoyé.
• Conformément à la section 14.2 de la RFC 9110, tout en-tête « Range » contenant une unité autre que « bytes » (par exemple, « seconds=1-2 ») est ignoré. Ces en-têtes ignorés n’entraînent pas l’échec de l’analyse.
• Si un en-tête « Range » utilise l’unité « bytes » mais est mal formé (par exemple, s’il manque le trait d’union, s’il contient des caractères non valides ou des nombres non valides), la fonction renvoie « std::nullopt ».

Cette fonction a été introduite dans Qt 6.12.

Voir également setRangeValues et WellKnownHeader::Range.

void QHttpHeaders::removeAll(QAnyStringView name)

Supprime l'en-tête name.

Voir également 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 également removeAll(QHttpHeaders::WellKnownHeader), removeAll(QAnyStringView) et size().

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

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

Voir également 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, cette fonction remplace sa valeur par newValue et supprime les éventuelles entrées supplémentaires de type name. Si name n'existe pas, elle ajoute une nouvelle entrée. Elle renvoie true en cas de réussite.

Cette fonction est une méthode pratique permettant de définir un en-tête unique de type ` 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 le cas échéant.

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 de l'en-tête « name » sur « dateTime », conformément au format standard HTTP IMF-fixdate. Si l'en-tête n'existe pas, elle en crée une nouvelle.

Cette fonction a été introduite dans Qt 6.10.

Voir également 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.

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

Définit le champ d'en-tête HTTP « Range » sur la liste spécifiée de ranges.

Les plages sont formatées en utilisant l’unité « octets », dans l’ordre dans lequel ranges les contient. Pour chaque QHttpHeaderRangeSpec:

• Une plage comportant uniquement un début (par exemple, QHttpHeaderRangeSpec(500, std::nullopt)) est formatée sous la forme "500-".
• Un intervalle ne comportant qu'une fin (par exemple, QHttpHeaderRangeSpec(std::nullopt, 500)) est formaté sous la forme "-500", ce qui représente les 500 derniers octets.
• Un intervalle comportant à la fois un début et une fin (par exemple, QHttpHeaderRangeSpec(0, 499)) est formaté sous la forme "0-499".

Si plusieurs plages sont fournies, elles sont séparées par des virgules, par exemple : "bytes=0-499, 1000-".

Si ranges est vide, l’en-tête Range est supprimé.

Cette fonction a été introduite dans Qt 6.12.

Voir également rangeValues() et WellKnownHeader::Range.

[noexcept] qsizetype QHttpHeaders::size() const

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

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

Remplace cette adresse QHttpHeaders par other. Cette opération est très rapide et ne pose jamais de problème.

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). La casse des noms d'en-tête n'a pas d'importance, et les noms renvoyés sont mis en minuscules.

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

Renvoie les entrées d'en-tête sous forme de table associative, avec pour clés les noms et pour valeurs les valeurs correspondantes. La casse des noms d'en-tête n'a pas d'importance, et les noms renvoyés sont mis en minuscules.

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

Renvoie les entrées d'en-tête sous la forme d'une carte associant un nom à une ou plusieurs valeurs. La casse des noms d'en-tête n'a pas d'importance, et les noms renvoyés sont mis en minuscules.

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

Renvoie la valeur de l'en-tête (premier) 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 également size(), value(), values(), combinedValue() et nameAt().

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

Renvoie les valeurs de l'en-tête name sous forme de liste. Renvoie 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 le nom d'un en-tête correspondant à l'name ion fournie en tant que vue.

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

La fonction « move-assign » attribue la valeur other et renvoie une référence à cet objet.

other empty sera conservé.

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

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