#unroll #optimizer #constant #loop #number #loops

crunchy

Crunchy unroller: deterministically unroll constant loops

9 releases

Uses old Rust 2015

0.2.2 May 7, 2019
0.2.1 Mar 19, 2018
0.1.6 Aug 18, 2017
0.1.4 Jul 22, 2017

#57 in Development tools

Download history 29703/week @ 2020-08-07 28783/week @ 2020-08-14 29720/week @ 2020-08-21 26851/week @ 2020-08-28 27058/week @ 2020-09-04 29155/week @ 2020-09-11 31166/week @ 2020-09-18 28868/week @ 2020-09-25 28564/week @ 2020-10-02 26660/week @ 2020-10-09 26898/week @ 2020-10-16 34890/week @ 2020-10-23 30318/week @ 2020-10-30 29654/week @ 2020-11-06 30280/week @ 2020-11-13 36697/week @ 2020-11-20

115,583 downloads per month
Used in 707 crates (31 directly)

MIT license

10KB
241 lines

Crunchy

The crunchy unroller - deterministically unroll constant loops. For number "crunching".

The Rust optimizer will unroll constant loops that don't use the loop variable, like this:

for _ in 0..100 {
  println!("Hello!");
}

However, using the loop variable will cause it to never unroll the loop. This is unfortunate because it means that you can't constant-fold the loop variable, and if you end up stomping on the registers it will have to do a load for each iteration. This crate ensures that your code is unrolled and const-folded. It only works on literals, unfortunately, but there's a work-around:

debug_assert_eq!(MY_CONSTANT, 100);
unroll! {
  for i in 0..100 {
    println!("Iteration {}", i);
  }
}

This means that your tests will catch if you redefine the constant.

To default maximum number of loops to unroll is 64, but that can be easily increased using the cargo features:

  • limit_128
  • limit_256
  • limit_512
  • limit_1024
  • limit_2048

No runtime deps