Function rustc_unicode::char::from_u32_unchecked [] [src]

pub unsafe fn from_u32_unchecked(i: u32) -> char
1.5.0

Converts a u32 to a char, ignoring validity.

Note that all chars are valid u32s, and can be casted to one with as:

fn main() { let c = '💯'; let i = c as u32; assert_eq!(128175, i); }
let c = '💯';
let i = c as u32;

assert_eq!(128175, i);

However, the reverse is not true: not all valid u32s are valid chars. from_u32_unchecked() will ignore this, and blindly cast to char, possibly creating an invalid one.

Safety

This function is unsafe, as it may construct invalid char values.

For a safe version of this function, see the from_u32() function.

Examples

Basic usage:

fn main() { use std::char; let c = unsafe { char::from_u32_unchecked(0x2764) }; assert_eq!('❤', c); }
use std::char;

let c = unsafe { char::from_u32_unchecked(0x2764) };

assert_eq!('❤', c);