Структура Lines

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

Итератор по строкам текста (линиям) в виде срезов строк.

Эта структура создается методом lines для типа str. Подробнее см. в его документации.

Методы

impl<'a> Lines<'a>

Функция	Синтаксис	Пример	Назначение
remainder	`pub fn remainder(&self) -> Option<&'a str>`	`let remaining = lines.remainder();`	🔬 Экспериментальное API Возвращает оставшиеся строки разделенного текста

Примеры

#![allow(unused)]
#![feature(str_lines_remainder)]

fn main() {
let mut lines = "a\nb\nc\nd".lines();
assert_eq!(lines.remainder(), Some("a\nb\nc\nd"));

lines.next();
assert_eq!(lines.remainder(), Some("b\nc\nd"));

lines.by_ref().for_each(drop);
assert_eq!(lines.remainder(), None);
}

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

impl<'a> Clone for Lines<'a>

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

impl<'a> Debug for Lines<'a>

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

impl<'a> DoubleEndedIterator for Lines<'a>

Функция	Синтаксис	Пример	Назначение
next_back	`fn next_back(&mut self) -> Option<&'a str>`	`let last_line = lines.next_back();`	Удаляет и возвращает элемент с конца итератора
advance_back_by	`fn advance_back_by(&mut self, n: usize) -> Result<(), NonZero<usize>>`	`lines.advance_back_by(2)?;`	🔬 Перемещает итератор с конца на n элементов
nth_back (с версии 1.37.0)	`fn nth_back(&mut self, n: usize) -> Option<Self::Item>`	`let second_last = lines.nth_back(1);`	Возвращает n-й элемент с конца итератора
try_rfold (с версии 1.27.0)	`fn try_rfold<B, F, R>(&mut self, init: B, f: F) -> R`	`let concat = lines.try_rfold(String::new(),	mut s, line
rfold (с версии 1.27.0)	`fn rfold<B, F>(self, init: B, f: F) -> B`	`let concat = lines.rfold(String::new(),	mut s, line
rfind (с версии 1.27.0)	`fn rfind<P>(&mut self, predicate: P) -> Option<Self::Item>`	`let last_empty = lines.rfind(	line

impl<'a> Iterator for Lines<'a>

Функция	Синтаксис	Пример	Назначение
type Item	`type Item = &'a str`	-	Тип элементов, по которым выполняется итерация (срез строки)
next	`fn next(&mut self) -> Option<&'a str>`	`let first_line = lines.next();`	Перемещает итератор и возвращает следующее значение
size_hint	`fn size_hint(&self) -> (usize, Option<usize>)`	`let hint = lines.size_hint();`	Возвращает границы оставшейся длины итератора
last	`fn last(self) -> Option<&'a str>`	`let last_line = lines.last();`	Возвращает последний элемент итератора
next_chunk	`fn next_chunk<const N: usize>(&mut self) -> Result<[Self::Item; N], IntoIter<Self::Item, N>>`	`let chunk = lines.next_chunk::<3>()?;`	🔬 Возвращает массив, содержащий следующие N значений
count	`fn count(self) -> usize`	`let total_lines = lines.count();`	Подсчитывает количество итераций и возвращает его
advance_by	`fn advance_by(&mut self, n: usize) -> Result<(), NonZero<usize>>`	`lines.advance_by(2)?;`	🔬 Перемещает итератор на n элементов
nth	`fn nth(&mut self, n: usize) -> Option<Self::Item>`	`let third_line = lines.nth(2);`	Возвращает n-й элемент итератора
step_by (с версии 1.28.0)	`fn step_by(self, step: usize) -> StepBy<Self> ⓘ`	`let every_second = lines.step_by(2);`	Создает итератор с заданным шагом
chain	`fn chain<U>(self, other: U) -> Chain<Self, <U as IntoIterator>::IntoIter> ⓘ`	`let combined = lines.chain(more_lines);`	Объединяет два итератора в последовательный
zip	`fn zip<U>(self, other: U) -> Zip<Self, <U as IntoIterator>::IntoIter> ⓘ`	`let paired = lines.zip(other_lines);`	"Объединяет" два итератора в итератор пар
intersperse	`fn intersperse(self, separator: Self::Item) -> Intersperse<Self> ⓘ`	`let with_newline = lines.intersperse("\n");`	🔬 Помещает копию `separator` между элементами
intersperse_with	`fn intersperse_with<G>(self, separator: G) -> IntersperseWith<Self, G> ⓘ`	`let with_sep = lines.intersperse_with(
map	`fn map<B, F>(self, f: F) -> Map<Self, F> ⓘ`	`let uppercased = lines.map(	line
for_each	`fn for_each<F>(self, f: F)`	`lines.for_each(	line
filter	`fn filter<P>(self, predicate: P) -> Filter<Self, P> ⓘ`	`let non_empty = lines.filter(	line
filter_map	`fn filter_map<B, F>(self, f: F) -> FilterMap<Self, F> ⓘ`	`let lengths = lines.filter_map(	line
enumerate	`fn enumerate(self) -> Enumerate<Self> ⓘ`	`for (i, line) in lines.enumerate() { ... }`	Добавляет индекс к каждому элементу
peekable	`fn peekable(self) -> Peekable<Self> ⓘ`	`let peekable = lines.peekable();`	Создает итератор с возможностью просмотра следующего элемента
skip_while	`fn skip_while<P>(self, predicate: P) -> SkipWhile<Self, P> ⓘ`	`let skipped = lines.skip_while(	line
take_while	`fn take_while<P>(self, predicate: P) -> TakeWhile<Self, P> ⓘ`	`let taken = lines.take_while(	line
map_while (с версии 1.57.0)	`fn map_while<B, P>(self, predicate: P) -> MapWhile<Self, P> ⓘ`	`let mapped = lines.map_while(	line
skip	`fn skip(self, n: usize) -> Skip<Self> ⓘ`	`let skipped = lines.skip(3);`	Пропускает первые n элементов
take	`fn take(self, n: usize) -> Take<Self> ⓘ`	`let taken = lines.take(5);`	Берет первые n элементов
scan	`fn scan<St, B, F>(self, initial_state: St, f: F) -> Scan<Self, St, F> ⓘ`	`let scanned = lines.scan(0,	state, line
flat_map	`fn flat_map<U, F>(self, f: F) -> FlatMap<Self, U, F> ⓘ`	`let words = lines.flat_map(	line
flatten (с версии 1.29.0)	`fn flatten(self) -> Flatten<Self> ⓘ`	`let flattened = lines.flatten();`	Сглаживает вложенную структуру
map_windows	`fn map_windows<F, R, const N: usize>(self, f: F) -> MapWindows<Self, F, N> ⓘ`	`let windows = lines.map_windows::<_, _, 2>(	arr
fuse	`fn fuse(self) -> Fuse<Self> ⓘ`	`let fused = lines.fuse();`	Создает итератор, завершающийся после первого `None`
inspect	`fn inspect<F>(self, f: F) -> Inspect<Self, F> ⓘ`	`let inspected = lines.inspect(	line
by_ref	`fn by_ref(&mut self) -> &mut Self`	`let part = lines.by_ref().take(5).collect::<Vec<_>>();`	Создает адаптер "по ссылке" для итератора
collect	`fn collect<B>(self) -> B`	`let vec: Vec<&str> = lines.collect();`	Преобразует итератор в коллекцию
try_collect	`fn try_collect<B>(&mut self) -> <<Self::Item as Try>::Residual as Residual<B>>::TryType`	`let result: Result<Vec<&str>, _> = lines.try_collect();`	🔬 Преобразует итератор в коллекцию с обработкой ошибок
collect_into	`fn collect_into<E>(self, collection: &mut E) -> &mut E`	`let mut vec = Vec::new(); lines.collect_into(&mut vec);`	🔬 Собирает все элементы в коллекцию
partition	`fn partition<B, F>(self, f: F) -> (B, B)`	`let (short, long): (Vec<&str>, Vec<&str>) = lines.partition(	line
partition_in_place	`fn partition_in_place<'a, T, P>(self, predicate: P) -> usize`	`let count = lines.partition_in_place(	line
is_partitioned	`fn is_partitioned<P>(self, predicate: P) -> bool`	`let partitioned = lines.is_partitioned(	line
try_fold (с версии 1.27.0)	`fn try_fold<B, F, R>(&mut self, init: B, f: F) -> R`	`let total_len = lines.try_fold(0,	acc, line
try_for_each (с версии 1.27.0)	`fn try_for_each<F, R>(&mut self, f: F) -> R`	`let result: Result<(), _> = lines.try_for_each(	line
fold	`fn fold<B, F>(self, init: B, f: F) -> B`	`let total_len = lines.fold(0,	acc, line
reduce (с версии 1.51.0)	`fn reduce<F>(self, f: F) -> Option<Self::Item>`	`let longest = lines.reduce(	a, b
try_reduce	`fn try_reduce<R>(&mut self, f: impl FnMut(Self::Item, Self::Item) -> R) -> <<R as Try>::Residual as Residual<Option<<R as Try>::Output>>>::TryType`	`let result: Result<Option<&str>, _> = lines.try_reduce(	a, b
all	`fn all<F>(&mut self, f: F) -> bool`	`let all_non_empty = lines.all(	line
any	`fn any<F>(&mut self, f: F) -> bool`	`let has_empty = lines.any(	line
find	`fn find<P>(&mut self, predicate: P) -> Option<Self::Item>`	`let first_long = lines.find(	line
find_map (с версии 1.30.0)	`fn find_map<B, F>(&mut self, f: F) -> Option<B>`	`let first_num = lines.find_map(	line
try_find	`fn try_find<R>(&mut self, f: impl FnMut(&Self::Item) -> R) -> <<R as Try>::Residual as Residual<Option<Self::Item>>>::TryType`	`let result: Result<Option<&str>, _> = lines.try_find(	line
position	`fn position<P>(&mut self, predicate: P) -> Option<usize>`	`let pos = lines.position(	line
rposition	`fn rposition<P>(&mut self, predicate: P) -> Option<usize>`	`let pos = lines.rposition(	line
max	`fn max(self) -> Option<Self::Item>`	`let longest = lines.max();`	Возвращает максимальный элемент (лексикографически)
min	`fn min(self) -> Option<Self::Item>`	`let shortest = lines.min();`	Возвращает минимальный элемент (лексикографически)
max_by_key (с версии 1.6.0)	`fn max_by_key<B, F>(self, f: F) -> Option<Self::Item>`	`let longest = lines.max_by_key(	line
max_by (с версии 1.15.0)	`fn max_by<F>(self, compare: F) -> Option<Self::Item>`	`let longest = lines.max_by(	a, b
min_by_key (с версии 1.6.0)	`fn min_by_key<B, F>(self, f: F) -> Option<Self::Item>`	`let shortest = lines.min_by_key(	line
min_by (с версии 1.15.0)	`fn min_by<F>(self, compare: F) -> Option<Self::Item>`	`let shortest = lines.min_by(	a, b
rev	`fn rev(self) -> Rev<Self> ⓘ`	`let reversed = lines.rev();`	Изменяет направление итератора
unzip	`fn unzip<A, B, FromA, FromB>(self) -> (FromA, FromB)`	`let (lines, lengths): (Vec<&str>, Vec) = lines.map(	line
copied (с версии 1.36.0)	`fn copied<'a, T>(self) -> Copied<Self> ⓘ`	`let copied_lines = lines.copied();`	Создает итератор, который копирует все элементы
cloned	`fn cloned<'a, T>(self) -> Cloned<Self> ⓘ`	`let cloned_lines = lines.cloned();`	Создает итератор, который клонирует все элементы
cycle	`fn cycle(self) -> Cycle<Self> ⓘ`	`let cycled = lines.cycle();`	Бесконечно повторяет итератор
array_chunks	`fn array_chunks<const N: usize>(self) -> ArrayChunks<Self, N> ⓘ`	`for chunk in lines.array_chunks::<3>() { ... }`	🔬 Возвращает итератор по N элементов за раз
sum (с версии 1.11.0)	`fn sum<S>(self) -> S`	`let total_len: usize = lines.map(	line
product (с версии 1.11.0)	`fn product<P>(self) -> P`	`let product: usize = lines.map(	line
cmp (с версии 1.5.0)	`fn cmp<I>(self, other: I) -> Ordering`	`let ordering = lines.cmp(other_lines);`	Лексикографически сравнивает элементы с другими
cmp_by	`fn cmp_by<I, F>(self, other: I, cmp: F) -> Ordering`	`let ordering = lines.cmp_by(other_lines,	a, b
partial_cmp (с версии 1.5.0)	`fn partial_cmp<I>(self, other: I) -> Option<Ordering>`	`let ordering = lines.partial_cmp(other_lines);`	Частично сравнивает элементы с другими
partial_cmp_by	`fn partial_cmp_by<I, F>(self, other: I, partial_cmp: F) -> Option<Ordering>`	`let ordering = lines.partial_cmp_by(other_lines,	a, b
eq (с версии 1.5.0)	`fn eq<I>(self, other: I) -> bool`	`let equal = lines.eq(other_lines);`	Проверяет равенство элементов с другими
eq_by	`fn eq_by<I, F>(self, other: I, eq: F) -> bool`	`let equal = lines.eq_by(other_lines,	a, b
ne (с версии 1.5.0)	`fn ne<I>(self, other: I) -> bool`	`let not_equal = lines.ne(other_lines);`	Проверяет неравенство элементов с другими
lt (с версии 1.5.0)	`fn lt<I>(self, other: I) -> bool`	`let less = lines.lt(other_lines);`	Проверяет, меньше ли элементы, чем другие
le (с версии 1.5.0)	`fn le<I>(self, other: I) -> bool`	`let less_or_equal = lines.le(other_lines);`	Проверяет, меньше или равны ли элементы
gt (с версии 1.5.0)	`fn gt<I>(self, other: I) -> bool`	`let greater = lines.gt(other_lines);`	Проверяет, больше ли элементы, чем другие
ge (с версии 1.5.0)	`fn ge<I>(self, other: I) -> bool`	`let greater_or_equal = lines.ge(other_lines);`	Проверяет, больше или равны ли элементы
is_sorted (с версии 1.82.0)	`fn is_sorted(self) -> bool`	`let sorted = lines.is_sorted();`	Проверяет, отсортированы ли элементы
is_sorted_by (с версии 1.82.0)	`fn is_sorted_by<F>(self, compare: F) -> bool`	`let sorted = lines.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 = lines.is_sorted_by_key(	line

impl FusedIterator for Lines<'_> (с версии 1.26.0)

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

#![allow(unused)]
fn main() {
impl<'a> Freeze for Lines<'a>
impl<'a> RefUnwindSafe for Lines<'a>
impl<'a> Send for Lines<'a>
impl<'a> Sync for Lines<'a>
impl<'a> Unpin for Lines<'a>
impl<'a> UnwindSafe for Lines<'a>
}

Общие реализации

#![allow(unused)]
fn main() {
impl<T> Any for T
where
    T: 'static + ?Sized,
}

#![allow(unused)]
fn main() {
impl<T> Borrow<T> for T
where
    T: ?Sized,
}

#![allow(unused)]
fn main() {
impl<T> BorrowMut<T> for T
where
    T: ?Sized,
}

#![allow(unused)]
fn main() {
impl<T> CloneToUninit for T
where
    T: Clone,
}

#![allow(unused)]
fn main() {
impl<T> From<T> for T
}

#![allow(unused)]
fn main() {
impl<T, U> Into<U> for T
where
    U: From<T>,
}

#![allow(unused)]
fn main() {
impl<I> IntoIterator for I
where
    I: Iterator,
}

#![allow(unused)]
fn main() {
impl<T> ToOwned for T
where
    T: Clone,
}

#![allow(unused)]
fn main() {
impl<T, U> TryFrom<U> for T
where
    U: Into<T>,
}

#![allow(unused)]
fn main() {
impl<T, U> TryInto<U> for T
where
    U: TryFrom<T>,
}

Обозначения:

🔬 - экспериментальное API, доступное только в ночных сборках
ⓘ - обозначение, что функция возвращает итератор

Библиотека RUST