QUrlQuery Class

멤버 함수 문서

QUrlQuery::QUrlQuery()

빈 쿼리 객체를 생성합니다. 나중에 setQuery()를 호출하여 쿼리를 설정하거나 addQueryItem()를 사용하여 항목을 추가할 수 있습니다.

setQuery() 및 addQueryItem()도 참조하세요 .

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

기본 쿼리 구분자를 사용하여 QUrlQuery 객체를 만들고 queryString 쿼리 문자열을 구문 분석합니다. 다른 구분 기호를 사용하여 쿼리 문자열을 구문 분석하려면 먼저 setQueryDelimiters()를 사용하여 구분 기호를 설정한 다음 setQuery()로 쿼리를 설정해야 합니다.

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

기본 쿼리 구분자를 사용하여 쿼리 쿼리 객체를 만들고 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

반환 값을 인코딩하기 위해 encoding 에 지정된 옵션을 사용하여 URL에서 키가 key 와 같은 쿼리 문자열 값의 목록을 반환합니다. 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() 및 Encoding 을참조하세요 .

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

반환 값을 인코딩하기 위해 encoding 에 지정된 옵션을 사용하여 URL에서 key 키와 연관된 쿼리 값을 반환합니다. key 키를 찾을 수 없는 경우 이 함수는 빈 문자열을 반환합니다. 빈 값과 존재하지 않는 키를 구별해야 하는 경우 hasQueryItem()를 사용하여 먼저 키의 존재 여부를 확인해야 합니다.

key 키가 곱하기 정의된 경우 이 함수는 쿼리 문자열에 있거나 addQueryItem()를 사용하여 추가된 순서대로 가장 먼저 발견된 키를 반환합니다.

addQueryItem(), allQueryItemValues() 및 Encoding 를참조하세요 .

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

encoding 에 지정된 옵션을 사용하여 항목을 인코딩하는 키와 값의 맵으로 URL의 쿼리 문자열을 반환합니다. 요소의 순서는 쿼리 문자열에서 찾거나 setQueryItems()로 설정한 것과 동일합니다.

setQueryItems() 및 Encoding 을참조하세요 .

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 객체의 내용을 복사합니다.