Method add

tornado/httputil.py:210–228

Adds a new value for the given key.

(self, name: str, value: str, *, _chars_are_bytes: bool = True)

    class="cm"># new public methods

    def add(self, name: str, value: str, *, _chars_are_bytes: bool = True) -> None:
        class="st">""class="st">"Adds a new value for the given key."class="st">""
        if not _ABNF.field_name.fullmatch(name):
            raise HTTPInputError(class="st">"Invalid header name %r" % name)
        if _chars_are_bytes:
            if not _ABNF.field_value.fullmatch(to_unicode(value)):
                class="cm"># TODO: the fact we still support bytes here (contrary to type annotations)
                class="cm"># and still test for it should probably be changed.
                raise HTTPInputError(class="st">"Invalid header value %r" % value)
        else:
            if _FORBIDDEN_HEADER_CHARS_RE.search(value):
                raise HTTPInputError(class="st">"Invalid header value %r" % value)
        norm_name = _normalize_header(name)
        self._last_key = norm_name
        if norm_name in self:
            self._combined_cache.pop(norm_name, None)
            self._as_list[norm_name].append(value)
        else:
            self[norm_name] = value

    def get_list(self, name: str) -> List[str]:
        class="st">""class="st">"Returns all values for the given header as a list."class="st">""