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)

기본 쿼리 구분자를 사용하여 url URL에서 발견된 쿼리 문자열을 파싱하고 QUrlQuery 객체를 생성합니다. 다른 구분자를 사용하여 쿼리 문자열을 파싱하려면, 먼저 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() 및 Encoding항목도 참조하십시오 .

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

encoding 에 지정된 옵션을 사용하여 항목을 인코딩한 후, URL의 쿼리 문자열을 키-값 쌍의 맵 형태로 반환합니다. 요소의 순서는 쿼리 문자열에 있는 순서나 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 객체의 내용을 복사합니다.