Generic URL struct reliant on std::string instantiation. More...

#include <url.h>

Inheritance diagram for ada::url:

Public Member Functions
	url ()=default

	url (const url &u)=default

	url (url &&u) noexcept=default

url &	operator= (url &&u) noexcept=default

url &	operator= (const url &u)=default

	~url () override=default

bool	has_empty_hostname () const noexcept

bool	has_port () const noexcept

bool	has_hostname () const noexcept

bool	has_valid_domain () const noexcept override

std::string	to_string () const override

ada_really_inline std::string	get_href () const noexcept

std::string	get_origin () const noexcept override

std::string	get_protocol () const noexcept

std::string	get_host () const noexcept

std::string	get_hostname () const noexcept

std::string_view	get_pathname () const noexcept

ada_really_inline size_t	get_pathname_length () const noexcept

std::string	get_search () const noexcept

const std::string &	get_username () const noexcept

bool	set_username (std::string_view input)

bool	set_password (std::string_view input)

bool	set_port (std::string_view input)

void	set_hash (std::string_view input)

void	set_search (std::string_view input)

bool	set_pathname (std::string_view input)

bool	set_host (std::string_view input)

bool	set_hostname (std::string_view input)

bool	set_protocol (std::string_view input)

bool	set_href (std::string_view input)

const std::string &	get_password () const noexcept

std::string	get_port () const noexcept

std::string	get_hash () const noexcept

ada_really_inline bool	has_credentials () const noexcept

ada_really_inline ada::url_components	get_components () const noexcept

bool	has_hash () const noexcept override

bool	has_search () const noexcept override

Public Member Functions inherited from ada::url_base
virtual	~url_base ()=default

ada_really_inline bool	is_special () const noexcept

Friends
ada::url	ada::parser::parse_url (std::string_view, const ada::url *)

ada::url_aggregator	ada::parser::parse_url (std::string_view, const ada::url_aggregator *)

void	ada::helpers::strip_trailing_spaces_from_opaque_path (ada::url &url) noexcept

Additional Inherited Members
Public Attributes inherited from ada::url_base
bool	is_valid {true}

bool	has_opaque_path {false}

url_host_type	host_type = url_host_type::DEFAULT

Detailed Description

Generic URL struct reliant on std::string instantiation.

To disambiguate from a valid URL string it can also be referred to as a URL record. A URL is a struct that represents a universal identifier. Unlike the url_aggregator, the ada::url represents the different components of a parsed URL as independent std::string instances. This makes the structure heavier and more reliant on memory allocations. When getting components from the parsed URL, a new std::string is typically constructed.

See also: https://url.spec.whatwg.org/#url-representation

Definition at line 38 of file url.h.

Constructor & Destructor Documentation

◆ url() [1/3]

ada::url::url ( )

default

◆ url() [2/3]

ada::url::url ( const url & u )

default

◆ url() [3/3]

ada::url::url ( url && u )

defaultnoexcept

◆ ~url()

ada::url::~url ( )

overridedefault

Member Function Documentation

◆ get_components()

ada_really_inline ada::url_components ada::url::get_components ( ) const

noexcept

Useful for implementing efficient serialization for the URL.

Inspired after servo/url

Returns: a newly constructed component.

See also: https://github.com/servo/rust-url/blob/b65a45515c10713f6d212e6726719a020203cc98/url/src/quirks.rs#L31

Definition at line 46 of file url-inl.h.

References ada::checkers::begins_with(), get_protocol(), get_search(), has_credentials(), ada::url_base::has_opaque_path, ada::parse(), and ada::url_components::protocol_end.

◆ get_hash()

std::string ada::url::get_hash ( ) const

noexcept

