Represents a parsed URL with individual string components. 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
std::string	get_origin () const override
std::string	get_protocol () const
std::string	get_host () const
std::string	get_hostname () const
constexpr std::string_view	get_pathname () const noexcept
ada_really_inline size_t	get_pathname_length () const noexcept
std::string	get_search () const
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
std::string	get_hash () const
ada_really_inline bool	has_credentials () const noexcept
ada_really_inline ada::url_components	get_components () const noexcept
constexpr bool	has_hash () const noexcept override
constexpr bool	has_search () const noexcept override
Public Member Functions inherited from ada::url_base
virtual	~url_base ()=default
ada_really_inline constexpr 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)
ada::url	ada::parser::parse_url_impl (std::string_view, const ada::url *)
ada::url_aggregator	ada::parser::parse_url_impl (std::string_view, const ada::url_aggregator *)

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

Represents a parsed URL with individual string components.

The url struct stores each URL component (scheme, username, password, host, port, path, query, fragment) as a separate std::string. This provides flexibility but incurs more memory allocations compared to url_aggregator.

When to use ada::url:

When you need to frequently modify individual URL components
When you want independent ownership of component strings

When to use ada::url_aggregator instead:

For read-mostly operations on parsed URLs
When memory efficiency is important
When you only need string_view access to components

Note: This type is returned when parsing with ada::parse<ada::url>(). By default, ada::parse() returns ada::url_aggregator.

See also: url_aggregator For a more memory-efficient URL representation; https://url.spec.whatwg.org/#url-representation

Definition at line 62 of file url.h.

Constructor & Destructor Documentation

◆ url() [1/3]

ada::url::url ( )

default

Referenced by ada::helpers::strip_trailing_spaces_from_opaque_path, ada::parser::parse_url, ada::parser::parse_url_impl, operator=(), operator=(), url(), and url().

◆ url() [2/3]

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

default

References url().

◆ url() [3/3]

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

defaultnoexcept

References url().

◆ ~url()

ada::url::~url ( )

overridedefault

Member Function Documentation

◆ get_components()

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

nodiscardnoexcept

Returns the URL component offsets for efficient serialization.

The components represent byte offsets into the serialized URL:

https://user:pass@example.com:1234/foo/bar?baz#quux
      |     |    |          | ^^^^|       |   |
      |     |    |          | |   |       |   `----- hash_start
      |     |    |          | |   |       `--------- search_start
      |     |    |          | |   `----------------- pathname_start
      |     |    |          | `--------------------- port
      |     |    |          `----------------------- host_end
      |     |    `---------------------------------- host_start
      |     `--------------------------------------- username_end
      `--------------------------------------------- protocol_end

Returns: A newly constructed url_components struct.

See also: https://github.com/servo/rust-url

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

References ada_really_inline, get_protocol(), get_search(), has_credentials(), ada::url_base::has_opaque_path, ada::url_components::hash_start, ada::url_components::host_end, ada::url_components::host_start, ada::url_components::pathname_start, ada::url_components::port, ada::url_components::protocol_end, ada::url_components::search_start, and ada::url_components::username_end.

◆ get_hash()

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

nodiscard

Returns the URL's fragment prefixed with '#' (e.g., "#section"). Returns empty string if no fragment is set.

Returns: A newly allocated string with the hash.

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

Definition at line 678 of file url.cpp.

◆ get_host()

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

nodiscard

Returns the URL's host and port (e.g., "example.com:8080"). If no port is set, returns just the host. Returns empty string if no host.

Returns: A newly allocated string with host:port.

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

Definition at line 641 of file url.cpp.

References get_port().

Referenced by get_origin().

◆ get_hostname()

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

nodiscard

Returns the URL's hostname (without port). Returns empty string if no host is set.

Returns: A newly allocated string with the hostname.

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

Definition at line 655 of file url.cpp.

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

◆ get_href()

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

nodiscard

Returns the full serialized URL (the href).

Returns: The complete URL string (allocates a new string).

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

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

References ada_really_inline, get_password(), get_port(), get_protocol(), has_credentials(), and ada::url_base::has_opaque_path.

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

◆ get_origin()

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

nodiscardoverridevirtual

Returns the URL's origin as a string (scheme + host + port for special URLs).

Returns: A newly allocated string containing the serialized origin.

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

Implements ada::url_base.

Definition at line 607 of file url.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

nodiscardnoexcept

Returns the URL's password component.

Returns: A constant reference to the password string.

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

Definition at line 670 of file url.cpp.

Referenced by get_href().

◆ get_pathname()

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

nodiscardconstexprnoexcept

Returns the URL's path component.

Returns: A string_view pointing to the path.

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

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

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

◆ get_pathname_length()

size_t ada::url::get_pathname_length ( ) const

nodiscardnoexcept

Returns the byte length of the pathname without creating 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

nodiscard

Returns the URL's port as a string (e.g., "8080"). Returns empty string if no port is set.

Returns: A newly allocated string with the port.

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

Definition at line 674 of file url.cpp.

Referenced by get_host(), and get_href().

◆ get_protocol()

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

nodiscard

Returns the URL's scheme followed by a colon (e.g., "https:").

Returns: A newly allocated string with the protocol.

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

Definition at line 633 of file url.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_impl(), and to_string().

◆ get_search()

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

nodiscard

Returns the URL's query string prefixed with '?' (e.g., "?foo=bar"). Returns empty string if no query is set.

Returns: A newly allocated string with the search/query.

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

Definition at line 659 of file url.cpp.

Referenced by get_components().

◆ get_username()

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

nodiscardnoexcept

Returns the URL's username component.

Returns: A constant reference to the username string.

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

Definition at line 666 of file url.cpp.

◆ has_credentials()

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

nodiscardnoexcept

Checks if the URL has credentials (non-empty username or password).

Returns: true if username or password is non-empty, false otherwise.

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

References ada_really_inline.

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

◆ has_empty_hostname()

bool ada::url::has_empty_hostname ( ) const

inlinenodiscardnoexcept

Checks if the URL has an empty hostname (host is set but empty string).

Returns: true if host exists but is empty, false otherwise.

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

◆ has_hash()

bool ada::url::has_hash ( ) const

nodiscardconstexproverridevirtualnoexcept

Checks if the URL has a fragment/hash component.

Returns: true if hash is present, false otherwise.

Implements ada::url_base.

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

◆ has_hostname()

bool ada::url::has_hostname ( ) const

inlinenodiscardnoexcept

Checks if the URL has a hostname (including empty hostnames).

Returns: true if host is present, false otherwise.

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

◆ has_port()

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

inlinenodiscardnoexcept

Checks if the URL has a non-default port explicitly specified.

Returns: true if a port is present, false otherwise.

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

References ada_really_inline.

◆ has_search()

bool ada::url::has_search ( ) const

nodiscardconstexproverridevirtualnoexcept

Checks if the URL has a query/search component.

Returns: true if query is present, false otherwise.

Implements ada::url_base.

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

Referenced by to_string().

◆ has_valid_domain()

bool ada::url::has_valid_domain ( ) const

nodiscardoverridevirtualnoexcept

Validates whether the hostname is a valid domain according to RFC 1034. Checks that the domain and its labels have valid lengths (max 255 octets total, max 63 octets per label).