QHttpHeaders Class

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

Dokumentation der Member-Funktionen

[noexcept] QHttpHeaders::QHttpHeaders()

Erstellt ein neues QHttpHeaders-Objekt.

QHttpHeaders::QHttpHeaders(const QHttpHeaders &other)

Erstellt eine Kopie von „ other “.

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

Erstellt das Objekt aus „ other “ mittels „Move-Konstruktion“, wobei „ “ erhalten bleibt. empty.

[noexcept] QHttpHeaders::~QHttpHeaders()

Entfernt das „headers“-Objekt.

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

Fügt einen Header-Eintrag mit den Werten „ name “ und „ value “ hinzu und gibt bei Erfolg „ true “ zurück.

Siehe auch append(QHttpHeaders::WellKnownHeader, QAnyStringView) und Allowed field name and value characters.

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

void QHttpHeaders::clear()

Löscht alle Kopfzeileneinträge.

Siehe auch ` size()`.

QByteArray QHttpHeaders::combinedValue(QAnyStringView name) const

Gibt die Werte des Header- name s in einer durch Kommas getrennten Zeichenfolge zurück. Gibt einen „ null “ QByteArray zurück, wenn der Header mit dem name nicht vorhanden ist.

Siehe auch values(QAnyStringView).

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

bool QHttpHeaders::contains(QAnyStringView name) const

Gibt zurück, ob die Header einen Header mit dem Wert „ name “ enthalten.

Siehe auch „ contains “ (QHttpHeaders::WellKnownHeader).

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

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

Konvertiert den ersten gefundenen Header-Wert von „ name “ gemäß den Standard-HTTP-Datumsformaten in ein „ QDateTime “-Objekt. Wenn der Header nicht vorhanden ist oder ein ungültiges „ QDateTime “ enthält, wird „ std::nullopt “ zurückgegeben.

Diese Funktion wurde in Qt 6.10 eingeführt.

Siehe auch „ setDateTimeValue()“, „ dateTimeValues(QAnyStringView name)“ und „ dateTimeValueAt(qsizetype i)“.

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

Diese Funktion wurde in Qt 6.10 eingeführt.

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

Konvertiert den Header-Wert am Index „ i “ in ein „ QDateTime “-Objekt gemäß den Standard-HTTP-Datumsformaten. Der Index „ i “ muss gültig sein.

Diese Funktion wurde in Qt 6.10 eingeführt.

Siehe auch ` dateTimeValue` (Name von `QAnyStringView`) und ` dateTimeValues` (Name von `QAnyStringView`).

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

Gibt alle Header-Werte von „ name “ in einer Liste von „ QDateTime “-Objekten zurück, die den Standard-HTTP-Datumsformaten entsprechen. Wenn keine gültigen Datums- und Zeitwerte gefunden werden, wird „ std::nullopt “ zurückgegeben.

Diese Funktion wurde in Qt 6.10 eingeführt.

Siehe auch dateTimeValue(QAnyStringView name) und dateTimeValueAt(qsizetype i).

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

Diese Funktion wurde in Qt 6.10 eingeführt.

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

Erstellt ein neues „ QHttpHeaders “-Objekt, das mit „ headers “ gefüllt wird.

Siehe auch „ Allowed field name and value characters “.

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

Erstellt ein neues „ QHttpHeaders “-Objekt, das mit „ headers “ gefüllt ist.

Siehe auch „ Allowed field name and value characters “.

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

Erstellt ein neues „ QHttpHeaders “-Objekt, das mit „ headers “ gefüllt ist.

Siehe auch „ Allowed field name and value characters “.

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

Fügt einen Header-Eintrag am Index i ein, mit den Werten name und value. Der Index muss gültig sein (siehe size()). Gibt zurück, ob das Einfügen erfolgreich war.

Siehe auch append(), insert(qsizetype, QHttpHeaders::WellKnownHeader, QAnyStringView), size() und 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

Gibt den Wert des ersten gültigen Header- name s zurück, der als 64-Bit-Ganzzahl interpretiert wird. Wenn der Header nicht vorhanden ist oder nicht als Ganzzahl geparst werden kann, wird „ std::nullopt “ zurückgegeben.

Diese Funktion wurde in Qt 6.10 eingeführt.

Siehe auch ` intValues(QAnyStringView name)` und ` intValueAt(qsizetype i)`.

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

Diese Funktion wurde in Qt 6.10 eingeführt.

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

