Function url_base::set_port

Set the port

Synopsis

Declared in header <boost/url/url_base.hpp>

url_base&
set_port(core::string_view s);

Description

This port is set to the string, which must contain only digits or be empty. An empty port string is distinct from having no port.

Example

assert( url( "http://www.example.com" ).set_port( "8080" ).authority().buffer() == "www.example.com:8080" );

Postconditions

this->has_port() == true && this->port_number() == n && this->port() == std::to_string(n)

Exception Safety

Strong guarantee. Calls to allocate may throw. Exceptions thrown on invalid input.

BNF

port          = *DIGIT

Specification

Exceptions

Name Thrown on

system_error

s does not contain a valid port.

Parameters

Name Description

s

The port string to set.