QHttpHeaders Class

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

メンバ関数のドキュメント

[noexcept] QHttpHeaders::QHttpHeaders()

新しい QHttpHeaders オブジェクトを作成します。

QHttpHeaders::QHttpHeaders(const QHttpHeaders &other)

other のコピーを作成します。

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

other からオブジェクトをムーブコンストラクトで生成します。これにより、 はempty のまま残ります。

[noexcept] QHttpHeaders::~QHttpHeaders()

ヘッダーオブジェクトを破棄します。

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

name およびvalue を含むヘッダーエントリを追加し、成功した場合はtrue を返します。

append(QHttpHeaders::WellKnownHeader, QAnyStringView) およびAllowed field name and value charactersも参照してください 。

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

void QHttpHeaders::clear()

すべてのヘッダーエントリをクリアします。

size()も参照してください 。

QByteArray QHttpHeaders::combinedValue(QAnyStringView name) const

ヘッダー「name 」の値をカンマ区切りの文字列として返します。name を含むヘッダーが存在しない場合は、null QByteArray を返します。

values(QAnyStringView)も参照してください 。

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

bool QHttpHeaders::contains(QAnyStringView name) const

ヘッダーにname を含むヘッダーが含まれているかどうかを返します。

「contains(QHttpHeaders::WellKnownHeader)」も参照してください 。

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

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

name のヘッダー値のうち、最初に検出されたものを、標準のHTTP日付形式に従ってQDateTime オブジェクトに変換します。ヘッダーが存在しない場合、または無効なQDateTime が含まれている場合は、std::nullopt を返します。

この関数は Qt 6.10 で導入されました。

setDateTimeValue()、dateTimeValues(QAnyStringView name)、およびdateTimeValueAt(qsizetype i)も参照してください 。

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

この関数は Qt 6.10 で導入されました。

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

インデックスi にあるヘッダーの値を、標準のHTTP日付形式に従ったQDateTime オブジェクトに変換します。インデックスi は有効な値でなければなりません。

この関数は Qt 6.10 で導入されました。

dateTimeValue （QAnyStringView name）およびdateTimeValues （QAnyStringView name）も参照してください 。

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

name のすべてのヘッダー値を、標準の HTTP 日付形式に従ったQDateTime オブジェクトのリストとして返します。有効な日時値が見つからない場合は、std::nullopt を返します。

この関数は Qt 6.10 で導入されました。

dateTimeValue(QAnyStringView name) およびdateTimeValueAt(qsizetype i)も参照してください 。

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

この関数は Qt 6.10 で導入されました。

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

headers で初期化された新しいQHttpHeaders オブジェクトを作成します。

「Allowed field name and value characters」も参照してください 。

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

headers が設定された新しい `QHttpHeaders ` オブジェクトを作成します。

「Allowed field name and value characters」も参照してください 。

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

headers で初期化された新しいQHttpHeaders オブジェクトを作成します。

「Allowed field name and value characters」も参照してください 。

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

インデックスi に、name およびvalue を持つヘッダーエントリを挿入します。インデックスは有効である必要があります（size() を参照）。挿入が成功したかどうかを返します。

append()、insert(qsizetype, QHttpHeaders::WellKnownHeader, QAnyStringView)、size()、および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

最初の有効なヘッダー `name ` の値を、64ビット整数として解釈したものを返します。ヘッダーが存在しない場合、または整数として解析できない場合は、std::nullopt を返します。

この関数は Qt 6.10 で導入されました。

intValues(QAnyStringView name) およびintValueAt(qsizetype i)も参照してください 。

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

この関数は Qt 6.10 で導入されました。

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

インデックス `i` にあるヘッダー値を、64ビット整数として解釈して返します。インデックス `i ` は有効な値でなければなりません。

この関数は Qt 6.10 で導入されました。

intValues(QAnyStringView name) およびintValue(QAnyStringView name)も参照してください 。

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

ヘッダー `name ` の値を、64ビット整数として解釈したものをリストとして返します。ヘッダーが存在しない場合、または整数として解析できない場合は、std::nullopt を返します。

この関数は Qt 6.10 で導入されました。

intValue(QAnyStringView name) およびintValueAt(qsizetype i)も参照してください 。

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

この関数は Qt 6.10 で導入されました。

[noexcept] bool QHttpHeaders::isEmpty() const

ヘッダーのサイズが 0 の場合は `true ` を返し、それ以外の場合は `false` を返します。

size()も参照してください 。

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

インデックス `i` にあるヘッダー名を返します。インデックス `i ` は有効な値でなければなりません（size() を参照）。

ヘッダー名は大文字と小文字を区別せず、返される名前は小文字に変換されます。

size() およびvalueAt()も参照してください 。

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

Range HTTPヘッダーフィールドの範囲を返します。解析に失敗した場合は、std::nullopt を返します。

各範囲はバイト範囲を表します。RFC 9110によると：

• 開始位置が指定されているが終了位置が指定されていない場合（例: "bytes=500-"）、QHttpHeaderRangeSpec にはstart=500 およびend=std::nullopt が設定されます。
• 終了位置が指定され、開始位置が指定されていない場合（例: "bytes=-500"）、QHttpHeaderRangeSpec にはstart=std::nullopt およびend=500 が設定され、最後の500バイトを表します。
• 両方が指定されている場合（例：「bytes=0-499」）、QHttpHeaderRangeSpec にはstart=0 およびend=499 が含まれます。

