#macro #seq #repetition #fragment #expand #substitute #sequential

macro no-std seq-macro

Macro to repeat sequentially indexed copies of a fragment of code

15 releases

0.3.5 Jul 15, 2023
0.3.3 Mar 5, 2023
0.3.2 Dec 17, 2022
0.3.1 Aug 3, 2022
0.1.2 Aug 24, 2018

#96 in Development tools

Download history 92901/week @ 2023-12-18 60079/week @ 2023-12-25 92476/week @ 2024-01-01 121367/week @ 2024-01-08 114813/week @ 2024-01-15 129432/week @ 2024-01-22 142304/week @ 2024-01-29 145219/week @ 2024-02-05 159653/week @ 2024-02-12 139264/week @ 2024-02-19 179447/week @ 2024-02-26 178608/week @ 2024-03-04 188601/week @ 2024-03-11 188072/week @ 2024-03-18 171321/week @ 2024-03-25 175856/week @ 2024-04-01

734,542 downloads per month
Used in 556 crates (82 directly)

MIT/Apache

25KB
522 lines

seq!

github crates.io docs.rs build status

A seq! macro to repeat a fragment of source code and substitute into each repetition a sequential numeric counter.

[dependencies]
seq-macro = "0.3"
use seq_macro::seq;

fn main() {
    let tuple = (1000, 100, 10);
    let mut sum = 0;

    // Expands to:
    //
    //     sum += tuple.0;
    //     sum += tuple.1;
    //     sum += tuple.2;
    //
    // This cannot be written using an ordinary for-loop because elements of
    // a tuple can only be accessed by their integer literal index, not by a
    // variable.
    seq!(N in 0..=2 {
        sum += tuple.N;
    });

    assert_eq!(sum, 1110);
}
  • If the input tokens contain a section surrounded by #( ... )* then only that part is repeated.

  • The numeric counter can be pasted onto the end of some prefix to form sequential identifiers.

use seq_macro::seq;

seq!(N in 64..=127 {
    #[derive(Debug)]
    enum Demo {
        // Expands to Variant64, Variant65, ...
        #(
            Variant~N,
        )*
    }
});

fn main() {
    assert_eq!("Variant99", format!("{:?}", Demo::Variant99));
}
  • Byte and character ranges are supported: b'a'..=b'z', 'a'..='z'.

  • If the range bounds are written in binary, octal, hex, or with zero padding, those features are preserved in any generated tokens.

use seq_macro::seq;

seq!(P in 0x000..=0x00F {
    // expands to structs Pin000, ..., Pin009, Pin00A, ..., Pin00F
    struct Pin~P;
});

License

Licensed under either of Apache License, Version 2.0 or MIT license at your option.
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in this crate by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

No runtime deps