QUrlQuery Class

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

QUrlQuery::QUrlQuery()

空の QUrlQuery オブジェクトを作成します。その後、setQuery() を呼び出してクエリを設定したり、addQueryItem() を使用して項目を追加したりすることができます。

setQuery() およびaddQueryItem()も参照してください 。

[explicit] QUrlQuery::QUrlQuery(const QString &queryString)

QUrlQuery オブジェクトを生成し、デフォルトのクエリ区切り文字を使用してqueryString のクエリ文字列を解析します。他の区切り文字を使用してクエリ文字列を解析するには、まずsetQueryDelimiters() を使用して区切り文字を設定し、その後setQuery() を使用してクエリを設定する必要があります。

[explicit] QUrlQuery::QUrlQuery(const QUrl &url)

QUrlQuery オブジェクトを生成し、url の URL にあるクエリ文字列を、デフォルトのクエリ区切り文字を使用して解析します。他の区切り文字を使用してクエリ文字列を解析するには、まずsetQueryDelimiters() を使用して区切り文字を設定し、その後setQuery() を使用してクエリを設定する必要があります。

QUrl::query()も参照してください 。

QUrlQuery::QUrlQuery(std::initializer_list<std::pair<QString, QString>> list)

キーと値のペアのlist から、QUrlQueryオブジェクトを生成します。

QUrlQuery::QUrlQuery(const QUrlQuery &other)

other のQUrlQueryオブジェクトの内容を、クエリの区切り文字も含めてコピーします。

[noexcept, since 6.5] QUrlQuery::QUrlQuery(QUrlQuery &&other)

other のQUrlQueryオブジェクトの内容（クエリの区切り文字を含む）を移動します。

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

[noexcept] QUrlQuery::~QUrlQuery()

このQUrlQuery オブジェクトを破棄します。

void QUrlQuery::addQueryItem(const QString &key, const QString &value)

URLのクエリ文字列の末尾に、ペア「key =value 」を追加します。このメソッドは、同じキーを持つ既存の項目がある場合でも、それを上書きすることはありません。

関連項目： hasQueryItem() およびqueryItemValue()。

QStringList QUrlQuery::allQueryItemValues(const QString &key, QUrl::ComponentFormattingOptions encoding = QUrl::PrettyDecoded) const

URL から、キーが `key ` に等しいクエリ文字列の値のリストを返します。この際、encoding で指定されたオプションを使用して、戻り値をエンコードします。キー `key ` が見つからない場合、この関数は空のリストを返します。

関連項目: queryItemValue() およびaddQueryItem()。

void QUrlQuery::clear()

現在保存されているすべてのキーと値のペアを削除し、このQUrlQuery オブジェクトをクリアします。クエリの区切り文字が変更されている場合、この関数は変更後の値のままにしておきます。

isEmpty() およびsetQueryDelimiters()も参照してください 。

[static constexpr noexcept] char16_t QUrlQuery::defaultQueryPairDelimiter()

キーと値のペアを区切るためのデフォルトの文字、アンパサンド（「&」）を返します。

関連項目： setQueryDelimiters()、queryPairDelimiter()、およびdefaultQueryValueDelimiter()。

[static constexpr noexcept] char16_t QUrlQuery::defaultQueryValueDelimiter()

クエリ内でキーと値を区切るためのデフォルトの文字（等号「=」）を返します。

関連項目： setQueryDelimiters()、queryValueDelimiter()、およびdefaultQueryPairDelimiter()。

bool QUrlQuery::hasQueryItem(const QString &key) const

URL 内のクエリ文字列のうち、キーが `key ` と等しいペアが存在する場合、true を返します。

addQueryItem() およびqueryItemValue()も参照してください 。

bool QUrlQuery::isEmpty() const

この `QUrlQuery ` オブジェクトにキーと値のペアが含まれていない場合（デフォルトコンストラクタによる生成後や、空のクエリ文字列の解析後など）、true を返します。

setQuery() およびclear()も参照してください 。

QString QUrlQuery::query(QUrl::ComponentFormattingOptions encoding = QUrl::PrettyDecoded) const

このQUrlQuery オブジェクトに現在格納されているキーと値のペアから構成され、このオブジェクトに対して指定されたクエリ区切り文字で区切られた、再構築されたクエリ文字列を返します。キーと値は、encoding パラメータで指定されたオプションを使用してエンコードされます。

この関数において、唯一曖昧な区切り文字はハッシュ記号（「#」）です。URL では、この記号はクエリ文字列と、その後に続く可能性のあるフラグメントを区切るために使用されるためです。

返される文字列内のキーと値のペアの順序は、元のクエリと完全に同一です。