Gibt den als 64-Bit-Ganzzahl interpretierten Header-Wert am Index „ i “ zurück. Der Index „ i “ muss gültig sein.

Diese Funktion wurde in Qt 6.10 eingeführt.

Siehe auch ` intValues(QAnyStringView name)` und ` intValue(QAnyStringView name)`.

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

Gibt die Werte des Header- name s, interpretiert als 64-Bit-Ganzzahl, in einer Liste zurück. Wenn der Header nicht vorhanden ist oder nicht als Ganzzahl geparst werden kann, wird „ std::nullopt “ zurückgegeben.

Diese Funktion wurde in Qt 6.10 eingeführt.

Siehe auch ` intValue(QAnyStringView name)` und ` intValueAt(qsizetype i)`.

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

Diese Funktion wurde in Qt 6.10 eingeführt.

[noexcept] bool QHttpHeaders::isEmpty() const

Gibt „ true “ zurück, wenn die Header die Größe 0 haben; andernfalls wird „ false “ zurückgegeben.

Siehe auch size().

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

Gibt den Namen des Headers am Index „ i “ zurück. Der Index „ i “ muss gültig sein (siehe size()).

Bei Header-Namen wird die Groß-/Kleinschreibung nicht berücksichtigt, und die zurückgegebenen Namen werden in Kleinbuchstaben geschrieben.

Siehe auch size() und valueAt().

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

Gibt die Bereiche der HTTP-Header-Felder „ Range “ zurück oder „ std::nullopt “, falls das Parsen fehlgeschlagen ist.

Jeder Bereich entspricht einem Byte-Bereich. Gemäß RFC 9110:

• Wenn der Start angegeben ist, das Ende jedoch nicht (z. B. „bytes=500-“), hat der „ QHttpHeaderRangeSpec “ die Werte „ start=500 “ und „ end=std::nullopt “.
• Wird das Ende angegeben, der Anfang jedoch nicht (z. B. „bytes=-500“), hat der „ QHttpHeaderRangeSpec “ die Werte „ start=std::nullopt “ und „ end=500 “, was die letzten 500 Bytes darstellt.
• Wenn beide angegeben sind (z. B. „bytes=0-499“), enthält der „ QHttpHeaderRangeSpec “ die Werte start=0 und end=499.

Die Bereiche werden in der Reihenfolge zurückgegeben, in der sie in den Headern erscheinen.

Die Auswertung erfolgt wie folgt:

• Ist kein „ Range “-Header vorhanden, wird ein leerer Bereichssatz zurückgegeben.
• Gemäß RFC 9110 Abschnitt 14.2 wird jeder „ Range “-Header, der eine andere Einheit als „bytes“ enthält (z. B. „seconds=1-2“), ignoriert. Diese ignorierten Header führen nicht dazu, dass die Analyse fehlschlägt.
• Wenn ein „ Range “-Header die Einheit „bytes“ verwendet, aber fehlerhaft formatiert ist (z. B. fehlender Bindestrich, ungültige Zeichen oder ungültige Zahlen), gibt die Funktion „ std::nullopt “ zurück.

Diese Funktion wurde in Qt 6.12 eingeführt.

Siehe auch ` setRangeValues ` und ` WellKnownHeader::Range`.

void QHttpHeaders::removeAll(QAnyStringView name)

Entfernt den Header „ name “.

Siehe auch removeAt() und removeAll(QHttpHeaders::WellKnownHeader).

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

void QHttpHeaders::removeAt(qsizetype i)

Entfernt den Header am Index i. Der Index i muss gültig sein (siehe size()).

Siehe auch removeAll(QHttpHeaders::WellKnownHeader), removeAll(QAnyStringView) und size().

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

Ersetzt den Header-Eintrag am Index i durch name und newValue. Der Index muss gültig sein (siehe size()). Gibt zurück, ob das Ersetzen erfolgreich war.

Siehe auch append(), replace(qsizetype, QHttpHeaders::WellKnownHeader, QAnyStringView), size() und 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)

Wenn „ QHttpHeaders “ bereits den Eintrag „ name “ enthält, wird dessen Wert durch „ newValue “ ersetzt und eventuelle weitere Einträge unter „ name “ entfernt. Falls „ name “ nicht existiert, wird ein neuer Eintrag angehängt. Bei Erfolg wird „ true “ zurückgegeben.

