Function encode_from_utf8 

pub fn encode_from_utf8(
    input: &str,
    encoding: Encoding,
    dst: &mut Vec<u8>,
) -> Result<(), EncodeError>

Encode input into encoding, appending the resulting bytes to dst.

Encoding::Utf8 and the two UTF-16 variants can represent every Rust char (i.e. every Unicode scalar value) and therefore never fail. Encoding::Latin1, Encoding::Windows1252 and Encoding::Ascii can only represent a subset of Unicode; the first character outside that subset is reported as an EncodeError. Characters encoded before the failing one have already been appended to dst, so partial output is available even after an error (useful for producing a best-effort diagnostic, or for switching strategies — e.g. falling back to a numeric character reference — and resuming from error.position).

Errors

Returns EncodeError if input contains a character with no representation in encoding.

Examples

use oxixml_encoding::{encode_from_utf8, Encoding};

let mut dst = Vec::new();
encode_from_utf8("café", Encoding::Latin1, &mut dst).expect("café is representable in Latin-1");
assert_eq!(dst, b"caf\xE9");

let mut dst = Vec::new();
let err = encode_from_utf8("日本語", Encoding::Ascii, &mut dst).unwrap_err();
assert_eq!(err.character, '日');
assert_eq!(err.position, 0);