Структура Matches

#![allow(unused)]
fn main() {
pub struct Matches<'a, P>(/* приватные поля */)
where
    P: Pattern;
}

Создается методом matches.

Реализации трейтов

impl<'a, P> Clone for Matches<'a, P>

#![allow(unused)]
fn main() {
where
    P: Pattern,
    <P as Pattern>::Searcher<'a>: Clone,
}

Функция	Синтаксис	Пример	Назначение
clone	`fn clone(&self) -> Matches<'a, P> ⓘ`	`let cloned = matches.clone();`	Возвращает копию значения
clone_from	`fn clone_from(&mut self, source: &Self)`	`matches.clone_from(&other);`	Выполняет копирующее присваивание из `source`

impl<'a, P> Debug for Matches<'a, P>

#![allow(unused)]
fn main() {
where
    P: Pattern,
    <P as Pattern>::Searcher<'a>: Debug,
}

Функция	Синтаксис	Пример	Назначение
fmt	`fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>`	`println!("{:?}", matches);`	Форматирует значение с помощью заданного форматтера

impl<'a, P> DoubleEndedIterator for Matches<'a, P>

#![allow(unused)]
fn main() {
where
    P: Pattern,
    <P as Pattern>::Searcher<'a>: DoubleEndedSearcher<'a>,
}

