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

#39 in Internationalization (i18n)

Download history 1005/week @ 2024-11-14 955/week @ 2024-11-21 1030/week @ 2024-11-28 1406/week @ 2024-12-05 1373/week @ 2024-12-12 1102/week @ 2024-12-19 598/week @ 2024-12-26 1116/week @ 2025-01-02 1505/week @ 2025-01-09 1165/week @ 2025-01-16 953/week @ 2025-01-23 983/week @ 2025-01-30 1585/week @ 2025-02-06 917/week @ 2025-02-13 1210/week @ 2025-02-20 1053/week @ 2025-02-27

4,930 downloads per month
Used in 21 crates (17 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