A non-owning reference to a valid authority
| Name | Description |
|---|---|
authority_view [constructor] | Constructors |
~authority_view [destructor] [virtual] | Destructor |
operator= | Assignment |
buffer | Return the complete authority |
compare | Return the result of comparing this with another authority |
data | Return a pointer to the first character |
empty | Return true if the authority is empty |
encoded_host | Return the host |
encoded_host_address | Return the host |
encoded_host_and_port | Return the host and port |
encoded_host_name | Return the host name |
encoded_password | Return the password |
encoded_user | Return the user |
encoded_userinfo | Return the userinfo |
has_password | Return true if a password is present |
has_port | Return true if a port is present |
has_userinfo | Return true if a userinfo is present |
host | Return the host |
host_address | Return the host |
host_ipv4_address | Return the host IPv4 address |
host_ipv6_address | Return the host IPv6 address |
host_ipvfuture | Return the host IPvFuture address |
host_name | Return the host name |
host_type | Return the host type |
password | Return the password |
port | Return the port |
port_number | Return the port |
size | Return the number of characters in the authority |
user | Return the user |
userinfo | Return the userinfo |
| Name | Description |
|---|---|
operator<< |
Format the encoded authority to the output stream |
operator>= |
Return the result of comparing two authorities. The authorities are compared component by component as if they were first normalized. |
operator> |
Return the result of comparing two authorities. The authorities are compared component by component as if they were first normalized. |
operator<= |
Return the result of comparing two authorities. The authorities are compared component by component as if they were first normalized. |
operator< |
Return the result of comparing two authorities. The authorities are compared component by component as if they were first normalized. |
operator!= |
Return the result of comparing two authorities. The authorities are compared component by component as if they were first normalized. |
operator== |
Return the result of comparing two authorities. The authorities are compared component by component as if they were first normalized. |
| Name | Description |
|---|---|
parse_authority | Parse an authority |
Objects of this type represent valid authority strings constructed from a parsed, external character buffer whose storage is managed by the caller. That is, it acts like a core::string_view in terms of ownership. The caller is responsible for ensuring that the lifetime of the underlying character buffer extends until it is no longer referenced.
Construction from a string parses the input as an authority and throws an exception on error. Upon success, the constructed object points to the passed character buffer; ownership is not transferred.
authority_view a( "user:pass@www.example.com:8080" );
The parsing function parse_authority returns a boost::system::result containing either a valid authority_view upon success, otherwise it contains an error. The error can be converted to an exception by the caller if desired:
system::result< authority_view > rv = parse_authority( "user:pass@www.example.com:8080" );
authority = [ userinfo "@" ] host [ ":" port ]
userinfo = user [ ":" [ password ] ]
user = *( unreserved / pct-encoded / sub-delims )
password = *( unreserved / pct-encoded / sub-delims / ":" )
host = IP-literal / IPv4address / reg-name
port = *DIGIT