setQuery()、QUrl::setQuery()、QUrl::fragment()、および「エンコーディング」も参照してください 。

QString QUrlQuery::queryItemValue(const QString &key, QUrl::ComponentFormattingOptions encoding = QUrl::PrettyDecoded) const

URL内のキー「key 」に関連付けられたクエリ値を返します。この際、encoding で指定されたオプションを使用して、戻り値をエンコードします。キー「key 」が見つからない場合、この関数は空の文字列を返します。空の値と存在しないキーを区別する必要がある場合は、まずhasQueryItem() を使用してキーの存在を確認する必要があります。

キーkey が複数定義されている場合、この関数は、クエリ文字列に含まれている順序、またはaddQueryItem() を使用して追加された順序で、最初に検出されたものを返します。

関連項目: addQueryItem()、allQueryItemValues()、および「エンコーディング」。

QList<std::pair<QString, QString>> QUrlQuery::queryItems(QUrl::ComponentFormattingOptions encoding = QUrl::PrettyDecoded) const

URLのクエリ文字列を、キーと値のマップとして返します。この際、encoding で指定されたオプションを使用して各項目をエンコードします。要素の順序は、クエリ文字列に含まれる順序、またはsetQueryItems()で設定された順序と同じになります。

setQueryItems() および「エンコーディング」も参照してください 。

QChar QUrlQuery::queryPairDelimiter() const

query() でクエリ文字列を再構築する際、またはsetQuery() でクエリ文字列を解析する際に、キーと値のペアを区切るために使用される文字を返します。

setQueryDelimiters() およびqueryValueDelimiter()も参照してください 。

QChar QUrlQuery::queryValueDelimiter() const

query() でクエリ文字列を再構築する際、またはsetQuery() でクエリ文字列を解析する際に、キーと値を区切るために使用される文字を返します。

setQueryDelimiters() およびqueryPairDelimiter()も参照してください 。

void QUrlQuery::removeAllQueryItems(const QString &key)

URLから、キーが「key 」に等しいすべてのクエリ文字列のペアを削除します。

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

void QUrlQuery::removeQueryItem(const QString &key)

URL から、キーが `key ` に等しいクエリ文字列のペアを削除します。キーが `key` に等しい項目が複数ある場合、クエリ文字列に含まれる順序、または `addQueryItem()` で追加された順序で、最初の項目が削除されます。

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

void QUrlQuery::setQuery(const QString &queryString)

queryString 内のクエリ文字列を解析し、そこで見つかった値を内部の項目に設定します。setQueryDelimiters() で区切り文字が指定されている場合、この関数はデフォルトの区切り文字の代わりにそれらを使用して文字列を解析します。

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

void QUrlQuery::setQueryDelimiters(QChar valueDelimiter, QChar pairDelimiter)

URLのクエリ文字列において、キーと値の間、およびキーと値のペアの区切りとして使用される文字を設定します。デフォルトの値区切り文字は「=」、デフォルトのペア区切り文字は「&」です。

valueDelimiter がキーと値を区切るために使用され、pairDelimiter がキーと値のペアを区切るために使用されます。クエリ文字列のキーおよび値のエンコードされた表現中にこれらの区切り文字が含まれている場合、query() で返される際にはパーセントエンコードされます。

valueDelimiter が','に設定され、pairDelimiter が';'に設定されている場合、上記のクエリ文字列は次のように表現されます：

 http://www.example.com/cgi-bin/drawgraph.cgi?type,pie;color,green

sub-delims    = "!" / "$" / "&" / "'" / "(" / ")"
              / "*" / "+" / "," / ";" / "="

その他の文字の使用はサポートされておらず、予期しない動作を引き起こす可能性があります。このメソッドは、有効な区切り文字が渡されたかどうかを検証しません。

関連項目： queryValueDelimiter() およびqueryPairDelimiter()。

void QUrlQuery::setQueryItems(const QList<std::pair<QString, QString>> &query)

このQUrlQuery オブジェクトの項目をquery に設定します。query 内の要素の順序は保持されます。

queryItems() およびisEmpty()も参照してください 。

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

このURLクエリのインスタンスを、other と置き換えます。この操作は非常に高速で、失敗することはありません。

QString QUrlQuery::toString(QUrl::ComponentFormattingOptions encoding = QUrl::PrettyDecoded) const

このQUrlQuery をQString として返します。encoding を使用すると、戻り値のURL文字列エンコーディングを指定できます。

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

other をこのQUrlQuery インスタンスに割り当てます。

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

other QUrlQuery オブジェクトの内容（クエリ区切り文字を含む）をコピーします。