| Home | Libraries | People | FAQ | More

###### http::message::insert (1 of 8 overloads)

(Inherited from `http::basic_fields`)

Insert a field.

###### Synopsis

    void
    insert(
        field name,
        string_view value);

###### Description

If one or more fields with the same name already exist, the new field will be inserted after the last field with the matching name, in serialization order. The value can 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.