description

# add method Null safety

void add (

1. String name,
2. Object value,
3. {@Since("2.8") bool preserveHeaderCase: false}

)

Adds a header value.

The header named `name` will have a string value derived from `value` added to its list of values.

Some headers are single valued, and for these, adding a value will replace a previous value. If the `value` is a DateTime, an HTTP date format will be applied. If the value is an Iterable, each element will be added separately. For all other types the default Object.toString method will be used.

Header names are converted to lower-case unless `preserveHeaderCase` is set to true. If two header names are the same when converted to lower-case, they are considered to be the same header, with one set of values.

The current case of the a header name is that of the name used by the last set or add call for that header.

## Implementation

    void add(String name, Object value,
        {@Since("2.8") bool preserveHeaderCase = false});