Return U+0023 (#), followed by this's URL's fragment.

Returns: a newly constructed string representing the hash.

See also: https://url.spec.whatwg.org/#dom-url-hash

Definition at line 89 of file url-getters.cpp.

◆ get_host()

std::string ada::url::get_host ( ) const

noexcept

Return url's host, serialized, followed by U+003A (:) and url's port, serialized. When there is no host, this function returns the empty string.

Returns: a newly allocated string.

See also: https://url.spec.whatwg.org/#dom-url-host

Definition at line 48 of file url-getters.cpp.

References get_port().

Referenced by get_origin().

◆ get_hostname()

std::string ada::url::get_hostname ( ) const

noexcept

Return this's URL's host, serialized. When there is no host, this function returns the empty string.

Returns: a newly allocated string.

See also: https://url.spec.whatwg.org/#dom-url-hostname

Definition at line 62 of file url-getters.cpp.

Referenced by ada::parser::parse_url().

◆ get_href()

ada_really_inline std::string ada::url::get_href ( ) const

noexcept

See also: https://url.spec.whatwg.org/#dom-url-href; https://url.spec.whatwg.org/#concept-url-serializer

Definition at line 183 of file url-inl.h.

References ada::checkers::begins_with(), get_password(), get_port(), get_protocol(), has_credentials(), ada::url_base::has_opaque_path, and ada::parse().

Referenced by ada::parser::parse_url().

◆ get_origin()

std::string ada::url::get_origin ( ) const

overridevirtualnoexcept

The origin getter steps are to return the serialization of this's URL's origin. [HTML]

Returns: a newly allocated string.

See also: https://url.spec.whatwg.org/#concept-url-origin

Implements ada::url_base.

Definition at line 14 of file url-getters.cpp.

References ada::scheme::FILE, get_host(), get_protocol(), ada::scheme::HTTP, ada::scheme::HTTPS, ada::url_base::is_special(), and ada::parse().

◆ get_password()

const std::string & ada::url::get_password ( ) const

noexcept

The password getter steps are to return this's URL's password.

Returns: a constant reference to the underlying string.

See also: https://url.spec.whatwg.org/#dom-url-password

Definition at line 81 of file url-getters.cpp.

Referenced by get_href().

◆ get_pathname()

std::string_view ada::url::get_pathname ( ) const

noexcept

The pathname getter steps are to return the result of URL path serializing this's URL.

Returns: a newly allocated string.

See also: https://url.spec.whatwg.org/#dom-url-pathname

Definition at line 66 of file url-getters.cpp.

Referenced by ada::parser::parse_url().

◆ get_pathname_length()

size_t ada::url::get_pathname_length ( ) const

noexcept

Compute the pathname length in bytes without instantiating a view or a string.

Returns: size of the pathname in bytes

See also: https://url.spec.whatwg.org/#dom-url-pathname

Definition at line 42 of file url-inl.h.

◆ get_port()

std::string ada::url::get_port ( ) const

noexcept

Return this's URL's port, serialized.

Returns: a newly constructed string representing the port.

See also: https://url.spec.whatwg.org/#dom-url-port

Definition at line 85 of file url-getters.cpp.

Referenced by get_host(), and get_href().

◆ get_protocol()

std::string ada::url::get_protocol ( ) const

noexcept

The protocol getter steps are to return this's URL's scheme, followed by U+003A (:).

Returns: a newly allocated string.

See also: https://url.spec.whatwg.org/#dom-url-protocol

Definition at line 40 of file url-getters.cpp.

References ada::url_base::is_special(), and ada::scheme::details::is_special_list.

Referenced by get_components(), get_href(), get_origin(), ada::parser::parse_url(), and to_string().

◆ get_search()

std::string ada::url::get_search ( ) const

noexcept

Return U+003F (?), followed by this's URL's query.

Returns: a newly allocated string.

See also: https://url.spec.whatwg.org/#dom-url-search

Definition at line 70 of file url-getters.cpp.

Referenced by get_components().

◆ get_username()

const std::string & ada::url::get_username ( ) const

noexcept

The username getter steps are to return this's URL's username.

Returns: a constant reference to the underlying string.

See also: https://url.spec.whatwg.org/#dom-url-username

Definition at line 77 of file url-getters.cpp.

◆ has_credentials()

ada_really_inline bool ada::url::has_credentials ( ) const

noexcept

A URL includes credentials if its username or password is not the empty string.

Definition at line 19 of file url-inl.h.

Referenced by get_components(), get_href(), and to_string().

◆ has_empty_hostname()

bool ada::url::has_empty_hostname ( ) const

inlinenoexcept

Returns: true if it has an host but it is the empty string

Definition at line 29 of file url-inl.h.

◆ has_hash()

bool ada::url::has_hash ( ) const

inlineoverridevirtualnoexcept

Returns: true if the URL has a hash component

Implements ada::url_base.

Definition at line 155 of file url-inl.h.

◆ has_hostname()

bool ada::url::has_hostname ( ) const

inlinenoexcept

Returns: true if it has a host (included an empty host)

Definition at line 35 of file url-inl.h.

◆ has_port()

ada_really_inline bool ada::url::has_port ( ) const

inlinenoexcept

Returns: true if the URL has a (non default) port

Definition at line 22 of file url-inl.h.

◆ has_search()

bool ada::url::has_search ( ) const

inlineoverridevirtualnoexcept

Returns: true if the URL has a search component

Implements ada::url_base.

Definition at line 159 of file url-inl.h.

Referenced by to_string().

◆ has_valid_domain()

bool ada::url::has_valid_domain ( ) const

overridevirtualnoexcept

Returns true if this URL has a valid domain as per RFC 1034 and corresponding specifications. Among other things, it requires that the domain string has fewer than 255 octets.

Implements ada::url_base.

Definition at line 585 of file url.cpp.