rfind_url 0.2.1

Parser to search strings for URLs in reverse order
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

# rfind_url

[![Build Status](https://travis-ci.org/chrisduerr/rfind_url.svg?branch=master)](https://travis-ci.org/chrisduerr/rfind_url)
[![crates.io](https://meritbadge.herokuapp.com/rfind_url)](https://crates.io/crates/rfind_url)

This crate provides a parser to search a string for URLs **in reverse order**.

All functionality is handled by the
[`Parser`](https://docs.rs/rfind_url/*/rfind_url/struct.Parser.html) struct which takes
[`chars`](https://doc.rust-lang.org/std/primitive.char.html) as input.

# Examples

Text can be fed into the parser in reverse order:

```
use rfind_url::Parser;

let mut parser = Parser::new();

for c in "There is no URL here.".chars().rev() {
    assert_eq!(parser.advance(c), None);
}
```

The parser returns the length of the URL as soon as the last character of the URL is pushed into
it. Otherwise it will return
[`None`](https://doc.rust-lang.org/std/option/enum.Option.html#variant.None):

```
use rfind_url::Parser;

let mut parser = Parser::new();

// Parser did not find any URLs
assert_eq!(parser.advance(' '), None);

// URLs are only returned once they are complete
for c in "ttps://example.org".chars().rev() {
    assert_eq!(parser.advance(c), None);
}

// Parser has detected a URL spanning the last 19 characters
assert_eq!(parser.advance('h'), Some(19));
```