#variables #values #env-var #access #scoped #cargo-toml #statically

no-std environmental

Set scope-limited values can can be accessed statically

7 stable releases

1.1.4 Nov 30, 2022
1.1.3 May 12, 2021
1.1.2 Sep 30, 2020
1.1.1 Jan 9, 2020
1.0.0 Sep 13, 2018

#20 in Configuration

Download history 49824/week @ 2024-08-17 60770/week @ 2024-08-24 64606/week @ 2024-08-31 61675/week @ 2024-09-07 55984/week @ 2024-09-14 60837/week @ 2024-09-21 62479/week @ 2024-09-28 62282/week @ 2024-10-05 59467/week @ 2024-10-12 64238/week @ 2024-10-19 54249/week @ 2024-10-26 69068/week @ 2024-11-02 56636/week @ 2024-11-09 58001/week @ 2024-11-16 56006/week @ 2024-11-23 51488/week @ 2024-11-30

230,808 downloads per month
Used in 801 crates (18 directly)

Apache-2.0

19KB
386 lines

Environmental

.Summary [source, toml]

include::Cargo.toml[lines=2..5]

.Description

include::src/lib.rs[tag=description]

lib.rs:

Safe global references to stack variables.

Set up a global reference with environmental! macro giving it a name and type. Use the using function scoped under its name to name a reference and call a function that takes no parameters yet can access said reference through the similarly placed with function.

Examples

#[macro_use] extern crate environmental;
// create a place for the global reference to exist.
environmental!(counter: u32);
fn stuff() {
  // do some stuff, accessing the named reference as desired.
  counter::with(|i| *i += 1);
}
fn main() {
  // declare a stack variable of the same type as our global declaration.
  let mut counter_value = 41u32;
  // call stuff, setting up our `counter` environment as a reference to our counter_value var.
  counter::using(&mut counter_value, stuff);
  println!("The answer is {:?}", counter_value); // will print 42!
  stuff();	// safe! doesn't do anything.
}

No runtime deps

Features