#values #statically #accessed #global #stack #reference #scope-limited

no-std environ

Set scope-limited values can can be accessed statically

Show the crate…

3 releases (stable)

1.1.3 May 29, 2021
1.1.2 Mar 3, 2021
0.0.0 Mar 3, 2021

#50 in #statically

Download history 242/week @ 2024-04-11 343/week @ 2024-04-18 249/week @ 2024-04-25 215/week @ 2024-05-02 223/week @ 2024-05-09 231/week @ 2024-05-16 206/week @ 2024-05-23 232/week @ 2024-05-30 149/week @ 2024-06-06 175/week @ 2024-06-13 314/week @ 2024-06-20 112/week @ 2024-06-27 64/week @ 2024-07-04 227/week @ 2024-07-11 212/week @ 2024-07-18 150/week @ 2024-07-25

653 downloads per month
Used in 149 crates (via externalities)

Apache-2.0

16KB
315 lines

Tetsy Environ - A form of Environmental to set scope-limited values can can be accessed statically

.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 environ! 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 environ;
// create a place for the global reference to exist.
environ!(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