uncollate 0.2.3

Uncollate array of structs into arrays of field
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
53
54
55
56
57
58
59
60
61

# uncollate
[![Static Badge](https://img.shields.io/badge/github-repo-blue?logo=github)
](https://github.com/wdjcodes/uncollate)
[![GitHub Actions Workflow Status](https://img.shields.io/github/actions/workflow/status/wdjcodes/uncollate/ci.yml?logo=github)
](https://github.com/wdjcodes/uncollate/actions)
[![docs.rs](https://img.shields.io/docsrs/uncollate?logo=rust)
](https://docs.rs/uncollate/latest/uncollate/)
[![Crates.io Version](https://img.shields.io/crates/v/uncollate?logo=rust)
](https://crates.io/crates/uncollate)
![Crates.io License](https://img.shields.io/crates/l/uncollate)

Uncollate an array of structs into arrays of fields. 

This crate provides a collection of macros to cut down on repetitive complex chains of iterator functions on arrays of structs.
## Examples
The derive macro is helpful when you need to own the fields after uncollating.
It creates an uncollated version of the struct and implements Uncollate for structs that impl `IntoIter` for the corresponding struct.

The vec is consumed by uncollate.
```rs
use uncollate::Uncollate;

#[derive(Uncollate)]
pub struct Dog {
    name: String,
    breed: String
}

fn main() {
    let dog1 = Dog { name: "Bandit", breed: "Beagle" };
    let dog2 = Dog { name: "Scout", breed: "Pug"};
    
    let dogs = vec![dog1, dog2]
    let uncol_dogs: UncollatedDog = dogs.uncollate();
    //&Vec<String>["Bandit", "Scout"]
    uncol_dogs.name();
    
    //&mut Vec<String>["Beagle", "Pug"]
    uncol_dogs.breed();
}
```

Declarative macros are provided when only references to the data are needed, or the original vec must be preserved.
These macros just hide the chain of iterator functions under the hood.
```rs
use uncollate::{uncollate, uncollate_req};

struct Greet {
    greeting: String,
    who: Option<String>,
}

let greetings = vec![
    Greet { greeting: "Hello".into(), who: Some("world!".into()) },
    Greet { greeting: "Howdy".into(), who: None }
];

let opts: Vec<Option<String>> = uncollate!(greetings.who);
// Will throw an error as the vec contains a None who
let whos:Vec<String> = uncollate_req!(greetings.who)?;
```