Boost C++ Libraries Home Libraries People FAQ More

PrevUpHomeNext
url_base::set_port_number

Set the port.

Synopsis
url_base&
set_port_number(
    std::uint16_t n);
Description

The port is set to the specified integer.

Example
assert( [link url.ref.boost__urls__url_base.url `url`]( "http://www.example.com" ).[link url.ref.boost__urls__url_base.set_port_number `set_port_number`]( 8080 ).[link url.ref.boost__urls__url_base.authority `authority`]().[link url.ref.boost__urls__url_base.buffer `buffer`]() == "www.example.com:8080" );
Postconditions
this->[link url.ref.boost__urls__url_base.has_authority `has_authority`]() == true && this->[link url.ref.boost__urls__url_base.has_port `has_port`]() == true && this->[link url.ref.boost__urls__url_base.port_number `port_number`]() == n
Complexity

Linear in this->size().

Exception Safety

Strong guarantee. Calls to allocate may throw.

Parameters

Name

Description

n

The port number to set.

BNF
[link url.ref.boost__urls__url_base.authority `authority`]     = [ [link url.ref.boost__urls__url_base.userinfo `userinfo`] "@" ] [link url.ref.boost__urls__url_base.host `host`] [ ":" [link url.ref.boost__urls__url_base.port `port`] ]

[link url.ref.boost__urls__url_base.port `port`]          = *DIGIT
Specification
See Also

remove_port, set_port.


PrevUpHomeNext