#counter #id #count #identifier

simple-counter

Macro for generating thread-local static counters. Useful for basic ID generation.

1 unstable release

Uses old Rust 2015

0.1.0 Jul 17, 2018

#1707 in Rust patterns

Download history 58/week @ 2023-12-18 108/week @ 2023-12-25 22/week @ 2024-01-01 79/week @ 2024-01-08 43/week @ 2024-01-15 52/week @ 2024-01-22 32/week @ 2024-01-29 71/week @ 2024-02-05 100/week @ 2024-02-12 80/week @ 2024-02-19 102/week @ 2024-02-26 88/week @ 2024-03-04 150/week @ 2024-03-11 122/week @ 2024-03-18 187/week @ 2024-03-25 223/week @ 2024-04-01

692 downloads per month
Used in 6 crates (2 directly)

MIT license

5KB
53 lines

simple-counter

Provides a single macro for generating thread-local global counters by creating a new module with a thread-local static Cell. Currently intended to be used with integer types. Useful for basic ID generation.

Usage

Add the following dependency to your Cargo.toml file:

[dependencies]
simple-counter = "0.1.0"

And make sure to use the #[macro_use] annotation when importing:

#[macro_use]
extern crate simple_counter;

generate_counter!(Counter, usize);

fn main() {

  // Starts at 0 by default
  assert_eq!(Counter::next(), 0);
  assert_eq!(Counter::next(), 1);
  assert_eq!(Counter::next(), 2);

  // Can be set to arbitrary value
  Counter::set(1000);
  assert_eq!(Counter::next(), 1000);
  assert_eq!(Counter::next(), 1001);
  assert_eq!(Counter::next(), 1002);

  // Or reset to 0
  Counter::reset();
  assert_eq!(Counter::next(), 0);
}

Example

Here's a simple unique temp generator for a compiler:

#[macro_use]
extern crate simple_counter;

generate_counter!(TempID, usize);

#[derive(Clone, Copy, Debug, PartialEq, Eq)]
pub struct Temp {
    id: usize,
    name: String,
}

impl Temp {
    pub fn from_str(name: &'static str) -> Self {
        Temp {
            id: TempID::next(),
            name: name.to_string(),
        }
    }
}

No runtime deps