15 releases (breaking)

0.10.0 May 23, 2023
0.9.0 Dec 12, 2021
0.8.0 Jun 13, 2020
0.7.0 Jun 12, 2019
0.0.5 Nov 21, 2015

#41 in Internationalization (i18n)

Download history 830/week @ 2024-10-18 860/week @ 2024-10-25 1158/week @ 2024-11-01 933/week @ 2024-11-08 957/week @ 2024-11-15 998/week @ 2024-11-22 1187/week @ 2024-11-29 1353/week @ 2024-12-06 1259/week @ 2024-12-13 1038/week @ 2024-12-20 752/week @ 2024-12-27 1135/week @ 2025-01-03 1486/week @ 2025-01-10 1184/week @ 2025-01-17 833/week @ 2025-01-24 802/week @ 2025-01-31

4,560 downloads per month
Used in 20 crates (16 directly)

MIT license

350KB
674 lines

rust-pinyin

Build Status Crates.io Version Doc

汉语拼音转换工具 Rust 版

Installation

Add this to your Cargo.toml:

[dependencies]
pinyin = "0.10"

Documentation

API documentation can be found here: https://docs.rs/pinyin/

Usage

use pinyin::{ToPinyin, ToPinyinMulti};

fn main() {
    let hans = "中国人";

    // 无声调,输出 zhong guo ren
    for pinyin in hans.to_pinyin() {
        if let Some(pinyin) = pinyin {
            print!("{} ", pinyin.plain());
        }
    }
    println!();

    // 包含声调,输出 zhōng guó rén
    for pinyin in hans.to_pinyin() {
        if let Some(pinyin) = pinyin {
            print!("{} ", pinyin.with_tone());
        }
    }
    println!();

    // 声调用数字表示,输出 zho1ng guo2 re2n
    for pinyin in hans.to_pinyin() {
        if let Some(pinyin) = pinyin {
            print!("{} ", pinyin.with_tone_num());
        }
    }
    println!();

    // 多音字,输出
    // zho1ng zho4ng
    // guo2
    // re2n
    for multi in hans.to_pinyin_multi() {
        if let Some(multi) = multi {
            for pinyin in multi {
                print!("{} ", pinyin.with_tone_num());
            }
            println!();
        }
    }
}

Build

$ cargo build

Test

$ cargo test

Data

使用来自 pinyin-data 的拼音数据。

No runtime deps