Crate ascii [−] [src]

A library that provides ASCII-only string and character types, equivalent to the char, str and String types in the standard library.

This is the documentation for core mode. Please refer to the readme file to learn about the different feature modes of this crate.

# Requirements

The ascii library requires rustc 1.9.0 or greater, due to the stabilization of AsciiExt. Using only core instead of std in your project lowers this requirement to rustc 1.6.0 or greater.

# History

This package included the Ascii types that were removed from the Rust standard library by the 2014-12 reform of the std::ascii module. The API changed significantly since then.

Structs

AsAsciiStrError	Error that is returned when a sequence of `u8` are not all ASCII.
AsciiStr	AsciiStr represents a byte or string slice that only contains ASCII characters.
Lines	An iterator over the lines of the internal character array.
ToAsciiCharError	Error returned by `ToAsciiChar`.

Enums

AsciiChar

An ASCII character. It wraps a u8, with the highest bit always zero.

Traits

AsAsciiStr	Convert slices of bytes to `AsciiStr`.
AsMutAsciiStr	Convert mutable slices of bytes to `AsciiStr`.
ToAsciiChar	Convert `char`, `u8` and other character types to `AsciiChar`.

Functions

caret_decode	Returns the control code represented by a caret notation letter, or `None` if the letter is not used in caret notation.
caret_encode	Terminals use caret notation to display some typed control codes, such as ^D for EOT and ^Z for SUB.

Type Definitions

Chars	An immutable iterator over the characters of an `AsciiStr`.
CharsMut	A mutable iterator over the characters of an `AsciiStr`.