Unicode 字符串转义

一个 Rust 库，用于解码字符串中的转义序列。

概述

此库提供了一种简单的方法来解码 Rust 字符串中的转义序列。它支持各种类型的转义序列，包括简单的转义序列（例如，\t、\n）、十六进制转义序列（例如，\x02）和 Unicode 转义序列（例如，\u{1A2B}）。它还可以处理无效的转义序列，并提供错误处理和报告。

此库试图复制 python 提供的功能

bytes(<input>, 'ascii').decode('unicode_escape')

安装

要使用此库，请将以下依赖项添加到您的 Cargo.toml 文件中

[dependencies]
unicode_escape = "0.1.0"

使用

该库提供了一个 decode 函数，该函数接受一个包含转义序列的 &str 作为输入，并返回一个解码后的 String。它还定义了一个 DecodeError 枚举，用于表示解码过程中可能出现的不同类型的错误。

以下是如何使用 decode 函数的示例

use unicode_escape::decode;

let input = r"\r\n\tHello\u{21B5}";
let decoded = decode(input).unwrap();
println!("Decoded string: {}", decoded);

Decoded string:
        Hello↵

在此示例中，输入字符串包含各种转义序列，包括制表符（\t）、换行符（\n）、十六进制转义（\x02）和 Unicode 转义（\u{21B5}）。decode 函数将用相应的字符替换这些转义序列，并将解码后的字符串打印出来。

错误处理

decode 函数返回一个 Result<String, DecodeError>，以指示成功或失败。 DecodeError 枚举包括如 InvalidEscape、InvalidHexChar 和 InvalidUnicode 等变体，以提供更多关于发生错误上下文的信息。

以下是处理错误的示例

use unicode_escape::{decode, DecodeError};

let input = r"\t\r\n Hello \xGG\u{ZZZZ}";
match decode(input) {
    Ok(decoded) => println!("Decoded string: {}", decoded),
    Err(error) => println!("Error: {:?}", error),
}

在这个例子中，输入字符串包含无效的十六进制字符（\xGG）和无效的Unicode转义序列（\u{ZZZZ}）。decode 函数将返回一个 Err 值，可以通过检查错误变体来确定发生的特定错误。

许可证

本项目采用MIT许可证。更多信息，请参阅LICENSE文件。