Crates.io | for_each |
lib.rs | for_each |
version | 0.8.0 |
source | src |
created_at | 2022-05-09 21:13:37.033391 |
updated_at | 2024-05-11 22:33:33.338741 |
description | Apply macro for each element of a list. |
homepage | https://github.com/Wandalen/wTools/tree/master/module/core/for_each |
repository | https://github.com/Wandalen/wTools/tree/master/module/core/for_each |
max_upload_size | |
id | 583633 |
size | 59,150 |
Apply a macro for each element of a list.
Macros $Callback
is called for each element of the passed list, optionally passing prefix $Prefix
as the first argument(s) and postfix $Postfix
as the last argument(s).
Macros could be invoked in either function call style or map call style. Prefix and postfix could be passed only in map call style.
In map call style after passing path to macro pass keyword where
and options in format : @KEY Value
.
In some cases, the same code may be generated without callback macro, just using prefix and postfix.
That's why $Callback
is also optional.
To invoke for_each
without callback use map call style omitting path to callback and keyword where
.
Apply a macro for each element of a list.
Macro for_each
may be called either in function-style way or in map-style way.
Pass name of macro to apply to elements as the first arguments and elements after the macro name.
Use comma as delimiter.
use for_each::for_each;
for_each!( dbg, "a", "b", "c" );
// generates
dbg!( "a" );
dbg!( "b" );
dbg!( "c" );
Macro for_each
may be called either in function-style way or in map-style way.
Use keys @Prefix @Postfix @Each to pass options as entries of a map.
Options @Prefix and @Postfix are optional and their entries could be omitted, but entry @Each is mandatory.
Order of options should always be @Prefix, @Postfix, @Each.
use for_each::for_each;
for_each!
{
dbg where
@Prefix { "prefix".to_string() + }
@Postfix { + "postfix" }
@Each "a" "b" "c"
};
It generates:
// generated
dbg!( "prefix".to_string() + "a" + "postfix" );
dbg!( "prefix".to_string() + "b" + "postfix" );
dbg!( "prefix".to_string() + "c" + "postfix" );
Both prefix and postfix have to be token tree ( tt
). But if you need something more complex put it into braces { ... }
.
Macros for_each
will remove outermost braces. Braces are optional in case of prefix/postfix is a single token.
use for_each::for_each;
for_each!
{
dbg where
@Prefix { "prefix".to_string() + }
@Postfix { + "postfix" }
@Each { "a" + "1" } { "b" + "2" } { "c" + "3" }
};
// generates
dbg!( "prefix".to_string() + "a" + "1" + "postfix" );
dbg!( "prefix".to_string() + "b" + "2" + "postfix" );
dbg!( "prefix".to_string() + "c" + "3" + "postfix" );
Callback macro is optional.
Use map call style and omit path to callback macro with keyword where
to invoke for_each
without a callback.
use for_each::for_each;
for_each!
{
@Prefix { dbg! }
@Each ( "a" ) ( "b" ) ( "c" )
};
// generates
dbg!( "a" );
dbg!( "b" );
dbg!( "c" );
cargo add for_each
git clone https://github.com/Wandalen/wTools
cd wTools
cd examples/for_each_trivial
cargo run
>