| Home | Libraries | People | FAQ | More

###### http::message::set (1 of 4 overloads)

(Inherited from `http::basic_fields`)

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

###### Synopsis

    void
    set(
        field name,
        string_view value);

###### Description

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

###### Parameters

Name | Description
--- | ---
`name` | The field name.
`value` | The field value.

###### Exceptions

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