Diese Funktion ist eine Hilfsmethode zum Festlegen eines eindeutigen „ name: newValue “-Headers. Bei den meisten Headern spielt die relative Reihenfolge keine Rolle, sodass ein vorhandener Eintrag wiederverwendet werden kann, sofern vorhanden.

Diese Funktion wurde in Qt 6.8 eingeführt.

Siehe auch „ replaceOrAppend“ (QAnyStringView, QAnyStringView).

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

void QHttpHeaders::reserve(qsizetype size)

Es wird versucht, Speicher für mindestens size Header-Einträge zuzuweisen.

Wenn Sie im Voraus wissen, wie viele Header-Einträge es geben wird, können Sie diese Funktion aufrufen, um Neuzuweisungen und Speicherfragmentierung zu vermeiden.

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

Setzt den Wert des Header-Namens „ name “ auf „ dateTime “ gemäß dem Standard-HTTP-IMF-Fixdate-Format. Falls der Header nicht vorhanden ist, wird ein neuer hinzugefügt.

Diese Funktion wurde in Qt 6.10 eingeführt.

Siehe auch „ dateTimeValue“ (QAnyStringView name) und „ dateTimeValueAt “ (qsizetype i).

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

Diese Funktion wurde in Qt 6.10 eingeführt.

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

Setzt das HTTP-Header-Feld „ Range “ auf die angegebene Liste von ranges.

Die Bereiche werden unter Verwendung der Einheit „Bytes“ in der Reihenfolge formatiert, in der sie in ` ranges ` gespeichert sind. Für jeden ` QHttpHeaderRangeSpec` gilt:

• Ein Bereich, der nur einen Startpunkt enthält (z. B. ` QHttpHeaderRangeSpec(500, std::nullopt)`), wird als ` "500-"` formatiert.
• Ein Bereich mit nur einem Endpunkt (z. B. ` QHttpHeaderRangeSpec(std::nullopt, 500)`) wird als ` "-500"` formatiert, was die letzten 500 Bytes darstellt.
• Ein Bereich mit Start und Ende (z. B. ` QHttpHeaderRangeSpec(0, 499)`) wird als ` "0-499"` formatiert.

Werden mehrere Bereiche angegeben, werden diese durch Kommas getrennt, zum Beispiel: "bytes=0-499, 1000-".

Ist „ ranges “ leer, wird die Überschrift „ Range “ entfernt.

Diese Funktion wurde in Qt 6.12 eingeführt.

Siehe auch rangeValues() und WellKnownHeader::Range.

[noexcept] qsizetype QHttpHeaders::size() const

Gibt die Anzahl der Header-Einträge zurück.

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

Ersetzt diese URL QHttpHeaders durch other. Dieser Vorgang ist sehr schnell und schlägt niemals fehl.

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

Gibt die Header-Einträge als Liste von (Name, Wert)-Paaren zurück. Bei den Header-Namen wird die Groß-/Kleinschreibung nicht berücksichtigt, und die zurückgegebenen Namen werden in Kleinbuchstaben umgewandelt.

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

Gibt die Header-Einträge als Hash zurück, der Namen und Werte enthält. Bei den Header-Namen wird die Groß-/Kleinschreibung nicht berücksichtigt, und die zurückgegebenen Namen werden in Kleinbuchstaben umgewandelt.

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

Gibt die Header-Einträge als Zuordnung von Namen zu Werten zurück. Bei den Header-Namen wird die Groß-/Kleinschreibung nicht berücksichtigt, und die zurückgegebenen Namen werden in Kleinbuchstaben umgewandelt.

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

Gibt den Wert des (ersten) Header- name s zurück oder defaultValue, falls dieser nicht vorhanden ist.

Siehe auch value(QHttpHeaders::WellKnownHeader, QByteArrayView).

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

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

Gibt den Header-Wert am Index i zurück. Der Index i muss gültig sein (siehe size()).

Siehe auch size(), value(), values(), combinedValue() und nameAt().

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

Gibt die Werte der Header- name en in einer Liste zurück. Gibt eine leere Liste zurück, wenn der Header mit der name nicht vorhanden ist.

Siehe auch „ values “ (QHttpHeaders::WellKnownHeader).

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

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

Gibt einen Header-Namen zurück, der dem angegebenen „ name “ als Ansicht entspricht.

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

„Move-assigns“ other und gibt einen Verweis auf dieses Objekt zurück.

other empty bleibt erhalten.

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

Weist den Inhalt von „ other “ zu und gibt eine Referenz auf dieses Objekt zurück.