mirror of
https://github.com/edg-l/edlang.git
synced 2024-11-10 01:58:23 +00:00
277 lines
50 KiB
HTML
277 lines
50 KiB
HTML
|
<!DOCTYPE html><html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1.0"><meta name="generator" content="rustdoc"><meta name="description" content="Match multiple, possibly overlapping, regexes in a single search."><title>RegexSet in regex::bytes - Rust</title><link rel="preload" as="font" type="font/woff2" crossorigin href="../../static.files/SourceSerif4-Regular-46f98efaafac5295.ttf.woff2"><link rel="preload" as="font" type="font/woff2" crossorigin href="../../static.files/FiraSans-Regular-018c141bf0843ffd.woff2"><link rel="preload" as="font" type="font/woff2" crossorigin href="../../static.files/FiraSans-Medium-8f9a781e4970d388.woff2"><link rel="preload" as="font" type="font/woff2" crossorigin href="../../static.files/SourceCodePro-Regular-562dcc5011b6de7d.ttf.woff2"><link rel="preload" as="font" type="font/woff2" crossorigin href="../../static.files/SourceCodePro-Semibold-d899c5a5c4aeb14a.ttf.woff2"><link rel="stylesheet" href="../../static.files/normalize-76eba96aa4d2e634.css"><link rel="stylesheet" href="../../static.files/rustdoc-ac92e1bbe349e143.css"><meta name="rustdoc-vars" data-root-path="../../" data-static-root-path="../../static.files/" data-current-crate="regex" data-themes="" data-resource-suffix="" data-rustdoc-version="1.76.0 (07dca489a 2024-02-04)" data-channel="1.76.0" data-search-js="search-2b6ce74ff89ae146.js" data-settings-js="settings-4313503d2e1961c2.js" ><script src="../../static.files/storage-f2adc0d6ca4d09fb.js"></script><script defer src="sidebar-items.js"></script><script defer src="../../static.files/main-305769736d49e732.js"></script><noscript><link rel="stylesheet" href="../../static.files/noscript-feafe1bb7466e4bd.css"></noscript><link rel="alternate icon" type="image/png" href="../../static.files/favicon-16x16-8b506e7a72182f1c.png"><link rel="alternate icon" type="image/png" href="../../static.files/favicon-32x32-422f7d1d52889060.png"><link rel="icon" type="image/svg+xml" href="../../static.files/favicon-2c020d218678b618.svg"></head><body class="rustdoc struct"><!--[if lte IE 11]><div class="warning">This old browser is unsupported and will most likely display funky things.</div><![endif]--><nav class="mobile-topbar"><button class="sidebar-menu-toggle">☰</button></nav><nav class="sidebar"><div class="sidebar-crate"><h2><a href="../../regex/index.html">regex</a><span class="version">1.10.3</span></h2></div><h2 class="location"><a href="#">RegexSet</a></h2><div class="sidebar-elems"><section><h3><a href="#implementations">Methods</a></h3><ul class="block method"><li><a href="#method.empty">empty</a></li><li><a href="#method.is_empty">is_empty</a></li><li><a href="#method.is_match">is_match</a></li><li><a href="#method.is_match_at">is_match_at</a></li><li><a href="#method.len">len</a></li><li><a href="#method.matches">matches</a></li><li><a href="#method.matches_at">matches_at</a></li><li><a href="#method.new">new</a></li><li><a href="#method.patterns">patterns</a></li></ul><h3><a href="#trait-implementations">Trait Implementations</a></h3><ul class="block trait-implementation"><li><a href="#impl-Clone-for-RegexSet">Clone</a></li><li><a href="#impl-Debug-for-RegexSet">Debug</a></li><li><a href="#impl-Default-for-RegexSet">Default</a></li></ul><h3><a href="#synthetic-implementations">Auto Trait Implementations</a></h3><ul class="block synthetic-implementation"><li><a href="#impl-RefUnwindSafe-for-RegexSet">RefUnwindSafe</a></li><li><a href="#impl-Send-for-RegexSet">Send</a></li><li><a href="#impl-Sync-for-RegexSet">Sync</a></li><li><a href="#impl-Unpin-for-RegexSet">Unpin</a></li><li><a href="#impl-UnwindSafe-for-RegexSet">UnwindSafe</a></li></ul><h3><a href="#blanket-implementations">Blanket Implementations</a></h3><ul class="block blanket-implementation"><li><a href="#impl-Any-for-T">Any</a></li><li><a href="#impl-Borrow%3CT%3E-for-T">Borrow<T></a></li><li><a href="#impl-BorrowMut%3CT%3E-for-T">BorrowMut<T></a></li><li><a href="#impl-From%3CT%3E-for-T">From<T></a></li><li><a href="#impl-Into%3CU%3E-for-T">Int
|
|||
|
|
<main><div class="width-limiter"><nav class="sub"><form class="search-form"><span></span><div id="sidebar-button" tabindex="-1"><a href="../../regex/all.html" title="show sidebar"></a></div><input class="search-input" name="search" aria-label="Run search in the documentation" autocomplete="off" spellcheck="false" placeholder="Click or press ‘S’ to search, ‘?’ for more options…" type="search"><div id="help-button" tabindex="-1"><a href="../../help.html" title="help">?</a></div><div id="settings-menu" tabindex="-1"><a href="../../settings.html" title="settings"><img width="22" height="22" alt="Change settings" src="../../static.files/wheel-7b819b6101059cd0.svg"></a></div></form></nav><section id="main-content" class="content"><div class="main-heading"><h1>Struct <a href="../index.html">regex</a>::<wbr><a href="index.html">bytes</a>::<wbr><a class="struct" href="#">RegexSet</a><button id="copy-path" title="Copy item path to clipboard"><img src="../../static.files/clipboard-7571035ce49a181d.svg" width="19" height="18" alt="Copy item path"></button></h1><span class="out-of-band"><a class="src" href="../../src/regex/regexset/bytes.rs.html#136-139">source</a> · <button id="toggle-all-docs" title="collapse all docs">[<span>−</span>]</button></span></div><pre class="rust item-decl"><code>pub struct RegexSet { <span class="comment">/* private fields */</span> }</code></pre><details class="toggle top-doc" open><summary class="hideme"><span>Expand description</span></summary><div class="docblock"><p>Match multiple, possibly overlapping, regexes in a single search.</p>
|
|||
|
|
<p>A regex set corresponds to the union of zero or more regular expressions.
|
|||
|
|
That is, a regex set will match a haystack when at least one of its
|
|||
|
|
constituent regexes matches. A regex set as its formulated here provides a
|
|||
|
|
touch more power: it will also report <em>which</em> regular expressions in the
|
|||
|
|
set match. Indeed, this is the key difference between regex sets and a
|
|||
|
|
single <code>Regex</code> with many alternates, since only one alternate can match at
|
|||
|
|
a time.</p>
|
|||
|
|
<p>For example, consider regular expressions to match email addresses and
|
|||
|
|
domains: <code>[a-z]+@[a-z]+\.(com|org|net)</code> and <code>[a-z]+\.(com|org|net)</code>. If a
|
|||
|
|
regex set is constructed from those regexes, then searching the haystack
|
|||
|
|
<code>foo@example.com</code> will report both regexes as matching. Of course, one
|
|||
|
|
could accomplish this by compiling each regex on its own and doing two
|
|||
|
|
searches over the haystack. The key advantage of using a regex set is
|
|||
|
|
that it will report the matching regexes using a <em>single pass through the
|
|||
|
|
haystack</em>. If one has hundreds or thousands of regexes to match repeatedly
|
|||
|
|
(like a URL router for a complex web application or a user agent matcher),
|
|||
|
|
then a regex set <em>can</em> realize huge performance gains.</p>
|
|||
|
|
<p>Unlike the top-level <a href="../struct.RegexSet.html" title="struct regex::RegexSet"><code>RegexSet</code></a>, this <code>RegexSet</code>
|
|||
|
|
searches haystacks with type <code>&[u8]</code> instead of <code>&str</code>. Consequently, this
|
|||
|
|
<code>RegexSet</code> is permitted to match invalid UTF-8.</p>
|
|||
|
|
<h2 id="limitations"><a href="#limitations">Limitations</a></h2>
|
|||
|
|
<p>Regex sets are limited to answering the following two questions:</p>
|
|||
|
|
<ol>
|
|||
|
|
<li>Does any regex in the set match?</li>
|
|||
|
|
<li>If so, which regexes in the set match?</li>
|
|||
|
|
</ol>
|
|||
|
|
<p>As with the main <a href="struct.Regex.html" title="struct regex::bytes::Regex"><code>Regex</code></a> type, it is cheaper to ask
|
|||
|
|
(1) instead of (2) since the matching engines can stop after the first
|
|||
|
|
match is found.</p>
|
|||
|
|
<p>You cannot directly extract <a href="struct.Match.html" title="struct regex::bytes::Match"><code>Match</code></a> or
|
|||
|
|
<a href="struct.Captures.html" title="struct regex::bytes::Captures"><code>Captures</code></a> objects from a regex set. If you need
|
|||
|
|
these operations, the recommended approach is to compile each pattern in
|
|||
|
|
the set independently and scan the exact same haystack a second time with
|
|||
|
|
those independently compiled patterns:</p>
|
|||
|
|
|
|||
|
|
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>regex::bytes::{Regex, RegexSet};
|
|||
|
|
|
|||
|
|
<span class="kw">let </span>patterns = [<span class="string">"foo"</span>, <span class="string">"bar"</span>];
|
|||
|
|
<span class="comment">// Both patterns will match different ranges of this string.
|
|||
|
|
</span><span class="kw">let </span>hay = <span class="string">b"barfoo"</span>;
|
|||
|
|
|
|||
|
|
<span class="comment">// Compile a set matching any of our patterns.
|
|||
|
|
</span><span class="kw">let </span>set = RegexSet::new(patterns).unwrap();
|
|||
|
|
<span class="comment">// Compile each pattern independently.
|
|||
|
|
</span><span class="kw">let </span>regexes: Vec<<span class="kw">_</span>> = set
|
|||
|
|
.patterns()
|
|||
|
|
.iter()
|
|||
|
|
.map(|pat| Regex::new(pat).unwrap())
|
|||
|
|
.collect();
|
|||
|
|
|
|||
|
|
<span class="comment">// Match against the whole set first and identify the individual
|
|||
|
|
// matching patterns.
|
|||
|
|
</span><span class="kw">let </span>matches: Vec<<span class="kw-2">&</span>[u8]> = set
|
|||
|
|
.matches(hay)
|
|||
|
|
.into_iter()
|
|||
|
|
<span class="comment">// Dereference the match index to get the corresponding
|
|||
|
|
// compiled pattern.
|
|||
|
|
</span>.map(|index| <span class="kw-2">&</span>regexes[index])
|
|||
|
|
<span class="comment">// To get match locations or any other info, we then have to search the
|
|||
|
|
// exact same haystack again, using our separately-compiled pattern.
|
|||
|
|
</span>.map(|re| re.find(hay).unwrap().as_bytes())
|
|||
|
|
.collect();
|
|||
|
|
|
|||
|
|
<span class="comment">// Matches arrive in the order the constituent patterns were declared,
|
|||
|
|
// not the order they appear in the haystack.
|
|||
|
|
</span><span class="macro">assert_eq!</span>(<span class="macro">vec!</span>[<span class="kw-2">&</span><span class="string">b"foo"</span>[..], <span class="kw-2">&</span><span class="string">b"bar"</span>[..]], matches);</code></pre></div>
|
|||
|
|
<h2 id="performance"><a href="#performance">Performance</a></h2>
|
|||
|
|
<p>A <code>RegexSet</code> has the same performance characteristics as <code>Regex</code>. Namely,
|
|||
|
|
search takes <code>O(m * n)</code> time, where <code>m</code> is proportional to the size of the
|
|||
|
|
regex set and <code>n</code> is proportional to the length of the haystack.</p>
|
|||
|
|
<h2 id="trait-implementations-1"><a href="#trait-implementations-1">Trait implementations</a></h2>
|
|||
|
|
<p>The <code>Default</code> trait is implemented for <code>RegexSet</code>. The default value
|
|||
|
|
is an empty set. An empty set can also be explicitly constructed via
|
|||
|
|
<a href="struct.RegexSet.html#method.empty" title="associated function regex::bytes::RegexSet::empty"><code>RegexSet::empty</code></a>.</p>
|
|||
|
|
<h2 id="example"><a href="#example">Example</a></h2>
|
|||
|
|
<p>This shows how the above two regexes (for matching email addresses and
|
|||
|
|
domains) might work:</p>
|
|||
|
|
|
|||
|
|
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>regex::bytes::RegexSet;
|
|||
|
|
|
|||
|
|
<span class="kw">let </span>set = RegexSet::new(<span class="kw-2">&</span>[
|
|||
|
|
<span class="string">r"[a-z]+@[a-z]+\.(com|org|net)"</span>,
|
|||
|
|
<span class="string">r"[a-z]+\.(com|org|net)"</span>,
|
|||
|
|
]).unwrap();
|
|||
|
|
|
|||
|
|
<span class="comment">// Ask whether any regexes in the set match.
|
|||
|
|
</span><span class="macro">assert!</span>(set.is_match(<span class="string">b"foo@example.com"</span>));
|
|||
|
|
|
|||
|
|
<span class="comment">// Identify which regexes in the set match.
|
|||
|
|
</span><span class="kw">let </span>matches: Vec<<span class="kw">_</span>> = set.matches(<span class="string">b"foo@example.com"</span>).into_iter().collect();
|
|||
|
|
<span class="macro">assert_eq!</span>(<span class="macro">vec!</span>[<span class="number">0</span>, <span class="number">1</span>], matches);
|
|||
|
|
|
|||
|
|
<span class="comment">// Try again, but with a haystack that only matches one of the regexes.
|
|||
|
|
</span><span class="kw">let </span>matches: Vec<<span class="kw">_</span>> = set.matches(<span class="string">b"example.com"</span>).into_iter().collect();
|
|||
|
|
<span class="macro">assert_eq!</span>(<span class="macro">vec!</span>[<span class="number">1</span>], matches);
|
|||
|
|
|
|||
|
|
<span class="comment">// Try again, but with a haystack that doesn't match any regex in the set.
|
|||
|
|
</span><span class="kw">let </span>matches: Vec<<span class="kw">_</span>> = set.matches(<span class="string">b"example"</span>).into_iter().collect();
|
|||
|
|
<span class="macro">assert!</span>(matches.is_empty());</code></pre></div>
|
|||
|
|
<p>Note that it would be possible to adapt the above example to using <code>Regex</code>
|
|||
|
|
with an expression like:</p>
|
|||
|
|
<div class="example-wrap"><pre class="language-text"><code>(?P<email>[a-z]+@(?P<email_domain>[a-z]+[.](com|org|net)))|(?P<domain>[a-z]+[.](com|org|net))
|
|||
|
|
</code></pre></div>
|
|||
|
|
<p>After a match, one could then inspect the capture groups to figure out
|
|||
|
|
which alternates matched. The problem is that it is hard to make this
|
|||
|
|
approach scale when there are many regexes since the overlap between each
|
|||
|
|
alternate isn’t always obvious to reason about.</p>
|
|||
|
|
</div></details><h2 id="implementations" class="section-header">Implementations<a href="#implementations" class="anchor">§</a></h2><div id="implementations-list"><details class="toggle implementors-toggle" open><summary><section id="impl-RegexSet" class="impl"><a class="src rightside" href="../../src/regex/regexset/bytes.rs.html#141-451">source</a><a href="#impl-RegexSet" class="anchor">§</a><h3 class="code-header">impl <a class="struct" href="struct.RegexSet.html" title="struct regex::bytes::RegexSet">RegexSet</a></h3></section></summary><div class="impl-items"><details class="toggle method-toggle" open><summary><section id="method.new" class="method"><a class="src rightside" href="../../src/regex/regexset/bytes.rs.html#158-164">source</a><h4 class="code-header">pub fn <a href="#method.new" class="fn">new</a><I, S>(exprs: I) -> <a class="enum" href="https://doc.rust-lang.org/1.76.0/core/result/enum.Result.html" title="enum core::result::Result">Result</a><<a class="struct" href="struct.RegexSet.html" title="struct regex::bytes::RegexSet">RegexSet</a>, <a class="enum" href="../enum.Error.html" title="enum regex::Error">Error</a>><div class="where">where
|
|||
|
|
S: <a class="trait" href="https://doc.rust-lang.org/1.76.0/core/convert/trait.AsRef.html" title="trait core::convert::AsRef">AsRef</a><<a class="primitive" href="https://doc.rust-lang.org/1.76.0/std/primitive.str.html">str</a>>,
|
|||
|
|
I: <a class="trait" href="https://doc.rust-lang.org/1.76.0/core/iter/traits/collect/trait.IntoIterator.html" title="trait core::iter::traits::collect::IntoIterator">IntoIterator</a><Item = S>,</div></h4></section></summary><div class="docblock"><p>Create a new regex set with the given regular expressions.</p>
|
|||
|
|
<p>This takes an iterator of <code>S</code>, where <code>S</code> is something that can produce
|
|||
|
|
a <code>&str</code>. If any of the strings in the iterator are not valid regular
|
|||
|
|
expressions, then an error is returned.</p>
|
|||
|
|
<h5 id="example-1"><a href="#example-1">Example</a></h5>
|
|||
|
|
<p>Create a new regex set from an iterator of strings:</p>
|
|||
|
|
|
|||
|
|
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>regex::bytes::RegexSet;
|
|||
|
|
|
|||
|
|
<span class="kw">let </span>set = RegexSet::new([<span class="string">r"\w+"</span>, <span class="string">r"\d+"</span>]).unwrap();
|
|||
|
|
<span class="macro">assert!</span>(set.is_match(<span class="string">b"foo"</span>));</code></pre></div>
|
|||
|
|
</div></details><details class="toggle method-toggle" open><summary><section id="method.empty" class="method"><a class="src rightside" href="../../src/regex/regexset/bytes.rs.html#183-186">source</a><h4 class="code-header">pub fn <a href="#method.empty" class="fn">empty</a>() -> <a class="struct" href="struct.RegexSet.html" title="struct regex::bytes::RegexSet">RegexSet</a></h4></section></summary><div class="docblock"><p>Create a new empty regex set.</p>
|
|||
|
|
<p>An empty regex never matches anything.</p>
|
|||
|
|
<p>This is a convenience function for <code>RegexSet::new([])</code>, but doesn’t
|
|||
|
|
require one to specify the type of the input.</p>
|
|||
|
|
<h5 id="example-2"><a href="#example-2">Example</a></h5>
|
|||
|
|
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>regex::bytes::RegexSet;
|
|||
|
|
|
|||
|
|
<span class="kw">let </span>set = RegexSet::empty();
|
|||
|
|
<span class="macro">assert!</span>(set.is_empty());
|
|||
|
|
<span class="comment">// an empty set matches nothing
|
|||
|
|
</span><span class="macro">assert!</span>(!set.is_match(<span class="string">b""</span>));</code></pre></div>
|
|||
|
|
</div></details><details class="toggle method-toggle" open><summary><section id="method.is_match" class="method"><a class="src rightside" href="../../src/regex/regexset/bytes.rs.html#214-216">source</a><h4 class="code-header">pub fn <a href="#method.is_match" class="fn">is_match</a>(&self, haystack: &[<a class="primitive" href="https://doc.rust-lang.org/1.76.0/std/primitive.u8.html">u8</a>]) -> <a class="primitive" href="https://doc.rust-lang.org/1.76.0/std/primitive.bool.html">bool</a></h4></section></summary><div class="docblock"><p>Returns true if and only if one of the regexes in this set matches
|
|||
|
|
the haystack given.</p>
|
|||
|
|
<p>This method should be preferred if you only need to test whether any
|
|||
|
|
of the regexes in the set should match, but don’t care about <em>which</em>
|
|||
|
|
regexes matched. This is because the underlying matching engine will
|
|||
|
|
quit immediately after seeing the first match instead of continuing to
|
|||
|
|
find all matches.</p>
|
|||
|
|
<p>Note that as with searches using <a href="struct.Regex.html" title="struct regex::bytes::Regex"><code>Regex</code></a>, the
|
|||
|
|
expression is unanchored by default. That is, if the regex does not
|
|||
|
|
start with <code>^</code> or <code>\A</code>, or end with <code>$</code> or <code>\z</code>, then it is permitted
|
|||
|
|
to match anywhere in the haystack.</p>
|
|||
|
|
<h5 id="example-3"><a href="#example-3">Example</a></h5>
|
|||
|
|
<p>Tests whether a set matches somewhere in a haystack:</p>
|
|||
|
|
|
|||
|
|
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>regex::bytes::RegexSet;
|
|||
|
|
|
|||
|
|
<span class="kw">let </span>set = RegexSet::new([<span class="string">r"\w+"</span>, <span class="string">r"\d+"</span>]).unwrap();
|
|||
|
|
<span class="macro">assert!</span>(set.is_match(<span class="string">b"foo"</span>));
|
|||
|
|
<span class="macro">assert!</span>(!set.is_match(<span class="string">"☃"</span>.as_bytes()));</code></pre></div>
|
|||
|
|
</div></details><details class="toggle method-toggle" open><summary><section id="method.is_match_at" class="method"><a class="src rightside" href="../../src/regex/regexset/bytes.rs.html#248-250">source</a><h4 class="code-header">pub fn <a href="#method.is_match_at" class="fn">is_match_at</a>(&self, haystack: &[<a class="primitive" href="https://doc.rust-lang.org/1.76.0/std/primitive.u8.html">u8</a>], start: <a class="primitive" href="https://doc.rust-lang.org/1.76.0/std/primitive.usize.html">usize</a>) -> <a class="primitive" href="https://doc.rust-lang.org/1.76.0/std/primitive.bool.html">bool</a></h4></section></summary><div class="docblock"><p>Returns true if and only if one of the regexes in this set matches the
|
|||
|
|
haystack given, with the search starting at the offset given.</p>
|
|||
|
|
<p>The significance of the starting point is that it takes the surrounding
|
|||
|
|
context into consideration. For example, the <code>\A</code> anchor can only
|
|||
|
|
match when <code>start == 0</code>.</p>
|
|||
|
|
<h5 id="panics"><a href="#panics">Panics</a></h5>
|
|||
|
|
<p>This panics when <code>start >= haystack.len() + 1</code>.</p>
|
|||
|
|
<h5 id="example-4"><a href="#example-4">Example</a></h5>
|
|||
|
|
<p>This example shows the significance of <code>start</code>. Namely, consider a
|
|||
|
|
haystack <code>foobar</code> and a desire to execute a search starting at offset
|
|||
|
|
<code>3</code>. You could search a substring explicitly, but then the look-around
|
|||
|
|
assertions won’t work correctly. Instead, you can use this method to
|
|||
|
|
specify the start position of a search.</p>
|
|||
|
|
|
|||
|
|
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>regex::bytes::RegexSet;
|
|||
|
|
|
|||
|
|
<span class="kw">let </span>set = RegexSet::new([<span class="string">r"\bbar\b"</span>, <span class="string">r"(?m)^bar$"</span>]).unwrap();
|
|||
|
|
<span class="kw">let </span>hay = <span class="string">b"foobar"</span>;
|
|||
|
|
<span class="comment">// We get a match here, but it's probably not intended.
|
|||
|
|
</span><span class="macro">assert!</span>(set.is_match(<span class="kw-2">&</span>hay[<span class="number">3</span>..]));
|
|||
|
|
<span class="comment">// No match because the assertions take the context into account.
|
|||
|
|
</span><span class="macro">assert!</span>(!set.is_match_at(hay, <span class="number">3</span>));</code></pre></div>
|
|||
|
|
</div></details><details class="toggle method-toggle" open><summary><section id="method.matches" class="method"><a class="src rightside" href="../../src/regex/regexset/bytes.rs.html#291-293">source</a><h4 class="code-header">pub fn <a href="#method.matches" class="fn">matches</a>(&self, haystack: &[<a class="primitive" href="https://doc.rust-lang.org/1.76.0/std/primitive.u8.html">u8</a>]) -> <a class="struct" href="struct.SetMatches.html" title="struct regex::bytes::SetMatches">SetMatches</a></h4></section></summary><div class="docblock"><p>Returns the set of regexes that match in the given haystack.</p>
|
|||
|
|
<p>The set returned contains the index of each regex that matches in
|
|||
|
|
the given haystack. The index is in correspondence with the order of
|
|||
|
|
regular expressions given to <code>RegexSet</code>’s constructor.</p>
|
|||
|
|
<p>The set can also be used to iterate over the matched indices. The order
|
|||
|
|
of iteration is always ascending with respect to the matching indices.</p>
|
|||
|
|
<p>Note that as with searches using <a href="struct.Regex.html" title="struct regex::bytes::Regex"><code>Regex</code></a>, the
|
|||
|
|
expression is unanchored by default. That is, if the regex does not
|
|||
|
|
start with <code>^</code> or <code>\A</code>, or end with <code>$</code> or <code>\z</code>, then it is permitted
|
|||
|
|
to match anywhere in the haystack.</p>
|
|||
|
|
<h5 id="example-5"><a href="#example-5">Example</a></h5>
|
|||
|
|
<p>Tests which regular expressions match the given haystack:</p>
|
|||
|
|
|
|||
|
|
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>regex::bytes::RegexSet;
|
|||
|
|
|
|||
|
|
<span class="kw">let </span>set = RegexSet::new([
|
|||
|
|
<span class="string">r"\w+"</span>,
|
|||
|
|
<span class="string">r"\d+"</span>,
|
|||
|
|
<span class="string">r"\pL+"</span>,
|
|||
|
|
<span class="string">r"foo"</span>,
|
|||
|
|
<span class="string">r"bar"</span>,
|
|||
|
|
<span class="string">r"barfoo"</span>,
|
|||
|
|
<span class="string">r"foobar"</span>,
|
|||
|
|
]).unwrap();
|
|||
|
|
<span class="kw">let </span>matches: Vec<<span class="kw">_</span>> = set.matches(<span class="string">b"foobar"</span>).into_iter().collect();
|
|||
|
|
<span class="macro">assert_eq!</span>(matches, <span class="macro">vec!</span>[<span class="number">0</span>, <span class="number">2</span>, <span class="number">3</span>, <span class="number">4</span>, <span class="number">6</span>]);
|
|||
|
|
|
|||
|
|
<span class="comment">// You can also test whether a particular regex matched:
|
|||
|
|
</span><span class="kw">let </span>matches = set.matches(<span class="string">b"foobar"</span>);
|
|||
|
|
<span class="macro">assert!</span>(!matches.matched(<span class="number">5</span>));
|
|||
|
|
<span class="macro">assert!</span>(matches.matched(<span class="number">6</span>));</code></pre></div>
|
|||
|
|
</div></details><details class="toggle method-toggle" open><summary><section id="method.matches_at" class="method"><a class="src rightside" href="../../src/regex/regexset/bytes.rs.html#329-334">source</a><h4 class="code-header">pub fn <a href="#method.matches_at" class="fn">matches_at</a>(&self, haystack: &[<a class="primitive" href="https://doc.rust-lang.org/1.76.0/std/primitive.u8.html">u8</a>], start: <a class="primitive" href="https://doc.rust-lang.org/1.76.0/std/primitive.usize.html">usize</a>) -> <a class="struct" href="struct.SetMatches.html" title="struct regex::bytes::SetMatches">SetMatches</a></h4></section></summary><div class="docblock"><p>Returns the set of regexes that match in the given haystack.</p>
|
|||
|
|
<p>The set returned contains the index of each regex that matches in
|
|||
|
|
the given haystack. The index is in correspondence with the order of
|
|||
|
|
regular expressions given to <code>RegexSet</code>’s constructor.</p>
|
|||
|
|
<p>The set can also be used to iterate over the matched indices. The order
|
|||
|
|
of iteration is always ascending with respect to the matching indices.</p>
|
|||
|
|
<p>The significance of the starting point is that it takes the surrounding
|
|||
|
|
context into consideration. For example, the <code>\A</code> anchor can only
|
|||
|
|
match when <code>start == 0</code>.</p>
|
|||
|
|
<h5 id="panics-1"><a href="#panics-1">Panics</a></h5>
|
|||
|
|
<p>This panics when <code>start >= haystack.len() + 1</code>.</p>
|
|||
|
|
<h5 id="example-6"><a href="#example-6">Example</a></h5>
|
|||
|
|
<p>Tests which regular expressions match the given haystack:</p>
|
|||
|
|
|
|||
|
|
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>regex::bytes::RegexSet;
|
|||
|
|
|
|||
|
|
<span class="kw">let </span>set = RegexSet::new([<span class="string">r"\bbar\b"</span>, <span class="string">r"(?m)^bar$"</span>]).unwrap();
|
|||
|
|
<span class="kw">let </span>hay = <span class="string">b"foobar"</span>;
|
|||
|
|
<span class="comment">// We get matches here, but it's probably not intended.
|
|||
|
|
</span><span class="kw">let </span>matches: Vec<<span class="kw">_</span>> = set.matches(<span class="kw-2">&</span>hay[<span class="number">3</span>..]).into_iter().collect();
|
|||
|
|
<span class="macro">assert_eq!</span>(matches, <span class="macro">vec!</span>[<span class="number">0</span>, <span class="number">1</span>]);
|
|||
|
|
<span class="comment">// No matches because the assertions take the context into account.
|
|||
|
|
</span><span class="kw">let </span>matches: Vec<<span class="kw">_</span>> = set.matches_at(hay, <span class="number">3</span>).into_iter().collect();
|
|||
|
|
<span class="macro">assert_eq!</span>(matches, <span class="macro">vec!</span>[]);</code></pre></div>
|
|||
|
|
</div></details><details class="toggle method-toggle" open><summary><section id="method.len" class="method"><a class="src rightside" href="../../src/regex/regexset/bytes.rs.html#400-402">source</a><h4 class="code-header">pub fn <a href="#method.len" class="fn">len</a>(&self) -> <a class="primitive" href="https://doc.rust-lang.org/1.76.0/std/primitive.usize.html">usize</a></h4></section></summary><div class="docblock"><p>Returns the total number of regexes in this set.</p>
|
|||
|
|
<h5 id="example-7"><a href="#example-7">Example</a></h5>
|
|||
|
|
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>regex::bytes::RegexSet;
|
|||
|
|
|
|||
|
|
<span class="macro">assert_eq!</span>(<span class="number">0</span>, RegexSet::empty().len());
|
|||
|
|
<span class="macro">assert_eq!</span>(<span class="number">1</span>, RegexSet::new([<span class="string">r"[0-9]"</span>]).unwrap().len());
|
|||
|
|
<span class="macro">assert_eq!</span>(<span class="number">2</span>, RegexSet::new([<span class="string">r"[0-9]"</span>, <span class="string">r"[a-z]"</span>]).unwrap().len());</code></pre></div>
|
|||
|
|
</div></details><details class="toggle method-toggle" open><summary><section id="method.is_empty" class="method"><a class="src rightside" href="../../src/regex/regexset/bytes.rs.html#415-417">source</a><h4 class="code-header">pub fn <a href="#method.is_empty" class="fn">is_empty</a>(&self) -> <a class="primitive" href="https://doc.rust-lang.org/1.76.0/std/primitive.bool.html">bool</a></h4></section></summary><div class="docblock"><p>Returns <code>true</code> if this set contains no regexes.</p>
|
|||
|
|
<h5 id="example-8"><a href="#example-8">Example</a></h5>
|
|||
|
|
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>regex::bytes::RegexSet;
|
|||
|
|
|
|||
|
|
<span class="macro">assert!</span>(RegexSet::empty().is_empty());
|
|||
|
|
<span class="macro">assert!</span>(!RegexSet::new([<span class="string">r"[0-9]"</span>]).unwrap().is_empty());</code></pre></div>
|
|||
|
|
</div></details><details class="toggle method-toggle" open><summary><section id="method.patterns" class="method"><a class="src rightside" href="../../src/regex/regexset/bytes.rs.html#448-450">source</a><h4 class="code-header">pub fn <a href="#method.patterns" class="fn">patterns</a>(&self) -> &[<a class="struct" href="https://doc.rust-lang.org/1.76.0/alloc/string/struct.String.html" title="struct alloc::string::String">String</a>]</h4></section></summary><div class="docblock"><p>Returns the regex patterns that this regex set was constructed from.</p>
|
|||
|
|
<p>This function can be used to determine the pattern for a match. The
|
|||
|
|
slice returned has exactly as many patterns givens to this regex set,
|
|||
|
|
and the order of the slice is the same as the order of the patterns
|
|||
|
|
provided to the set.</p>
|
|||
|
|
<h5 id="example-9"><a href="#example-9">Example</a></h5>
|
|||
|
|
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>regex::bytes::RegexSet;
|
|||
|
|
|
|||
|
|
<span class="kw">let </span>set = RegexSet::new(<span class="kw-2">&</span>[
|
|||
|
|
<span class="string">r"\w+"</span>,
|
|||
|
|
<span class="string">r"\d+"</span>,
|
|||
|
|
<span class="string">r"\pL+"</span>,
|
|||
|
|
<span class="string">r"foo"</span>,
|
|||
|
|
<span class="string">r"bar"</span>,
|
|||
|
|
<span class="string">r"barfoo"</span>,
|
|||
|
|
<span class="string">r"foobar"</span>,
|
|||
|
|
]).unwrap();
|
|||
|
|
<span class="kw">let </span>matches: Vec<<span class="kw">_</span>> = set
|
|||
|
|
.matches(<span class="string">b"foobar"</span>)
|
|||
|
|
.into_iter()
|
|||
|
|
.map(|index| <span class="kw-2">&</span>set.patterns()[index])
|
|||
|
|
.collect();
|
|||
|
|
<span class="macro">assert_eq!</span>(matches, <span class="macro">vec!</span>[<span class="string">r"\w+"</span>, <span class="string">r"\pL+"</span>, <span class="string">r"foo"</span>, <span class="string">r"bar"</span>, <span class="string">r"foobar"</span>]);</code></pre></div>
|
|||
|
|
</div></details></div></details></div><h2 id="trait-implementations" class="section-header">Trait Implementations<a href="#trait-implementations" class="anchor">§</a></h2><div id="trait-implementations-list"><details class="toggle implementors-toggle" open><summary><section id="impl-Clone-for-RegexSet" class="impl"><a class="src rightside" href="../../src/regex/regexset/bytes.rs.html#135">source</a><a href="#impl-Clone-for-RegexSet" class="anchor">§</a><h3 class="code-header">impl <a class="trait" href="https://doc.rust-lang.org/1.76.0/core/clone/trait.Clone.html" title="trait core::clone::Clone">Clone</a> for <a class="struct" href="struct.RegexSet.html" title="struct regex::bytes::RegexSet">RegexSet</a></h3></section></summary><div class="impl-items"><details class="toggle method-toggle" open><summary><section id="method.clone" class="method trait-impl"><a class="src rightside" href="../../src/regex/regexset/bytes.rs.html#135">source</a><a href="#method.clone" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.76.0/core/clone/trait.Clone.html#tymethod.clone" class="fn">clone</a>(&self) -> <a class="struct" href="struct.RegexSet.html" title="struct regex::bytes::RegexSet">RegexSet</a></h4></section></summary><div class='docblock'>Returns a copy of the value. <a href="https://doc.rust-lang.org/1.76.0/core/clone/trait.Clone.html#tymethod.clone">Read more</a></div></details><details class="toggle method-toggle" open><summary><section id="method.clone_from" class="method trait-impl"><span class="rightside"><span class="since" title="Stable since Rust version 1.0.0">1.0.0</span> · <a class="src" href="https://doc.rust-lang.org/1.76.0/src/core/clone.rs.html#169">source</a></span><a href="#method.clone_from" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.76.0/core/clone/trait.Clone.html#method.clone_from" class="fn">clone_from</a>(&mut self, source: <a class="primitive" href="https://doc.rust-lang.org/1.76.0/std/primitive.reference.html">&Self</a>)</h4></section></summary><div class='docblock'>Performs copy-assignment from <code>source</code>. <a href="https://doc.rust-lang.org/1.76.0/core/clone/trait.Clone.html#method.clone_from">Read more</a></div></details></div></details><details class="toggle implementors-toggle" open><summary><section id="impl-Debug-for-RegexSet" class="impl"><a class="src rightside" href="../../src/regex/regexset/bytes.rs.html#706-710">source</a><a href="#impl-Debug-for-RegexSet" class="anchor">§</a><h3 class="code-header">impl <a class="trait" href="https://doc.rust-lang.org/1.76.0/core/fmt/trait.Debug.html" title="trait core::fmt::Debug">Debug</a> for <a class="struct" href="struct.RegexSet.html" title="struct regex::bytes::RegexSet">RegexSet</a></h3></section></summary><div class="impl-items"><details class="toggle method-toggle" open><summary><section id="method.fmt" class="method trait-impl"><a class="src rightside" href="../../src/regex/regexset/bytes.rs.html#707-709">source</a><a href="#method.fmt" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.76.0/core/fmt/trait.Debug.html#tymethod.fmt" class="fn">fmt</a>(&self, f: &mut <a class="struct" href="https://doc.rust-lang.org/1.76.0/core/fmt/struct.Formatter.html" title="struct core::fmt::Formatter">Formatter</a><'_>) -> <a class="type" href="https://doc.rust-lang.org/1.76.0/core/fmt/type.Result.html" title="type core::fmt::Result">Result</a></h4></section></summary><div class='docblock'>Formats the value using the given formatter. <a href="https://doc.rust-lang.org/1.76.0/core/fmt/trait.Debug.html#tymethod.fmt">Read more</a></div></details></div></details><details class="toggle implementors-toggle" open><summary><section id="impl-Default-for-RegexSet" class="impl"><a class="src rightside" href="../../src/regex/regexset/bytes.rs.html#453-457">source</a><a href="#impl-Default-for-RegexSet" class="anchor">§</a><h3 class="code-header">impl <a class="trait" href="https://doc.rust-lang.org/1.76.0/core/default/t
|
|||
|
|
T: 'static + ?<a class="trait" href="https://doc.rust-lang.org/1.76.0/core/marker/trait.Sized.html" title="trait core::marker::Sized">Sized</a>,</div></h3></section></summary><div class="impl-items"><details class="toggle method-toggle" open><summary><section id="method.type_id" class="method trait-impl"><a class="src rightside" href="https://doc.rust-lang.org/1.76.0/src/core/any.rs.html#141">source</a><a href="#method.type_id" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.76.0/core/any/trait.Any.html#tymethod.type_id" class="fn">type_id</a>(&self) -> <a class="struct" href="https://doc.rust-lang.org/1.76.0/core/any/struct.TypeId.html" title="struct core::any::TypeId">TypeId</a></h4></section></summary><div class='docblock'>Gets the <code>TypeId</code> of <code>self</code>. <a href="https://doc.rust-lang.org/1.76.0/core/any/trait.Any.html#tymethod.type_id">Read more</a></div></details></div></details><details class="toggle implementors-toggle"><summary><section id="impl-Borrow%3CT%3E-for-T" class="impl"><a class="src rightside" href="https://doc.rust-lang.org/1.76.0/src/core/borrow.rs.html#208">source</a><a href="#impl-Borrow%3CT%3E-for-T" class="anchor">§</a><h3 class="code-header">impl<T> <a class="trait" href="https://doc.rust-lang.org/1.76.0/core/borrow/trait.Borrow.html" title="trait core::borrow::Borrow">Borrow</a><T> for T<div class="where">where
|
|||
|
|
T: ?<a class="trait" href="https://doc.rust-lang.org/1.76.0/core/marker/trait.Sized.html" title="trait core::marker::Sized">Sized</a>,</div></h3></section></summary><div class="impl-items"><details class="toggle method-toggle" open><summary><section id="method.borrow" class="method trait-impl"><a class="src rightside" href="https://doc.rust-lang.org/1.76.0/src/core/borrow.rs.html#210">source</a><a href="#method.borrow" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.76.0/core/borrow/trait.Borrow.html#tymethod.borrow" class="fn">borrow</a>(&self) -> <a class="primitive" href="https://doc.rust-lang.org/1.76.0/std/primitive.reference.html">&T</a></h4></section></summary><div class='docblock'>Immutably borrows from an owned value. <a href="https://doc.rust-lang.org/1.76.0/core/borrow/trait.Borrow.html#tymethod.borrow">Read more</a></div></details></div></details><details class="toggle implementors-toggle"><summary><section id="impl-BorrowMut%3CT%3E-for-T" class="impl"><a class="src rightside" href="https://doc.rust-lang.org/1.76.0/src/core/borrow.rs.html#216">source</a><a href="#impl-BorrowMut%3CT%3E-for-T" class="anchor">§</a><h3 class="code-header">impl<T> <a class="trait" href="https://doc.rust-lang.org/1.76.0/core/borrow/trait.BorrowMut.html" title="trait core::borrow::BorrowMut">BorrowMut</a><T> for T<div class="where">where
|
|||
|
|
T: ?<a class="trait" href="https://doc.rust-lang.org/1.76.0/core/marker/trait.Sized.html" title="trait core::marker::Sized">Sized</a>,</div></h3></section></summary><div class="impl-items"><details class="toggle method-toggle" open><summary><section id="method.borrow_mut" class="method trait-impl"><a class="src rightside" href="https://doc.rust-lang.org/1.76.0/src/core/borrow.rs.html#217">source</a><a href="#method.borrow_mut" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.76.0/core/borrow/trait.BorrowMut.html#tymethod.borrow_mut" class="fn">borrow_mut</a>(&mut self) -> <a class="primitive" href="https://doc.rust-lang.org/1.76.0/std/primitive.reference.html">&mut T</a></h4></section></summary><div class='docblock'>Mutably borrows from an owned value. <a href="https://doc.rust-lang.org/1.76.0/core/borrow/trait.BorrowMut.html#tymethod.borrow_mut">Read more</a></div></details></div></details><details class="toggle implementors-toggle"><summary><section id="impl-From%3CT%3E-for-T" class="impl"><a class="src rightside" href="https://doc.rust-lang.org/1.76.0/src/core/convert/mod.rs.html#763">source</a><a href="#impl-From%3CT%3E-for-T" class="anchor">§</a><h3 class="code-header">impl<T> <a class="trait" href="https://doc.rust-lang.org/1.76.0/core/convert/trait.From.html" title="trait core::convert::From">From</a><T> for T</h3></section></summary><div class="impl-items"><details class="toggle method-toggle" open><summary><section id="method.from" class="method trait-impl"><a class="src rightside" href="https://doc.rust-lang.org/1.76.0/src/core/convert/mod.rs.html#766">source</a><a href="#method.from" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.76.0/core/convert/trait.From.html#tymethod.from" class="fn">from</a>(t: T) -> T</h4></section></summary><div class="docblock"><p>Returns the argument unchanged.</p>
|
|||
|
|
</div></details></div></details><details class="toggle implementors-toggle"><summary><section id="impl-Into%3CU%3E-for-T" class="impl"><a class="src rightside" href="https://doc.rust-lang.org/1.76.0/src/core/convert/mod.rs.html#747-749">source</a><a href="#impl-Into%3CU%3E-for-T" class="anchor">§</a><h3 class="code-header">impl<T, U> <a class="trait" href="https://doc.rust-lang.org/1.76.0/core/convert/trait.Into.html" title="trait core::convert::Into">Into</a><U> for T<div class="where">where
|
|||
|
|
U: <a class="trait" href="https://doc.rust-lang.org/1.76.0/core/convert/trait.From.html" title="trait core::convert::From">From</a><T>,</div></h3></section></summary><div class="impl-items"><details class="toggle method-toggle" open><summary><section id="method.into" class="method trait-impl"><a class="src rightside" href="https://doc.rust-lang.org/1.76.0/src/core/convert/mod.rs.html#756">source</a><a href="#method.into" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.76.0/core/convert/trait.Into.html#tymethod.into" class="fn">into</a>(self) -> U</h4></section></summary><div class="docblock"><p>Calls <code>U::from(self)</code>.</p>
|
|||
|
|
<p>That is, this conversion is whatever the implementation of
|
|||
|
|
<code><a href="https://doc.rust-lang.org/1.76.0/core/convert/trait.From.html" title="trait core::convert::From">From</a><T> for U</code> chooses to do.</p>
|
|||
|
|
</div></details></div></details><details class="toggle implementors-toggle"><summary><section id="impl-ToOwned-for-T" class="impl"><a class="src rightside" href="https://doc.rust-lang.org/1.76.0/src/alloc/borrow.rs.html#83-85">source</a><a href="#impl-ToOwned-for-T" class="anchor">§</a><h3 class="code-header">impl<T> <a class="trait" href="https://doc.rust-lang.org/1.76.0/alloc/borrow/trait.ToOwned.html" title="trait alloc::borrow::ToOwned">ToOwned</a> for T<div class="where">where
|
|||
|
|
T: <a class="trait" href="https://doc.rust-lang.org/1.76.0/core/clone/trait.Clone.html" title="trait core::clone::Clone">Clone</a>,</div></h3></section></summary><div class="impl-items"><details class="toggle" open><summary><section id="associatedtype.Owned" class="associatedtype trait-impl"><a href="#associatedtype.Owned" class="anchor">§</a><h4 class="code-header">type <a href="https://doc.rust-lang.org/1.76.0/alloc/borrow/trait.ToOwned.html#associatedtype.Owned" class="associatedtype">Owned</a> = T</h4></section></summary><div class='docblock'>The resulting type after obtaining ownership.</div></details><details class="toggle method-toggle" open><summary><section id="method.to_owned" class="method trait-impl"><a class="src rightside" href="https://doc.rust-lang.org/1.76.0/src/alloc/borrow.rs.html#88">source</a><a href="#method.to_owned" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.76.0/alloc/borrow/trait.ToOwned.html#tymethod.to_owned" class="fn">to_owned</a>(&self) -> T</h4></section></summary><div class='docblock'>Creates owned data from borrowed data, usually by cloning. <a href="https://doc.rust-lang.org/1.76.0/alloc/borrow/trait.ToOwned.html#tymethod.to_owned">Read more</a></div></details><details class="toggle method-toggle" open><summary><section id="method.clone_into" class="method trait-impl"><a class="src rightside" href="https://doc.rust-lang.org/1.76.0/src/alloc/borrow.rs.html#92">source</a><a href="#method.clone_into" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.76.0/alloc/borrow/trait.ToOwned.html#method.clone_into" class="fn">clone_into</a>(&self, target: <a class="primitive" href="https://doc.rust-lang.org/1.76.0/std/primitive.reference.html">&mut T</a>)</h4></section></summary><div class='docblock'>Uses borrowed data to replace owned data, usually by cloning. <a href="https://doc.rust-lang.org/1.76.0/alloc/borrow/trait.ToOwned.html#method.clone_into">Read more</a></div></details></div></details><details class="toggle implementors-toggle"><summary><section id="impl-TryFrom%3CU%3E-for-T" class="impl"><a class="src rightside" href="https://doc.rust-lang.org/1.76.0/src/core/convert/mod.rs.html#803-805">source</a><a href="#impl-TryFrom%3CU%3E-for-T" class="anchor">§</a><h3 class="code-header">impl<T, U> <a class="trait" href="https://doc.rust-lang.org/1.76.0/core/convert/trait.TryFrom.html" title="trait core::convert::TryFrom">TryFrom</a><U> for T<div class="where">where
|
|||
|
|
U: <a class="trait" href="https://doc.rust-lang.org/1.76.0/core/convert/trait.Into.html" title="trait core::convert::Into">Into</a><T>,</div></h3></section></summary><div class="impl-items"><details class="toggle" open><summary><section id="associatedtype.Error" class="associatedtype trait-impl"><a href="#associatedtype.Error" class="anchor">§</a><h4 class="code-header">type <a href="https://doc.rust-lang.org/1.76.0/core/convert/trait.TryFrom.html#associatedtype.Error" class="associatedtype">Error</a> = <a class="enum" href="https://doc.rust-lang.org/1.76.0/core/convert/enum.Infallible.html" title="enum core::convert::Infallible">Infallible</a></h4></section></summary><div class='docblock'>The type returned in the event of a conversion error.</div></details><details class="toggle method-toggle" open><summary><section id="method.try_from" class="method trait-impl"><a class="src rightside" href="https://doc.rust-lang.org/1.76.0/src/core/convert/mod.rs.html#810">source</a><a href="#method.try_from" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.76.0/core/convert/trait.TryFrom.html#tymethod.try_from" class="fn">try_from</a>(value: U) -> <a class="enum" href="https://doc.rust-lang.org/1.76.0/core/result/enum.Result.html" title="enum core::result::Result">Result</a><T, <T as <a class="trait" href="https://doc.rust-lang.org/1.76.0/core/convert/trait.TryFrom.html" title="trait core::convert::TryFrom">TryFrom</a><U>>::<a class="associatedtype" href="https://doc.rust-lang.org/1.76.0/core/convert/trait.TryFrom.html#associatedtype.Error" title="type core::convert::TryFrom::Error">Error</a>></h4></section></summary><div class='docblock'>Performs the conversion.</div></details></div></details><details class="toggle implementors-toggle"><summary><section id="impl-TryInto%3CU%3E-for-T" class="impl"><a class="src rightside" href="https://doc.rust-lang.org/1.76.0/src/core/convert/mod.rs.html#788-790">source</a><a href="#impl-TryInto%3CU%3E-for-T" class="anchor">§</a><h3 class="code-header">impl<T, U> <a class="trait" href="https://doc.rust-lang.org/1.76.0/core/convert/trait.TryInto.html" title="trait core::convert::TryInto">TryInto</a><U> for T<div class="where">where
|
|||
|
|
U: <a class="trait" href="https://doc.rust-lang.org/1.76.0/core/convert/trait.TryFrom.html" title="trait core::convert::TryFrom">TryFrom</a><T>,</div></h3></section></summary><div class="impl-items"><details class="toggle" open><summary><section id="associatedtype.Error-1" class="associatedtype trait-impl"><a href="#associatedtype.Error-1" class="anchor">§</a><h4 class="code-header">type <a href="https://doc.rust-lang.org/1.76.0/core/convert/trait.TryInto.html#associatedtype.Error" class="associatedtype">Error</a> = <U as <a class="trait" href="https://doc.rust-lang.org/1.76.0/core/convert/trait.TryFrom.html" title="trait core::convert::TryFrom">TryFrom</a><T>>::<a class="associatedtype" href="https://doc.rust-lang.org/1.76.0/core/convert/trait.TryFrom.html#associatedtype.Error" title="type core::convert::TryFrom::Error">Error</a></h4></section></summary><div class='docblock'>The type returned in the event of a conversion error.</div></details><details class="toggle method-toggle" open><summary><section id="method.try_into" class="method trait-impl"><a class="src rightside" href="https://doc.rust-lang.org/1.76.0/src/core/convert/mod.rs.html#795">source</a><a href="#method.try_into" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.76.0/core/convert/trait.TryInto.html#tymethod.try_into" class="fn">try_into</a>(self) -> <a class="enum" href="https://doc.rust-lang.org/1.76.0/core/result/enum.Result.html" title="enum core::result::Result">Result</a><U, <U as <a class="trait" href="https://doc.rust-lang.org/1.76.0/core/convert/trait.TryFrom.html" title="trait core::convert::TryFrom">TryFrom</a><T>>::<a class="associatedtype" href="https://doc.rust-lang.org/1.76.0/core/convert/trait.TryFrom.html#associatedtype.Error" title="type core::convert::TryFrom::Error">Error</a>></h4></section></summary><div class='docblock'>Performs the conversion.</div></details></div></details></div></section></div></main></body></html>
|