or-else-map 0.1.0

non-yoda versions of Option::map_or_else and Result::map_or_else
Documentation 
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

# `or-else-map`

Fix `Option::map_or_else` and `Result::map_or_else`, to make sense.

## Why?

- `Option::map_or_else` and `Result::map_or_else` were presumably written by
  yoda; the `map` and `or_else` are reversed from what they should be.
- "if you aint first you're last" (Bobby, et al., 2006)

## Example

```rust
use or_else_map::prelude::*;

fn option_eg() {
    let x = Some(2);
    let y = x.map_or_else(|| 0, |v| v * 2); // yoda
    let z = x.or_else_map(|| 0, |v| v * 2); // not-yoda
    assert_eq!(y, 4);
    assert_eq!(z, 4);

    let x: Option<i32> = None;
    let z = x.or_else_map(|| 0, |v| v * 2);
    assert_eq!(z, 0);
}

fn result_eg() {
    let x: Result<i32, &str> = Ok(2);
    let y = x.map_or_else(|e| 0, |v| v * 2); // yoda
    let z = x.or_else_map(|e| 0, |v| v * 2); // not-yoda
    assert_eq!(y, 4);
    assert_eq!(z, 4);

    let x: Result<i32, &str> = Err("oof");
    let z = x.or_else_map(|e| 0, |v| v * 2);
    assert_eq!(z, 0);
}

fn main() {
    option_eg();
    result_eg();
}
```

---

## Acknowledgements

- my fans and family
- the academy and the hollywood foreign press
- the rust developers