функция Iterable::takeWhile

Возвращает коллекцию первых элементов удовлетворяющих пользовательской функции

Синтаксис

Iterable[E]
Iterable.takeWhile
(bool test(E value))

Передаваемые параметры

bool test(E value)

Возвращаемое значение

Iterable[E]

Описание

Метод takeWhile позволяет получить новую коллекцию (составной объект), состоящую из первых элементов исходной, которые удовлетворяют пользовательской callback-функции bool test(E value). Как только встречается элементы, для которого результат bool test(E value) равняется false, формирование новой коллекции заканчивается.

Если все элементы исходной коллекцию удовлетворяют пользовательской callback-функции bool test(E value), то новая коллекцию будет соответствовать исходной.

Данный метод использует "ленивую" инициализацию новой коллекции. До тех пор, пока к элементам нового объекта не будет ни одного обращения, пользовательская функция bool test(E value) вызываться не будет и новые значения получены не будут. Кроме этого, значения элементов не будут кешироваться, и таким образом повторная итерация по новой коллекции будет приводить к повторному вызову пользовательской callback-функции.

Смотрите также

Iterable::skip - Возвращает коллекцию без первых n элементов
Iterable::skipWhile - Возвращает коллекцию без первых элементов удовлетворяющих пользовательской функции
Iterable::take - Возвращает коллекцию содержащую не более n элементов

Официальная документация (английский)