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

Types and conversion traits are described in the Documentation.

You can include this crate in your cargo project by adding it to the dependencies section in Cargo.toml:

[dependencies]
ascii = "1.1"

Most of AsciiChar and AsciiStr can be used without std by disabling the default features. The owned string type AsciiString and the conversion trait IntoAsciiString as well as all methods referring to these types can be re-enabled by enabling the alloc feature.

Methods referring to CStr and CString are also unavailable. The Error trait also only exists in std, but description() is made available as an inherent method for ToAsciiCharError and AsAsciiStrError in #![no_std]-mode.

To use the ascii crate in #![no_std] mode in your cargo project, just add the following dependency declaration in Cargo.toml:

[dependencies]
ascii = { version = "1.1", default-features = false, features = ["alloc"] }

The minimum Rust version for 1.2.* releases is 1.56.1. Later 1.y.0 releases might require newer Rust versions, but the three most recent stable releases at the time of publishing will always be supported.
For example this means that if the current stable Rust version is 1.70 when ascii 1.3.0 is released, then ascii 1.3.* will not require a newer Rust version than 1.68.

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.

Licensed under either of

• Apache License, Version 2.0, (LICENSE-APACHE or https://www.apache.org/licenses/LICENSE-2.0)
• MIT license (LICENSE-MIT or https://opensource.org/licenses/MIT)

at your option.

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.