boost::urls::url_view_base::host_ipv6_address :: Boost Libraries Documentation

# boost::urls::url_view_base::host_ipv6_address

Return the host IPv6 address

## Synopsis

Declared in `<boost/url/url_view_base.hpp>`

    ipv6_address
    host_ipv6_address() const noexcept;

## Description

If the host type is `host_type::ipv6`, this function returns the address as a value of type `ipv6_address`. Otherwise, if the host type is not an IPv6 address, it returns a default‐constructed value which is equal to the unspecified address "0:0:0:0:0:0:0:0".

## Example

    assert( url_view( "ftp://[::1]/" ).host_ipv6_address() == ipv6_address( "::1" ) );

## Complexity

Constant.

## Exception Safety

Throws nothing.

## BNF

    IPv6address =                            6( h16 ":" ) ls32
                /                       "::" 5( h16 ":" ) ls32
                / [               h16 ] "::" 4( h16 ":" ) ls32
                / [ *1( h16 ":" ) h16 ] "::" 3( h16 ":" ) ls32
                / [ *2( h16 ":" ) h16 ] "::" 2( h16 ":" ) ls32
                / [ *3( h16 ":" ) h16 ] "::"    h16 ":"   ls32
                / [ *4( h16 ":" ) h16 ] "::"              ls32
                / [ *5( h16 ":" ) h16 ] "::"              h16
                / [ *6( h16 ":" ) h16 ] "::"

    ls32        = ( h16 ":" h16 ) / IPv4address
                ; least-significant 32 bits of address

    h16         = 1*4HEXDIG
                ; 16 bits of address represented in hexadecimal

## Specification

- 3.2.2. Host (rfc3986)

## Return Value

The IPv6 address as a value of type `ipv6_address`.

Created with MrDocs