14 releases

0.7.4 Mar 15, 2024
0.7.3 Aug 10, 2023
0.7.2 May 10, 2023
0.7.1 Dec 23, 2022
0.2.0 Nov 11, 2019

#18 in Hardware support

Download history 39515/week @ 2024-06-20 43487/week @ 2024-06-27 36315/week @ 2024-07-04 33104/week @ 2024-07-11 44425/week @ 2024-07-18 46350/week @ 2024-07-25 47377/week @ 2024-08-01 38803/week @ 2024-08-08 52712/week @ 2024-08-15 59327/week @ 2024-08-22 61701/week @ 2024-08-29 58294/week @ 2024-09-05 45501/week @ 2024-09-12 43606/week @ 2024-09-19 45650/week @ 2024-09-26 37868/week @ 2024-10-03

181,232 downloads per month
Used in 332 crates (16 directly)

MIT/Apache

19KB
139 lines

Multiversion

Crates.io Rust Documentation Rustc Version 1.61+ License

Function multiversioning attribute macros for Rust.

What is function multiversioning?

Many CPU architectures have a variety of instruction set extensions that provide additional functionality. Common examples are single instruction, multiple data (SIMD) extensions such as SSE and AVX on x86/x86-64 and NEON on ARM/AArch64. When available, these extended features can provide significant speed improvements to some functions. These optional features cannot be haphazardly compiled into programs--executing an unsupported instruction will result in a crash.

Function multiversioning is the practice of compiling multiple versions of a function with various features enabled and safely detecting which version to use at runtime.

Example

The multiversion macro compiles a function for multiple possible targets, and selects the optimal one at runtime:

use multiversion::multiversion;

#[multiversion(targets("x86_64+avx", "aarch64+neon"))]
fn square(x: &mut [f32]) {
    for v in x {
        *v *= *v;
    }
}

License

Multiversion is distributed under the terms of both the MIT license and the Apache License (Version 2.0).

See LICENSE-APACHE and LICENSE-MIT for details.

Dependencies

~1.5MB
~36K SLoC