Module std::char [] [src]

A character 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

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.

DecodeUtf16 [Unstable]

An iterator that decodes UTF-16 encoded code points from an iterator of u16s.

Constants

MAX

The highest valid code point a char can have.

REPLACEMENT_CHARACTER [Unstable]

U+FFFD REPLACEMENT CHARACTER (�) is used in Unicode to represent a decoding error. It can occur, for example, when giving ill-formed UTF-8 bytes to String::from_utf8_lossy.

UNICODE_VERSION [Unstable]

The version of Unicode that the unicode parts of CharExt and UnicodeStrPrelude traits are based on.

Functions

from_digit

Converts a digit in the given radix to a char.

from_u32

Converts a u32 to a char.

from_u32_unchecked

Converts a u32 to a char, ignoring validity.

decode_utf16 [Unstable]

Create an iterator over the UTF-16 encoded code points in iterable, returning unpaired surrogates as Errs.