http::message::set (3 of 4 overloads)

Set a field value, removing any other instances of that field.

void
set(
    string_view name,
    string_view value);

First removes any values with matching field names, then inserts the new field value. The value can be an empty string.

Name	Description
`name`	The field name. It is interpreted as a case-insensitive string.
`value`	The field value.

Type	Thrown On
`boost::system::system_error`	Thrown if an error occurs: If the size of `name` exceeds max_name_size, the error code will be error::header_field_name_too_large. If the size of `value` exceeds max_value_size, the error code will be error::header_field_value_too_large.

Boost C++ Libraries