#local #8-bit #operating-system #cargo-toml #wide #multi-byte

local-encoding

Rust library for encoding/decoding string with local charset. It usefull for work with ANSI strings on Windows.

2 unstable releases

Uses old Rust 2015

0.2.0 Aug 9, 2016
0.1.0 Jul 12, 2016
Download history 542/week @ 2023-07-17 543/week @ 2023-07-24 613/week @ 2023-07-31 634/week @ 2023-08-07 639/week @ 2023-08-14 503/week @ 2023-08-21 415/week @ 2023-08-28 567/week @ 2023-09-04 626/week @ 2023-09-11 545/week @ 2023-09-18 458/week @ 2023-09-25 455/week @ 2023-10-02 585/week @ 2023-10-09 545/week @ 2023-10-16 827/week @ 2023-10-23 565/week @ 2023-10-30

2,566 downloads per month
Used in 16 crates (14 directly)

MIT license

18KB
312 lines

local-encoding

Join the chat at https://gitter.im/bozaro/local-encoding-rs Build Status Crates.io

This repository contains rust library for encoding/decoding string with local charset. It usefull for work with ANSI strings on Windows.

Unfortunately Windows widly use 8-bit character encoding instead UTF-8. This causes a lot of pain.

For example, in Russian version:

  • CP-1251 (ANSI codepage) used for 8-bit files;
  • CP-866 (OEM codepage) used for console output.

To convert between 8-bit and Unicode used Windows have function: MultiByteToWideChar and WideCharToMultiByte.

This library provide simple function to convert between 8-bit and Unicode characters on Windows.

UTF-8 used as 8-bit codepage for non-Windows system.

Rustdoc: https://bozaro.github.io/local-encoding-rs/local_encoding/

Usage

Put this in your Cargo.toml:

[dependencies]
local-encoding = "*"

For example:

extern crate local_encoding;

use local_encoding::{Encoding, Encoder};

fn main()
{
	println!("Unicode string: {}", Encoding::ANSI.to_string(b"ANSI string").unwrap());
	println!("Unicode string: {}", Encoding::OEM.to_string(b"OEM string").unwrap());
}

Dependencies

~120KB