Expand description
This module contains helper functions for encoding and decoding the bodies of HTTP requests and responses. There are two kinds of coding: text coding and content coding. Content coding changes the bytes of the body in order to represent it differently; for example, to compress the body to a smaller size. Text coding is how the bytes of the body are interpreted as text, and therefore how it can be converted to/from a Rust string.
Functionsยง
- decode_
body - Attempt to reverse any content coding that has been performed on the given
message body, as indicated in the given message headers. The content
codings that were performed on the body are listed in the
Content-Encoding
header, in the same order that the encoding was performed. Therefore, to decode the body, the decoding is performed in reverse order. Decoding is stopped if any unrecognized coding is encountered, or any error occurs during the decoding process. Any codings successfully decoded are removed from theContent-Encoding
header, and the header itself is removed if all codings are decoded. - decode_
body_ as_ text - Attempt to decode the given message body as text. This will only work if
the given headers for the message contain a
Content-Type
header where the type istext
, thecharset
parameter (iso-8859-1
is assumed ifcharset
is missing) is a text encoding recognized and supported by theencoding_rs
crate, and the text is successfully decoded.