websocketpp::close Namespace Reference

A package of types and methods for manipulating WebSocket close codes.

Namespaces
namespace	status
	A package of types and methods for manipulating WebSocket close status'.

Classes
union	code_converter
	Type used to convert close statuses between integer and wire representations. More...

Functions
status::value	extract_code (std::string const &payload, lib::error_code &ec)
	Extract a close code value from a close payload.
std::string	extract_reason (std::string const &payload, lib::error_code &ec)
	Extract the reason string from a close payload.

Function Documentation

extract_code()

status::value websocketpp::close::extract_code ( std::string const & payload, lib::error_code & ec )

inline

If there is no close value (ie string is empty) status::no_status is returned. If a code couldn't be extracted (usually do to a short or otherwise mangled payload) status::protocol_error is returned and the ec value is flagged as an error. Note that this case is different than the case where protocol error is received over the wire.

If the value is in an invalid or reserved range ec is set accordingly.

Parameters

[in]	payload	Close frame payload value received over the wire.
[out]	ec	Set to indicate what error occurred, if any.

Returns

The extracted value

Definition at line 283 of file close.hpp.

{
    ec = lib::error_code();
 
    if (payload.size() == 0) {
        return status::no_status;
    } else if (payload.size() == 1) {
        ec = make_error_code(error::bad_close_code);
        return status::protocol_error;
    }
 
    code_converter val;
 
    val.c[0] = payload[0];
    val.c[1] = payload[1];
 
    status::value code(ntohs(val.i));
 
    if (status::invalid(code)) {
        ec = make_error_code(error::invalid_close_code);
    }
 
    if (status::reserved(code)) {
        ec = make_error_code(error::reserved_close_code);
    }
 
    return code;
}

Here is the call graph for this function:

extract_reason()

std::string websocketpp::close::extract_reason ( std::string const & payload, lib::error_code & ec )

inline

The string should be a valid UTF8 message. error::invalid_utf8 will be set if the function extracts a reason that is not valid UTF8.

Parameters

[in]	payload	The payload string to extract a reason from.
[out]	ec	Set to indicate what error occurred, if any.

Returns

The reason string.

Definition at line 322 of file close.hpp.

{
    std::string reason;
    ec = lib::error_code();
 
    if (payload.size() > 2) {
        reason.append(payload.begin()+2,payload.end());
    }
 
    if (!websocketpp::utf8_validator::validate(reason)) {
        ec = make_error_code(error::invalid_utf8);
    }
 
    return reason;
}

Here is the call graph for this function: