boost::urls::url::set_port :: Boost Libraries Documentation

# boost::urls::url::set_port

Set the port

## Synopsis

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

    url&
    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

- 3.2.3. Port (rfc3986)

## Return Value

`*this`

## Parameters

Name | Description
--- | ---
s | The port string to set.

## See Also

`remove_port`, `set_port`.

Created with MrDocs