Rust文本格式化库rt-format的使用指南

rt-format是一个高效灵活的Rust字符串与数据格式化工具库，提供了比标准库更丰富的格式化功能。

基本特性

• 高性能的字符串格式化
• 支持复杂的数据格式化需求
• 灵活的占位符系统
• 可扩展的格式化器接口

安装

在Cargo.toml中添加依赖：

[dependencies]
rt-format = "0.3"

基本使用

简单格式化

use rt_format::{format, Format};

let name = "Alice";
let age = 30;
let formatted = format!("Hello, {name}! You are {age} years old.");
println!("{}", formatted);

数字格式化

use rt_format::{format, Format};

let number = 1234.5678;
println!("{}", format!("{number:.2}"));  // 输出: 1234.57
println!("{}", format!("{number:,}"));   // 输出: 1,234.5678

高级功能

自定义格式化

use rt_format::{format, Format, Formatter, Argument};

struct Point {
    x: i32,
    y: i32,
}

impl Format for Point {
    fn format(&self, f: &mut Formatter) {
        write!(f, "({}, {})", self.x, self.y);
    }
}

let p = Point { x: 10, y: 20 };
println!("{}", format!("Point: {p}"));  // 输出: Point: (10, 20)

条件格式化

use rt_format::{format, Format};

let value = 42;
println!("{}", format!("The value is {value:?if value > 50:'large'|'small'}"));
// 输出: The value is small

复数处理

use rt_format::{format, Format};

let count = 1;
println!("{}", format!("You have {count} item{count:s}"));
// 输出: You have 1 item

let count = 5;
println!("{}", format!("You have {count} item{count:s}"));
// 输出: You have 5 items

性能优化

rt-format在设计上考虑了性能，对于大多数用例，它的性能接近或等同于标准库的格式化功能。对于高性能场景，可以使用预编译的格式化模板：

use rt_format::{ParsedFormat, Format};

let template = ParsedFormat::new("Hello, {name}! Today is {day}.").unwrap();

let formatted = template.format(&[
    ("name", "Alice").into(),
    ("day", "Monday").into(),
]);

println!("{}", formatted);

完整示例

下面是一个结合了rt-format多种功能的完整示例：

use rt_format::{format, Format, Formatter, Argument, ParsedFormat};

// 自定义结构体格式化
struct User {
    name: String,
    age: u32,
    points: Vec<Point>,
}

struct Point {
    x: i32,
    y: i32,
}

impl Format for Point {
    fn format(&self, f: &mut Formatter) {
        write!(f, "({}, {})", self.x, self.y);
    }
}

impl Format for User {
    fn format(&self, f: &mut Formatter) {
        write!(f, "{} ({}岁)", self.name, self.age);
        if !self.points.is_empty() {
            write!(f, " [");
            for (i, point) in self.points.iter().enumerate() {
                if i > 0 {
                    write!(f, ", ");
                }
                write!(f, "{}", point);
            }
            write!(f, "]");
        }
    }
}

fn main() {
    // 简单格式化
    let name = "Bob";
    let age = 25;
    println!("{}", format!("用户: {name}, 年龄: {age}"));
    
    // 数字格式化
    let price = 12345.6789;
    println!("{}", format!("价格: {price:.2}"));
    println!("{}", format!("价格(带千位分隔符): {price:,}"));
    
    // 自定义格式化
    let user = User {
        name: "Charlie".to_string(),
        age: 35,
        points: vec![
            Point { x: 10, y: 20 },
            Point { x: 30, y: 40 },
        ],
    };
    println!("{}", format!("用户信息: {user}"));
    
    // 条件格式化
    let score = 85;
    println!("{}", format!("成绩: {score:?if score >= 90:'优秀'|score >= 60:'及格'|'不及格'}"));
    
    // 复数处理
    let item_count = 1;
    println!("{}", format!("你有{item_count}个物品{item_count:s}"));
    let item_count = 5;
    println!("{}", format!("你有{item_count}个物品{item_count:s}"));
    
    // 预编译模板
    let template = ParsedFormat::new("欢迎{user}，今天是{day}").unwrap();
    let formatted = template.format(&[
        ("user", "David").into(),
        ("day", "星期二").into(),
    ]);
    println!("{}", formatted);
}

总结

rt-format为Rust开发者提供了：

1. 更丰富的格式化选项
2. 更高的灵活性
3. 良好的性能表现
4. 可扩展的格式化系统

适用于需要复杂格式化逻辑或对标准库格式化功能感到受限的场景。