use linkme::distributed_slice;

#[distributed_slice]
pub static BENCHMARKS: [fn(&mut Bencher)];

元素

可以通过在具有括号中给定分布式切片路径的#[distributed_slice(...)]属性中注册切片元素到分布式切片。初始化器必须是const表达式。

use linkme::distributed_slice;
use other_crate::BENCHMARKS;

#[distributed_slice(BENCHMARKS)]
static BENCH_DESERIALIZE: fn(&mut Bencher) = bench_deserialize;

fn bench_deserialize(b: &mut Bencher) {
    /* ... */
}

元素可以在声明分布式切片的同一crate中定义，或者在任何下游crate中。在最终二进制文件中链接的所有crate中的元素将在运行时观察到存在于切片中。

分布式切片在所有方面都表现得像 &'static [T]。

fn main() {
    // Iterate the elements.
    for bench in BENCHMARKS {
        /* ... */
    }

    // Index into the elements.
    let first = BENCHMARKS[0];

    // Slice the elements.
    let except_first = &BENCHMARKS[1..];

    // Invoke methods on the underlying slice.
    let len = BENCHMARKS.len();
}

编译器将要求静态元素类型与分布式切片的元素类型匹配。如果这两个类型不匹配，则程序将无法编译。

#[distributed_slice(BENCHMARKS)]
static BENCH_WTF: usize = 999;

error[E0308]: mismatched types
  --> src/distributed_slice.rs:65:19
   |
17 | static BENCH_WTF: usize = 999;
   |                   ^^^^^ expected fn pointer, found `usize`
   |
   = note: expected fn pointer `fn(&mut other_crate::Bencher)`
                    found type `usize`

函数元素

作为一种简写，对于包含函数指针的分布式切片的常见情况，分布式_slice 属性可以直接应用于函数定义，将对该函数的指针放入分布式切片。

use linkme::distributed_slice;

#[distributed_slice]
pub static BENCHMARKS: [fn(&mut Bencher)];

// Equivalent to:
//
//    #[distributed_slice(BENCHMARKS)]
//    static _: fn(&mut Bencher) = bench_deserialize;
//
#[distributed_slice(BENCHMARKS)]
fn bench_deserialize(b: &mut Bencher) {
    /* ... */
}

许可证