Функция	Синтаксис	Пример	Назначение
next_back	`fn next_back(&mut self) -> Option<&'a str>`	`let last_match = matches.next_back();`	Удаляет и возвращает элемент с конца итератора
advance_back_by	`fn advance_back_by(&mut self, n: usize) -> Result<(), NonZero<usize>>`	`matches.advance_back_by(2)?;`	🔬 Перемещает итератор с конца на n элементов
nth_back (с версии 1.37.0)	`fn nth_back(&mut self, n: usize) -> Option<Self::Item>`	`let second_last = matches.nth_back(1);`	Возвращает n-й элемент с конца итератора
try_rfold (с версии 1.27.0)	`fn try_rfold<B, F, R>(&mut self, init: B, f: F) -> R`	`let result = matches.try_rfold(vec![],	mut v, s
rfold (с версии 1.27.0)	`fn rfold<B, F>(self, init: B, f: F) -> B`	`let total_len = matches.rfold(0,	acc, s
rfind (с версии 1.27.0)	`fn rfind<P>(&mut self, predicate: P) -> Option<Self::Item>`	`let last_long = matches.rfind(	s

impl<'a, P> Iterator for Matches<'a, P>

#![allow(unused)]
fn main() {
where
    P: Pattern,
}

Функция	Синтаксис	Пример	Назначение
Item	`type Item = &'a str`	-	Тип элементов, по которым выполняется итерация
next	`fn next(&mut self) -> Option<&'a str>`	`let next_match = matches.next();`	Продвигает итератор и возвращает следующее значение
next_chunk	`fn next_chunk<const N: usize>(&mut self) -> Result<[Self::Item; N], IntoIter<Self::Item, N>>`	`let chunk: [&str; 3] = matches.next_chunk()?;`	🔬 Возвращает массив следующих N значений
size_hint	`fn size_hint(&self) -> (usize, Option<usize>)`	`let (min, max) = matches.size_hint();`	Возвращает границы оставшейся длины итератора
count	`fn count(self) -> usize`	`let total = matches.count();`	Потребляет итератор, подсчитывая количество итераций
last	`fn last(self) -> Option<Self::Item>`	`let final_match = matches.last();`	Потребляет итератор, возвращая последний элемент
advance_by	`fn advance_by(&mut self, n: usize) -> Result<(), NonZero<usize>>`	`matches.advance_by(2)?;`	🔬 Продвигает итератор на n элементов
nth	`fn nth(&mut self, n: usize) -> Option<Self::Item>`	`let third = matches.nth(2);`	Возвращает n-й элемент итератора
step_by (с версии 1.28.0)	`fn step_by(self, step: usize) -> StepBy<Self> ⓘ`	`let stepped = matches.step_by(2);`	Создает итератор с заданным шагом
chain	`fn chain<U>(self, other: U) -> Chain<Self, U::IntoIter> ⓘ`	`let combined = matches.chain(other_matches);`	Объединяет два итератора в последовательности
zip	`fn zip<U>(self, other: U) -> Zip<Self, U::IntoIter> ⓘ`	`let zipped = matches.zip(other_matches);`	Объединяет два итератора в итератор пар
intersperse	`fn intersperse(self, separator: Self::Item) -> Intersperse<Self> ⓘ`	`let with_sep = matches.intersperse(", ");`	🔬 Разделяет элементы разделителем
intersperse_with	`fn intersperse_with<G>(self, separator: G) -> IntersperseWith<Self, G> ⓘ`	`let with_sep = matches.intersperse_with(
map	`fn map<B, F>(self, f: F) -> Map<Self, F> ⓘ`	`let lengths = matches.map(	s
for_each (с версии 1.21.0)	`fn for_each<F>(self, f: F)`	`matches.for_each(	s
filter	`fn filter<P>(self, predicate: P) -> Filter<Self, P> ⓘ`	`let long = matches.filter(	s
filter_map	`fn filter_map<B, F>(self, f: F) -> FilterMap<Self, F> ⓘ`	`let nums = matches.filter_map(	s
enumerate	`fn enumerate(self) -> Enumerate<Self> ⓘ`	`for (i, s) in matches.enumerate()`	Добавляет индекс к каждому элементу
peekable	`fn peekable(self) -> Peekable<Self> ⓘ`	`let peekable = matches.peekable();`	Создает итератор с возможностью заглядывания вперед
skip_while	`fn skip_while<P>(self, predicate: P) -> SkipWhile<Self, P> ⓘ`	`let skipped = matches.skip_while(	s
take_while	`fn take_while<P>(self, predicate: P) -> TakeWhile<Self, P> ⓘ`	`let taken = matches.take_while(	s
map_while (с версии 1.57.0)	`fn map_while<B, P>(self, predicate: P) -> MapWhile<Self, P> ⓘ`	`let nums = matches.map_while(	s
skip	`fn skip(self, n: usize) -> Skip<Self> ⓘ`	`let skipped = matches.skip(2);`	Пропускает первые n элементов
take	`fn take(self, n: usize) -> Take<Self> ⓘ`	`let first_3 = matches.take(3);`	Берет первые n элементов
scan	`fn scan<St, B, F>(self, initial_state: St, f: F) -> Scan<Self, St, F> ⓘ`	`let scanned = matches.scan(0,	sum, s
flat_map	`fn flat_map<U, F>(self, f: F) -> FlatMap<Self, U, F> ⓘ`	`let chars = matches.flat_map(	s
flatten (с версии 1.29.0)	`fn flatten(self) -> Flatten<Self> ⓘ`	`let flattened = matches.flatten();`	Разворачивает вложенные структуры
map_windows	`fn map_windows<F, R, const N: usize>(self, f: F) -> MapWindows<Self, F, N> ⓘ`	`let windows = matches.map_windows(	arr: &[&str; 3]
fuse	`fn fuse(self) -> Fuse<Self> ⓘ`	`let fused = matches.fuse();`	Создает итератор, завершающийся после первого None
inspect	`fn inspect<F>(self, f: F) -> Inspect<Self, F> ⓘ`	`let inspected = matches.inspect(	s
by_ref	`fn by_ref(&mut self) -> &mut Self`	`for s in matches.by_ref().take(2)`	Создает ссылку на итератор
collect	`fn collect<B>(self) -> B`	`let vec: Vec<&str> = matches.collect();`	Преобразует итератор в коллекцию
try_collect	`fn try_collect<B>(&mut self) -> ...`	`let vec: Vec<Result<&str, _>> = matches.try_collect();`	🔬 Преобразует итератор с обработкой ошибок
collect_into	`fn collect_into<E>(self, collection: &mut E) -> &mut E`	`matches.collect_into(&mut vec);`	🔬 Собирает элементы в существующую коллекцию
partition	`fn partition<B, F>(self, f: F) -> (B, B)`	`let (long, short): (Vec<>, Vec<>) = matches.partition(	s
partition_in_place	`fn partition_in_place<'a, T, P>(self, predicate: P) -> usize`	`let true_count = matches.partition_in_place(	s
is_partitioned	`fn is_partitioned<P>(self, predicate: P) -> bool`	`let partitioned = matches.is_partitioned(	s
try_fold (с версии 1.27.0)	`fn try_fold<B, F, R>(&mut self, init: B, f: F) -> R`	`let sum = matches.try_fold(0,	acc, s
try_for_each (с версии 1.27.0)	`fn try_for_each<F, R>(&mut self, f: F) -> R`	`matches.try_for_each(	s
fold	`fn fold<B, F>(self, init: B, f: F) -> B`	`let total_len = matches.fold(0,	acc, s
reduce (с версии 1.51.0)	`fn reduce<F>(self, f: F) -> Option<Self::Item>`	`let longest = matches.reduce(	a, b
try_reduce	`fn try_reduce<R>(&mut self, f: impl FnMut(Self::Item, Self::Item) -> R) -> ...`	`let longest = matches.try_reduce(	a, b
all	`fn all<F>(&mut self, f: F) -> bool`	`let all_long = matches.all(	s
any	`fn any<F>(&mut self, f: F) -> bool`	`let any_long = matches.any(	s
find	`fn find<P>(&mut self, predicate: P) -> Option<Self::Item>`	`let long = matches.find(	s
find_map (с версии 1.30.0)	`fn find_map<B, F>(&mut self, f: F) -> Option<B>`	`let num = matches.find_map(	s
try_find	`fn try_find<R>(&mut self, f: impl FnMut(&Self::Item) -> R) -> ...`	`let long = matches.try_find(	s
position	`fn position<P>(&mut self, predicate: P) -> Option<usize>`	`let pos = matches.position(	s
rposition	`fn rposition<P>(&mut self, predicate: P) -> Option<usize>`	`let rpos = matches.rposition(	s
max	`fn max(self) -> Option<Self::Item>`	`let longest = matches.max();`	Возвращает максимальный элемент
min	`fn min(self) -> Option<Self::Item>`	`let shortest = matches.min();`	Возвращает минимальный элемент
max_by_key (с версии 1.6.0)	`fn max_by_key<B, F>(self, f: F) -> Option<Self::Item>`	`let longest = matches.max_by_key(	s
max_by (с версии 1.15.0)	`fn max_by<F>(self, compare: F) -> Option<Self::Item>`	`let longest = matches.max_by(	a, b
min_by_key (с версии 1.6.0)	`fn min_by_key<B, F>(self, f: F) -> Option<Self::Item>`	`let shortest = matches.min_by_key(	s
min_by (с версии 1.15.0)	`fn min_by<F>(self, compare: F) -> Option<Self::Item>`	`let shortest = matches.min_by(	a, b
rev	`fn rev(self) -> Rev<Self> ⓘ`	`let reversed = matches.rev();`	Обращает направление итератора
unzip	`fn unzip<A, B, FromA, FromB>(self) -> (FromA, FromB)`	`let (first, second): (Vec<_>, Vec<_>) = matches.unzip();`	Разделяет пары на две коллекции
copied (с версии 1.36.0)	`fn copied<'a, T>(self) -> Copied<Self> ⓘ`	`let copied: Copied<_> = matches.copied();`	Создает итератор, копирующий элементы
cloned	`fn cloned<'a, T>(self) -> Cloned<Self> ⓘ`	`let cloned: Cloned<_> = matches.cloned();`	Создает итератор, клонирующий элементы
cycle	`fn cycle(self) -> Cycle<Self> ⓘ`	`let cycled = matches.cycle();`	Бесконечно повторяет итератор
array_chunks	`fn array_chunks<const N: usize>(self) -> ArrayChunks<Self, N> ⓘ`	`let chunks = matches.array_chunks::<3>();`	🔬 Возвращает элементы массивами по N штук
sum (с версии 1.11.0)	`fn sum<S>(self) -> S`	`let total_len: usize = matches.map(	s
product (с версии 1.11.0)	`fn product<P>(self) -> P`	`let product: i32 = matches.map(	s
cmp (с версии 1.5.0)	`fn cmp<I>(self, other: I) -> Ordering`	`let ordering = matches.cmp(other_matches);`	Лексикографически сравнивает с другим итератором
cmp_by	`fn cmp_by<I, F>(self, other: I, cmp: F) -> Ordering`	`let ordering = matches.cmp_by(other_matches,	a, b
partial_cmp (с версии 1.5.0)	`fn partial_cmp<I>(self, other: I) -> Option<Ordering>`	`let ordering = matches.partial_cmp(other_matches);`	Частично сравнивает с другим итератором
partial_cmp_by	`fn partial_cmp_by<I, F>(self, other: I, partial_cmp: F) -> Option<Ordering>`	`let ordering = matches.partial_cmp_by(other_matches,	a, b
eq (с версии 1.5.0)	`fn eq<I>(self, other: I) -> bool`	`let equal = matches.eq(other_matches);`	Проверяет равенство элементов
eq_by	`fn eq_by<I, F>(self, other: I, eq: F) -> bool`	`let equal = matches.eq_by(other_matches,	a, b
ne (с версии 1.5.0)	`fn ne<I>(self, other: I) -> bool`	`let not_equal = matches.ne(other_matches);`	Проверяет неравенство элементов
lt (с версии 1.5.0)	`fn lt<I>(self, other: I) -> bool`	`let less = matches.lt(other_matches);`	Проверяет, меньше ли элементы
le (с версии 1.5.0)	`fn le<I>(self, other: I) -> bool`	`let less_equal = matches.le(other_matches);`	Проверяет, меньше или равны ли элементы
gt (с версии 1.5.0)	`fn gt<I>(self, other: I) -> bool`	`let greater = matches.gt(other_matches);`	Проверяет, больше ли элементы
ge (с версии 1.5.0)	`fn ge<I>(self, other: I) -> bool`	`let greater_equal = matches.ge(other_matches);`	Проверяет, больше или равны ли элементы
is_sorted (с версии 1.82.0)	`fn is_sorted(self) -> bool`	`let sorted = matches.is_sorted();`	Проверяет, отсортированы ли элементы
is_sorted_by (с версии 1.82.0)	`fn is_sorted_by<F>(self, compare: F) -> bool`	`let sorted = matches.is_sorted_by(	a, b
is_sorted_by_key (с версии 1.82.0)	`fn is_sorted_by_key<F, K>(self, f: F) -> bool`	`let sorted = matches.is_sorted_by_key(	s

impl<'a, P> FusedIterator for Matches<'a, P>

#![allow(unused)]
fn main() {
where
    P: Pattern,
}

Функция	Синтаксис	Пример	Назначение
(Этот трейт не добавляет новых методов, а только гарантирует, что после первого `None` все последующие вызовы `next()` также будут возвращать `None`. Это свойство наследуется от итератора.)

Автоматические реализации трейтов

Трейт	Условия реализации
`Freeze`	Если `Pattern::Searcher<'a>: Freeze`
`RefUnwindSafe`	Если `Pattern::Searcher<'a>: RefUnwindSafe`
`Send`	Если `Pattern::Searcher<'a>: Send`
`Sync`	Если `Pattern::Searcher<'a>: Sync`
`Unpin`	Если `Pattern::Searcher<'a>: Unpin`
`UnwindSafe`	Если `Pattern::Searcher<'a>: UnwindSafe`

Библиотека RUST