Function stfu8::encode_u16_pretty

pub fn encode_u16_pretty(v: &[u16]) -> String

Encode UTF-16 as STFU-8, escaping all non-printable or ill-formed UTF-16 characters EXCEPT:

• \t: tab
• \n: line feed
• \r: cariage return

This will allow the encoded text to print “pretilly” while still escaping invalid unicode and other non-printable characters.

Also check out:

• encode_u16
• decode_u16

Examples

let mut ill: Vec<u16> = "fooÿ\nbar"
    .encode_utf16()
    .collect();

// Make it ill formed UTF-16
ill.push(0xD800);       // surrogate pair lead
ill.push(b' ' as u16);  // NOT a trail
ill.push(0xDEED);       // Trail... with no lead
ill.push(b' ' as u16);
ill.push(0xDABA);       // lead... but end of str
let encoded = stfu8::encode_u16_pretty(ill.as_slice());

// Note that 0xFF is the valid character "ÿ"
// and the ill-formed characters are escaped.
assert_eq!(
    encoded,
    "fooÿ\nbar\\u00D800 \\u00DEED \\u00DABA"
);