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 http://www.apache.org/licenses/LICENSE-2.0)
- MIT license (LICENSE-MIT or http://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.