1 unstable release

Uses old Rust 2015

0.1.0 Feb 24, 2018

#1183 in Encoding

Download history 3059/week @ 2024-02-27 3630/week @ 2024-03-05 2135/week @ 2024-03-12 2644/week @ 2024-03-19 2495/week @ 2024-03-26 2768/week @ 2024-04-02 2068/week @ 2024-04-09 2069/week @ 2024-04-16 2289/week @ 2024-04-23 1674/week @ 2024-04-30 3246/week @ 2024-05-07 1967/week @ 2024-05-14 1300/week @ 2024-05-21 1565/week @ 2024-05-28 2688/week @ 2024-06-04 2129/week @ 2024-06-11

8,347 downloads per month
Used in 14 crates (7 directly)

MIT license

33KB
386 lines

codepage-437 TravisCI build status AppVeyorCI build status Licence

Code page 437 transcoding for Rust.

Documentation


lib.rs:

Conversion to and from codepage 437.

Use the {Borrow,}FromCp437 traits to convert series of cp437 bytes to Unicode, and the cp437_to_unicode() function to decode a single codepoint.

Use the {Into,To}Cp437 traits to convert Unicode to a series of cp437 bytes, and the unicode_to_cp437() function to encode a single codepoint.

Examples

Borrowing from a buffer:

let data = &[/* buffer acquired somewhere */];

/// in_unicode will be Cow::Borrowed if data only contains overlapping characters,
///                 or Cow::Owned if a conversion needed to have been made.
let in_unicode = Cow::borrow_from_cp437(data, &CP437_CONTROL);

// Also valid:
let in_unicode = String::borrow_from_cp437(data, &CP437_CONTROL);

Moving out of a buffer:

let data = vec![/* buffer moved in from somewhere */];

/// data is moved out of and zero-alloced into in_unicode
///      if it only contains overlapping characters
let in_unicode = String::from_cp437(data, &CP437_CONTROL);

Borrowing from a &str:

let data = "Some string.";

/// in_cp437 will be Cow::Borrowed if data only contains overlapping characters,
///                  Cow::Owned if a conversion needed to have been made,
///               or Err, if data can't be represented as cp437
let in_cp437 = data.to_cp437(&CP437_CONTROL);

// Also valid (String is AsRef<str>):
let data = "Some string.".to_string();
let in_cp437 = data.to_cp437(&CP437_CONTROL);

Moving out of a String:

let data = "Some string.".to_string();

/// data is moved out of and zero-alloced into in_cp437
///      if it only contains overlapping characters
let in_cp437 = data.into_cp437(&CP437_CONTROL);

Unrepresentable Unicode:

// Ż has no representation in cp437
let data = "Jurek żelaznym żurkiem żre żupan.";

let result = data.to_cp437(&CP437_CONTROL);
assert!(result.is_err());
// result.unwrap_err() is Cp437Error (or IntoCp437Error for into_cp437()),
//   with an API modeled after libstd's {From,}Utf8Error

No runtime deps

~170KB