Text of rust.docs.kernel.org › core › char › index.html as Styx crawled it on Nov 19, 2026. The page may have changed since. Only its words are kept, without pictures or layout.

Open the live page

core::char - Rust

Skip to main content Module char core Module char 1.6.0 · Source Expand description Utilities for the char primitive type. See also the char primitive type . The char type represents a single character. More specifically, since ‘character’ isn’t a well-defined concept in Unicode, char is a ‘ Unicode scalar value ’, which is similar to, but not the same as, a ‘ Unicode code point ’. This module exists for technical reasons, the primary documentation for char is directly on the char primitive type itself.

This module is the home of the iterator implementations for the iterators implemented on char , as well as some useful constants and conversion functions that convert various types to char . Structs § Char TryFrom Error The error type returned when a conversion from u32 to char fails. Decode Utf16 An iterator that decodes UTF-16 encoded code points from an iterator of u16 s. Decode Utf16 Error An error that can be returned when decoding UTF-16 code points.

Escape Debug An iterator that yields the literal escape code of a char . Escape Default An iterator that yields the literal escape code of a char . Escape Unicode Returns an iterator that yields the hexadecimal Unicode escape of a character, as char s. Parse Char Error An error which can be returned when parsing a char. ToLowercase Returns an iterator that yields the lowercase equivalent of a char . ToUppercase Returns an iterator that yields the uppercase equivalent of a char .

TryFrom Char Error The error type returned when a checked char conversion fails. ToCasefold Experimental Returns an iterator that yields the case-folded equivalent of a char . ToTitlecase Experimental Returns an iterator that yields the titlecase equivalent of a char . Enums § Char Case Experimental The case of a cased character, as returned by char::case . Constants § MAX Deprecation planned The highest valid code point a char can have, '\u{10FFFF}' .

Use char::MAX instead. REPLACEMENT_ CHARACTER Deprecation planned U+FFFD REPLACEMENT CHARACTER (�) is used in Unicode to represent a decoding error. Use char::REPLACEMENT_CHARACTER instead. UNICODE_ VERSION Deprecation planned The version of Unicode that the Unicode parts of char and str methods are based on. Use char::UNICODE_VERSION instead. Functions § decode_ utf16 Deprecation planned Creates an iterator over the UTF-16 encoded code points in iter , returning unpaired surrogates as Err s.

Use char::decode_utf16 instead. from_ digit Deprecation planned Converts a digit in the given radix to a char . Use char::from_digit instead. from_ u32 Deprecation planned Converts a u32 to a char . Use char::from_u32 instead. from_ u32_ unchecked ⚠ Deprecation planned Converts a u32 to a char , ignoring validity. Use char::from_u32_unchecked instead.