Ada 4.1.1
Fast spec-compliant URL parser
Loading...
Searching...
No Matches
url_search_params.h
Go to the documentation of this file.
1
11#ifndef ADA_URL_SEARCH_PARAMS_H
12#define ADA_URL_SEARCH_PARAMS_H
13
14#include <cstddef>
15#include <optional>
16#include <string>
17#include <string_view>
18#include <utility>
19#include <vector>
20
21namespace ada {
22
31
32template <typename T, url_search_params_iter_type Type>
33struct url_search_params_iter;
34
36typedef std::pair<std::string_view, std::string_view> key_value_view_pair;
37
43 url_search_params_iter<std::string_view,
49
67 url_search_params() = default;
68
74 explicit url_search_params(const std::string_view input) {
75 initialize(input);
76 }
77
79 url_search_params(url_search_params&& u) noexcept = default;
82 ~url_search_params() = default;
83
88 [[nodiscard]] inline size_t size() const noexcept;
89
96 inline void append(std::string_view key, std::string_view value);
97
103 inline void remove(std::string_view key);
104
110 inline void remove(std::string_view key, std::string_view value);
111
118 inline std::optional<std::string_view> get(std::string_view key);
119
126 inline std::vector<std::string> get_all(std::string_view key);
127
134 inline bool has(std::string_view key) noexcept;
135
142 inline bool has(std::string_view key, std::string_view value) noexcept;
143
150 inline void set(std::string_view key, std::string_view value);
151
156 inline void sort();
157
163 inline std::string to_string() const;
164
172
179
186
191 inline auto begin() const { return params.begin(); }
192 inline auto end() const { return params.end(); }
193 inline auto front() const { return params.front(); }
194 inline auto back() const { return params.back(); }
195 inline auto operator[](size_t index) const { return params[index]; }
196
203 void reset(std::string_view input);
204
205 private:
206 typedef std::pair<std::string, std::string> key_value_pair;
207 std::vector<key_value_pair> params{};
208
213 void initialize(std::string_view init);
214
215 template <typename T, url_search_params_iter_type Type>
217}; // url_search_params
218
230template <typename T, url_search_params_iter_type Type>
232 inline url_search_params_iter() : params(EMPTY) {}
236 default;
239
244 inline std::optional<T> next();
245
250 inline bool has_next() const;
251
252 private:
253 static url_search_params EMPTY;
254 inline url_search_params_iter(url_search_params& params_) : params(params_) {}
255
256 url_search_params& params;
257 size_t pos = 0;
258
259 friend struct url_search_params;
260};
261
262} // namespace ada
263#endif
url_search_params_iter< key_value_view_pair, url_search_params_iter_type::ENTRIES > url_search_params_entries_iter
url_search_params_iter< std::string_view, url_search_params_iter_type::KEYS > url_search_params_keys_iter
url_search_params_iter_type
Iterator types for url_search_params iteration.
std::pair< std::string_view, std::string_view > key_value_view_pair
url_search_params_iter< std::string_view, url_search_params_iter_type::VALUES > url_search_params_values_iter
JavaScript-style iterator for url_search_params.
url_search_params_iter(const url_search_params_iter &u)=default
url_search_params_iter & operator=(url_search_params_iter &&u) noexcept=default
std::optional< T > next()
url_search_params_iter(url_search_params_iter &&u) noexcept=default
url_search_params_iter & operator=(const url_search_params_iter &u)=default
Class for parsing and manipulating URL query strings.
void set(std::string_view key, std::string_view value)
std::vector< std::string > get_all(std::string_view key)
void remove(std::string_view key)
url_search_params(const url_search_params &u)=default
url_search_params(url_search_params &&u) noexcept=default
friend struct url_search_params_iter
auto operator[](size_t index) const
url_search_params_entries_iter get_entries()
std::string to_string() const
url_search_params & operator=(url_search_params &&u) noexcept=default
url_search_params_keys_iter get_keys()
size_t size() const noexcept
url_search_params & operator=(const url_search_params &u)=default
void append(std::string_view key, std::string_view value)
url_search_params(const std::string_view input)
url_search_params_values_iter get_values()
~url_search_params()=default
std::optional< std::string_view > get(std::string_view key)
bool has(std::string_view key) noexcept