Lib.rs

Butcher

一种轻松与被 Cow 包裹的结构体和枚举交互的方法。

概念

标准库有一个 写时复制类型，它允许处理具有所有或借用数据的对象，而无需进行区分。然而，在某些情况下，这可能导致大量代码重复。

该软件包目前提供以下功能：

• 解构任何被 Cow 包裹的结构体。
• 在 Cow 中的结构体和枚举上进行模式匹配。
• 遍历被 Cow 包裹的集合。
• Cow 平展。
• Cow 解包。

解构

可以在结构体和枚举上派生 Butcher 特性。然后解构变得简单。

use std::borrow::Cow;
use butcher::Butcher;

#[derive(Butcher, Clone)]
struct MyNumberList {
    val: u32,
    next: Option<Box<MyNumberList>>,
}

fn get_elem(i: Cow<MyNumberList>) -> Cow<u32> {
    let ButcheredMyNumberList { val, .. } = Butcher::butcher(i);

    val
}

模式匹配

也可以在枚举上派生 Butcher 特性。这允许，例如

use butcher::Butcher;
use std::borrow::Cow;

#[derive(Butcher, Clone)]
enum WebEvent {
    PageLoad,
    KeyPress(char),
    Paste(String),
    // or c-like structures.
    Click { x: i64, y: i64 },
}

fn print_action(i: Cow<WebEvent>) {
    match WebEvent::butcher(i) {
        ButcheredWebEvent::PageLoad => { /* ... */ },
        ButcheredWebEvent::KeyPress(key) => { /* ... */ },
        ButcheredWebEvent::Paste(pasted) => { /* ... */ },
        ButcheredWebEvent::Click { x, y } => { /* ... */ },
    }
}

每个变体的字段默认将变为 Cow<T>。这可以进行配置。请参阅文档获取更多信息。

迭代

此软件包提供了一个 CowIter 类型，允许编写友好的 Cow 迭代器。请参阅以下示例

use std::borrow::Cow;
use butcher::iterator::CowIter;

fn print_numbers(elems: Cow<[u32]>) {
    let mut iter = CowIter::from(elems);

    for element in iter {
        // The type of element is Cow<u32>
        println!("{:?}", element);
    }
}

平展

多亏了 Deref 特性，可以 flatten 一个 Cow<T> 到 Cow<<T as Deref>::Target>。例如，可以从 Cow<str> 创建一个 Cow<String>，从一个 Cow<[T]> 创建一个 Cow<Vec<T>>，等等。

use std::borrow::Cow;
use butcher::flatten::FlattenCow;

let some_cow: Cow<String> = Cow::Owned(String::from("Hello 🦀"));
let flattened_cow: Cow<str> = some_cow.flatten();

use std::borrow::Cow;
use butcher::unnest::UnnestCow;

let foo: Cow<Cow<usize>> = Cow::Owned(Cow::Owned(42usize));
let foo_unnested: Cow<usize> = foo.unnest();