Rust双向文本处理库unic-ucd-bidi的使用：支持Unicode双向算法的高效实现

unic-ucd-bidi是一个Rust库，用于支持Unicode双向算法的高效实现。它属于UNIC项目的一部分，该项目旨在提供完整的Unicode支持。

安装

在项目中添加以下依赖到Cargo.toml：

unic-ucd-bidi = "0.9.0"

或者运行以下Cargo命令：

cargo add unic-ucd-bidi

示例代码

以下是使用unic-ucd-bidi进行双向文本处理的完整示例：

use unic_ucd_bidi::BidiClass;

fn main() {
    // 示例1：检查字符的Bidi方向性
    let char = 'א'; // 希伯来文字母Alef
    let bidi_class = BidiClass::of(char);
    println!("字符 '{}' 的Bidi类别是: {:?}", char, bidi_class);
    
    // 示例2：分析字符串的Bidi信息
    let text = "Hello שלום 123";
    let bidi_info = unic_ucd_bidi::BidiInfo::new(text, None);
    
    // 获取段落方向
    let para_level = bidi_info.paragraphs[0].level;
    println!("段落方向: {}", if para_level.is_ltr() { "LTR" } else { "RTL" });
    
    // 获取每个字符的Bidi级别
    for (i, level) in bidi_info.levels.iter().enumerate() {
        let ch = text.chars().nth(i).unwrap();
        println!("字符 '{}' 的Bidi级别: {}", ch, level.number());
    }
    
    // 示例3：重新排序文本以正确显示
    let reordered = bidi_info.reorder_line(0..text.len());
    println!("重新排序后的文本: {}", reordered);
}

功能特点

1. 支持Unicode标准定义的双向算法（UAX #9）
2. 提供字符级别的Bidi分类
3. 支持段落级别的方向性分析
4. 能够正确重新排序混合方向的文本
5. 高效实现，适合处理大量文本

完整示例代码

use unic_ucd_bidi::{BidiClass, BidiInfo};

fn main() {
    // 示例1：检查多个字符的Bidi方向性
    let chars = ['A', 'א', '1', 'ض'];
    for char in chars {
        let bidi_class = BidiClass::of(char);
        println!("字符 '{}' 的Bidi类别是: {:?}", char, bidi_class);
    }

    // 示例2：分析复杂字符串的Bidi信息
    let complex_text = "Rust编程 语言 - اللغة العربية 123 - עברית";
    let bidi_info = BidiInfo::new(complex_text, None);
    
    // 分析多段落文本
    for (i, para) in bidi_info.paragraphs.iter().enumerate() {
        println!("段落 {} 方向: {}", i+1, if para.level.is_ltr() { "LTR" } else { "RTL" });
        
        // 获取每个字符的Bidi级别
        let (start, end) = para.range.clone().into_inner();
        for (i, level) in bidi_info.levels[start..end].iter().enumerate() {
            let ch = complex_text.chars().nth(start + i).unwrap();
            println!("字符 '{}' 的Bidi级别: {}", ch, level.number());
        }
        
        // 重新排序段落
        let reordered = bidi_info.reorder_line(para.range.clone());
        println!("重新排序后的段落 {}: {}", i+1, reordered);
    }

    // 示例3：处理用户输入
    println!("请输入包含混合方向文本的字符串:");
    let mut input = String::new();
    std::io::stdin().read_line(&mut input).unwrap();
    
    let input_bidi = BidiInfo::new(&input, None);
    if let Some(para) = input_bidi.paragraphs.first() {
        println!("检测到的文本方向: {}", if para.level.is_ltr() { "LTR" } else { "RTL" });
        println!("重新排序后的文本: {}", input_bidi.reorder_line(para.range.clone()));
    }
}

实际应用场景

1. 多语言文本编辑器
2. 国际化应用程序的文本渲染
3. 命令行工具的多语言支持
4. 网页内容处理
5. 移动应用程序的文本布局

许可证

该库采用MIT或Apache-2.0双重许可。