Module char

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.

Re-exports

pub use self::convert::CharTryFromError;

pub use self::convert::ParseCharError;

pub use self::decode::DecodeUtf16;

pub use self::decode::DecodeUtf16Error;

pub use self::methods::encode_utf16_raw;Experimental

pub use self::methods::encode_utf8_raw;Experimental

pub use self::methods::encode_utf8_raw_unchecked;Experimental

Modules

convert 🔒

Character conversions.

decode 🔒

UTF-8 and UTF-16 decoding iterators

methods 🔒

impl char {}

Macros

casemappingiter_impls 🔒

Structs

CaseMappingIter 🔒

EscapeDebug

An iterator that yields the literal escape code of a char.

EscapeDefault

An iterator that yields the literal escape code of a char.

EscapeUnicode

Returns an iterator that yields the hexadecimal Unicode escape of a character, as chars.

ToLowercase

Returns an iterator that yields the lowercase equivalent of a char.

ToUppercase

Returns an iterator that yields the uppercase equivalent of a char.

TryFromCharError

The error type returned when a checked char conversion fails.

Enums

EscapeDebugInner 🔒

Constants

MAX

The highest valid code point a char can have, '\u{10FFFF}'. Use char::MAX instead.

MAX_ONE_B 🔒

MAX_THREE_B 🔒

MAX_TWO_B 🔒

REPLACEMENT_CHARACTER

U+FFFD REPLACEMENT CHARACTER (�) is used in Unicode to represent a decoding error. Use char::REPLACEMENT_CHARACTER instead.

TAG_CONT 🔒

TAG_FOUR_B 🔒

TAG_THREE_B 🔒

TAG_TWO_B 🔒

UNICODE_VERSION

The version of Unicode that the Unicode parts of char and str methods are based on. Use char::UNICODE_VERSION instead.

MAX_LEN_UTF8Experimental

The maximum number of bytes required to encode a char to UTF-8 encoding.

MAX_LEN_UTF16Experimental

The maximum number of two-byte units required to encode a char to UTF-16 encoding.

Functions

decode_utf16

Creates an iterator over the UTF-16 encoded code points in iter, returning unpaired surrogates as Errs. Use char::decode_utf16 instead.

from_digit

Converts a digit in the given radix to a char. Use char::from_digit instead.

from_u32

Converts a u32 to a char. Use char::from_u32 instead.

from_u32_unchecked^⚠

Converts a u32 to a char, ignoring validity. Use char::from_u32_unchecked instead.