1// Copyright (C) 2020 The Qt Company Ltd.
2// Copyright (C) 2016 Intel Corporation.
3// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR LGPL-3.0-only OR GPL-2.0-only OR GPL-3.0-only
4// Qt-Security score:significant reason:default
5
6#ifndef QURLQUERY_H
7#define QURLQUERY_H
8
9#include <QtCore/qcompare.h>
10#include <QtCore/qshareddata.h>
11#include <QtCore/qurl.h>
12
13#include <initializer_list>
14
15QT_BEGIN_NAMESPACE
16
17Q_CORE_EXPORT size_t qHash(const QUrlQuery &key, size_t seed = 0) noexcept;
18
19class QUrlQueryPrivate;
20class Q_CORE_EXPORT QUrlQuery
21{
22public:
23 QUrlQuery();
24 explicit QUrlQuery(const QUrl &url);
25 explicit QUrlQuery(const QString &queryString);
26 QUrlQuery(std::initializer_list<std::pair<QString, QString>> list)
27 : QUrlQuery()
28 {
29 for (const std::pair<QString, QString> &item : list)
30 addQueryItem(key: item.first, value: item.second);
31 }
32
33 QUrlQuery(const QUrlQuery &other);
34 QUrlQuery(QUrlQuery &&other) noexcept;
35 QUrlQuery &operator=(const QUrlQuery &other);
36 QT_MOVE_ASSIGNMENT_OPERATOR_IMPL_VIA_PURE_SWAP(QUrlQuery)
37 ~QUrlQuery();
38
39#if QT_CORE_REMOVED_SINCE(6, 8)
40 bool operator==(const QUrlQuery &other) const;
41 bool operator!=(const QUrlQuery &other) const
42 { return !operator==(other); }
43#endif
44
45 void swap(QUrlQuery &other) noexcept { d.swap(other&: other.d); }
46
47 bool isEmpty() const;
48 bool isDetached() const;
49 void clear();
50
51 QString query(QUrl::ComponentFormattingOptions encoding = QUrl::PrettyDecoded) const;
52 void setQuery(const QString &queryString);
53 QString toString(QUrl::ComponentFormattingOptions encoding = QUrl::PrettyDecoded) const
54 { return query(encoding); }
55
56 void setQueryDelimiters(QChar valueDelimiter, QChar pairDelimiter);
57 QChar queryValueDelimiter() const;
58 QChar queryPairDelimiter() const;
59
60 void setQueryItems(const QList<std::pair<QString, QString> > &query);
61 QList<std::pair<QString, QString> > queryItems(QUrl::ComponentFormattingOptions encoding = QUrl::PrettyDecoded) const;
62
63 bool hasQueryItem(const QString &key) const;
64 void addQueryItem(const QString &key, const QString &value);
65 void removeQueryItem(const QString &key);
66 QString queryItemValue(const QString &key, QUrl::ComponentFormattingOptions encoding = QUrl::PrettyDecoded) const;
67 QStringList allQueryItemValues(const QString &key, QUrl::ComponentFormattingOptions encoding = QUrl::PrettyDecoded) const;
68 void removeAllQueryItems(const QString &key);
69
70 static constexpr char16_t defaultQueryValueDelimiter() noexcept { return u'='; }
71 static constexpr char16_t defaultQueryPairDelimiter() noexcept { return u'&'; }
72
73private:
74 friend Q_CORE_EXPORT bool comparesEqual(const QUrlQuery &lhs, const QUrlQuery &rhs);
75 Q_DECLARE_EQUALITY_COMPARABLE_NON_NOEXCEPT(QUrlQuery)
76 friend class QUrl;
77 friend Q_CORE_EXPORT size_t qHash(const QUrlQuery &key, size_t seed) noexcept;
78 QSharedDataPointer<QUrlQueryPrivate> d;
79
80public:
81 typedef QSharedDataPointer<QUrlQueryPrivate> DataPtr;
82 inline DataPtr &data_ptr() { return d; }
83};
84
85Q_DECLARE_SHARED(QUrlQuery)
86
87QT_END_NAMESPACE
88
89#endif // QURLQUERY_H
90

source code of qtbase/src/corelib/io/qurlquery.h