take-if 1.0.0

A tiny utility for conditionally taking the contents of an option.
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

# take-if


A tiny utility for conditionally taking the contents from an [`Option`]. See also [`Option::take`].

```rust
use take_if::TakeIf;

let mut maybe_greeting = Some("Hello, World!");

if let Some(greeting) = maybe_greeting.take_if(|greeting| greeting.starts_with("Hello")) {
    println!(r#"Greeting {:?} starts with "Hello""#, greeting);
} else {
    println!(r#"There was no greeting, or it didn't start with "Hello""#);
}
```

## Usage


Add take-if to your `Cargo.toml`:

```toml
[dependencies]
take-if = "1.0.0"
```

Import the `TakeIf` trait in your modules to add the `take_if` method to `Option`:

```rust
use take_if::TakeIf;

let taken = maybe_value.take_if(|value| value.id == 5);
```

[`Option`]: https://doc.rust-lang.org/std/option/enum.Option.html
[`Option::take`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.take