1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
|
/**
* @file parser.h
* @brief Low-level URL parsing functions.
*
* This header provides the internal URL parsing implementation. Most users
* should use `ada::parse()` from implementation.h instead of these functions
* directly.
*
* @see implementation.h for the recommended public API
*/
#ifndef ADA_PARSER_H
#define ADA_PARSER_H
#include <string_view>
#include <variant>
#include "ada/expected.h"
#include "ada/url_pattern_regex.h"
#include "ada/url_pattern_init.h"
/** @private Forward declarations */
namespace ada {
struct url_aggregator;
struct url;
#if ADA_INCLUDE_URL_PATTERN
template <url_pattern_regex::regex_concept regex_provider>
class url_pattern;
struct url_pattern_options;
#endif // ADA_INCLUDE_URL_PATTERN
enum class errors : uint8_t;
} // namespace ada
/**
* @namespace ada::parser
* @brief Internal URL parsing implementation.
*
* Contains the core URL parsing algorithm as specified by the WHATWG URL
* Standard. These functions are used internally by `ada::parse()`.
*/
namespace ada::parser {
/**
* Parses a URL string into a URL object.
*
* @tparam result_type The type of URL object to create (url or url_aggregator).
*
* @param user_input The URL string to parse (must be valid UTF-8).
* @param base_url Optional base URL for resolving relative URLs.
*
* @return The parsed URL object. Check `is_valid` to determine if parsing
* succeeded.
*
* @see https://url.spec.whatwg.org/#concept-basic-url-parser
*/
template <typename result_type = url_aggregator>
result_type parse_url(std::string_view user_input,
const result_type* base_url = nullptr);
extern template url_aggregator parse_url<url_aggregator>(
std::string_view user_input, const url_aggregator* base_url);
extern template url parse_url<url>(std::string_view user_input,
const url* base_url);
template <typename result_type = url_aggregator, bool store_values = true>
result_type parse_url_impl(std::string_view user_input,
const result_type* base_url = nullptr);
extern template url_aggregator parse_url_impl<url_aggregator>(
std::string_view user_input, const url_aggregator* base_url);
extern template url parse_url_impl<url>(std::string_view user_input,
const url* base_url);
#if ADA_INCLUDE_URL_PATTERN
template <url_pattern_regex::regex_concept regex_provider>
tl::expected<url_pattern<regex_provider>, errors> parse_url_pattern_impl(
std::variant<std::string_view, url_pattern_init>&& input,
const std::string_view* base_url, const url_pattern_options* options);
#endif // ADA_INCLUDE_URL_PATTERN
} // namespace ada::parser
#endif // ADA_PARSER_H
|