範囲は、ヘッダーに記述されている順序で返されます。

解析は次のように行われます。

• Range ヘッダーが存在しない場合、空の範囲セットが返されます。
• RFC 9110のセクション14.2によると、「bytes」以外の単位を含むRange ヘッダー（例: 「seconds=1-2」）は無視されます。これらの無視されたヘッダーによって、解析が失敗することはありません。
• Range ヘッダーが「bytes」単位を使用しているものの、形式が不正である場合（例：ハイフンが欠落している、無効な文字が含まれている、または無効な数値が含まれている）、この関数はstd::nullopt を返します。

この関数は Qt 6.12 で導入されました。

setRangeValues およびWellKnownHeader::Rangeも参照してください 。

void QHttpHeaders::removeAll(QAnyStringView name)

ヘッダー「name 」を削除します。

removeAt() およびremoveAll(QHttpHeaders::WellKnownHeader)も参照してください 。

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

void QHttpHeaders::removeAt(qsizetype i)

インデックスi にあるヘッダーを削除します。インデックスi は有効なものでなければなりません（size() を参照してください）。

removeAll(QHttpHeaders::WellKnownHeader)、removeAll(QAnyStringView)、およびsize()も参照してください 。

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

インデックスi にあるヘッダーエントリを、name およびnewValue に置き換えます。インデックスは有効である必要があります（size() を参照）。置換が成功したかどうかを返します。

append()、replace(qsizetype, QHttpHeaders::WellKnownHeader, QAnyStringView)、size()、および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)

QHttpHeaders にすでにname が含まれている場合、その値をnewValue に置き換え、追加されている可能性のあるname エントリを削除します。name が存在しない場合は、新しいエントリを追加します。成功した場合はtrue を返します。

この関数は、一意のname:newValue ヘッダーを設定するための便宜的なメソッドです。ほとんどのヘッダーでは順序は重要ではないため、既存のエントリが存在する場合はそれを再利用できます。

この関数は Qt 6.8 で導入されました。

replaceOrAppend(QAnyStringView, QAnyStringView)も参照してください 。

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

void QHttpHeaders::reserve(qsizetype size)

少なくともsize 個のヘッダーエントリ分のメモリを割り当てようとします。

ヘッダーエントリの数が事前に分かっている場合は、この関数を呼び出すことで、再割り当てやメモリの断片化を防ぐことができます。

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

ヘッダー名「name 」の値を、標準のHTTP IMF-fixdate形式に従って「dateTime 」に設定します。ヘッダーが存在しない場合は、新しいヘッダーを追加します。

この関数は Qt 6.10 で導入されました。

dateTimeValue(QAnyStringView name) およびdateTimeValueAt(qsizetype i)も参照してください 。

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

この関数は Qt 6.10 で導入されました。

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

Range HTTPヘッダーフィールドを、指定されたranges のリストに設定します。

範囲は「バイト」単位で、ranges が保持している順序でフォーマットされます。各QHttpHeaderRangeSpec について：

• 開始値のみを持つ範囲（例：QHttpHeaderRangeSpec(500, std::nullopt)）は、"500-" としてフォーマットされます。
• 終了値のみを含む範囲（例：QHttpHeaderRangeSpec(std::nullopt, 500)）は、"-500" としてフォーマットされ、最後の 500 バイトを表します。
• 開始位置と終了位置の両方が指定されている範囲（例：QHttpHeaderRangeSpec(0, 499)）は、"0-499" の形式で表示されます。

複数の範囲が指定された場合、それらはコンマで区切られます。例："bytes=0-499 、1000-」。

ranges が空の場合、Range ヘッダーは削除されます。

この関数は Qt 6.12 で導入されました。

rangeValues() およびWellKnownHeader::Rangeも参照してください 。

[noexcept] qsizetype QHttpHeaders::size() const

ヘッダーエントリの数を返します。

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

QHttpHeaders をother に置き換えます。この処理は非常に高速で、失敗することはありません。

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

ヘッダーエントリを (名前, 値) のペアのリストとして返します。ヘッダー名は大文字と小文字を区別せず、返される名前はすべて小文字に変換されます。

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

ヘッダーエントリを、名前から値（複数可）へのハッシュとして返します。ヘッダー名は大文字小文字を区別せず、返される名前はすべて小文字に変換されます。

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

ヘッダーエントリを、名前から値（複数可）へのマップとして返します。ヘッダー名は大文字と小文字を区別せず、返される名前は小文字に変換されます。

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

（最初の）ヘッダー `name` の値を返します。存在しない場合は `defaultValue ` を返します。

value(QHttpHeaders::WellKnownHeader、QByteArrayView)も参照してください 。

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

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

インデックスi にあるヘッダー値を返します。インデックスi は有効な値でなければなりません（size() を参照）。

size()、value()、values()、combinedValue()、およびnameAt()も参照してください 。

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

ヘッダー「name 」の値をリストとして返します。name を持つヘッダーが存在しない場合は、空のリストを返します。

values(QHttpHeaders::WellKnownHeader)も参照してください 。

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

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

指定されたname に対応するヘッダー名を、ビューとして返します。

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

other を代入し、このオブジェクトへの参照を返します。

other empty が残されます。

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

other の内容を割り当て、このオブジェクトへの参照を返します。