encoding_rs::mem

Function encode_latin1_lossy

source
pub fn encode_latin1_lossy<'a>(string: &'a str) -> Cow<'a, [u8]>
Expand description

If the input is valid UTF-8 representing only Unicode code points from U+0000 to U+00FF, inclusive, converts the input into output that represents the value of each code point as the unsigned byte value of each output byte.

If the input does not fulfill the condition stated above, this function panics if debug assertions are enabled (and fuzzing isn’t) and otherwise does something that is memory-safe without any promises about any properties of the output. In particular, callers shouldn’t assume the output to be the same across crate versions or CPU architectures and should not assume that non-ASCII input can’t map to ASCII output.

Borrows if input is ASCII-only. Performs a single heap allocation otherwise.

Only available if the alloc feature is enabled (enabled by default).