Return the address as a string in dotted decimal format.

Synopsis

template<
    class StringToken = string_token::return_string>
StringToken::result_type
to_string(
    StringToken&& token = {}) const;

Description

When called with no arguments, the return type is std::string. Otherwise, the return type and style of output is determined by which string token is passed.

Example

assert( ipv4_address(0x01020304).to_string() == "1.2.3.4" );

Complexity

Constant.

Exception Safety

Strong guarantee. Calls to allocate may throw. String tokens may throw exceptions.

Return Value

The return type of the string token. If the token parameter is omitted, then a new std::string is returned. Otherwise, the function return type will be the result type of the token.

Parameters

Specification