#string #local #ansi #codec #charset #codepage #utf-8

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

#1598 in Text processing

Download history 526/week @ 2024-03-14 531/week @ 2024-03-21 447/week @ 2024-03-28 440/week @ 2024-04-04 417/week @ 2024-04-11 472/week @ 2024-04-18 460/week @ 2024-04-25 396/week @ 2024-05-02 465/week @ 2024-05-09 552/week @ 2024-05-16 501/week @ 2024-05-23 485/week @ 2024-05-30 450/week @ 2024-06-06 433/week @ 2024-06-13 527/week @ 2024-06-20 330/week @ 2024-06-27

1,831 downloads per month
Used in 18 crates (15 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

~165KB