Newer
Older
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
# Utility Macros
## Usage
### Add to your project
```toml
[dependencies]
# There is not presently a crates.io release
weirdboi_utils = { git = "https://weirdboi.dev/libraries/weirdboi-utils.git", rev = "put-a-revision-here" }
```
### Build Collections
Build hashmaps in-place with the `hashmap` macro
```rust
let some_output = function_call("string", 23, hashmap! {
"key" => 123,
"another_key" => 456
});
```
### Safe Unwrapping
When you want to simply do nothing and cease further execution without a panic, the convenience `some!` and `ok!` macros are handy:
```rust
fn do_something_without_fail(value: Result<A, B>, maybe: Option<F>) {
let value = ok!(value);
let maybe = some!(maybe);
println!("Value was OK and maybe was SOME");
}
```
Alternatively, in a loop you can skip the rest of the current iteration instead of ending executino entirely:
```rust
fn do_many_things(list: impl Iter<Item = Option<F>>) {
for item in list {
let current = some!(item; continue);
println!("Found SOME: {}", current);
}
}
```
Finally, if the function has a return type then you should specify a default value to return:
```rust
fn get_widget(maybe: Result<A, B>) -> i32 {
let maybe = ok!(maybe; -1); // Returns "-1" from the function if maybe is Err(_)
}
```