Struct linkify::LinkFinder

pub struct LinkFinder { /* private fields */ }

A configured link finder.

Implementations

impl LinkFinder

pub fn new() -> LinkFinder

Create a new link finder with the default options for finding all kinds of links.

If you only want to find a certain kind of links, use the kinds method.

pub fn email_domain_must_have_dot(&mut self, value: bool) -> &mut LinkFinder

Require the domain parts of email addresses to have at least one dot. Use false to also find addresses such as root@localhost.

pub fn url_must_have_scheme( &mut self, url_must_have_scheme: bool ) -> &mut LinkFinder

Set whether URLs must have a scheme, defaults to true.

By default only URLs having a scheme defined are found. By setting this to false you make the scheme of URLs optional, to also find URLs like example.org. For some URLs the used scheme is important, and making the scheme optional may lead to finding a lot of false positive URLs.

pub fn url_can_be_iri(&mut self, url_can_be_iri: bool) -> &mut LinkFinder

Sets whether URLs can be IRI according to RFC-3987. The default is true. Setting it to false means domains can contain ASCII characters only.

pub fn kinds(&mut self, kinds: &[LinkKind]) -> &mut LinkFinder

Restrict the kinds of links that should be found to the specified ones.

pub fn links<'t>(&self, text: &'t str) -> Links<'t>

Find links in the specified input text.

Returns an Iterator which only scans when next is called (lazy).

pub fn spans<'t>(&self, text: &'t str) -> Spans<'t>

Iterate over spans in the specified input text.

A span represents a substring of the input text, which can either be a link, or plain text.

Returns an Iterator which only scans when next is called (lazy).

The spans that are returned by the Iterator are consecutive, and when combined represent the input text in its entirety.

Trait Implementations

impl Debug for LinkFinder

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for LinkFinder

fn default() -> Self

Returns the “default value” for a type.