Класс scala.collection.AbstractIterator

абстрактный класс AbstractIterator[+A] extends Iterator[A]

Явное создание экземпляра Iterator трейта, чтобы уменьшить размер файла класса в подклассах.

Источник: Iterator.scala

Линейные супертипы

Известные подклассы

Конструкторы экземпляров

new AbstractIterator()

Типовые члены

класс GroupedIterator[B >: A] extends AbstractIterator[Seq[B]] with Iterator[Seq[B]]

Гибкий итератор для преобразования Iterator[A] в Iterator[Seq[A]], с настраиваемым размером последовательности, шагом и стратегией обработки элементов, которые не подходят к размеру последовательности равномерно.

Типичные использования могут быть реализованы через методы grouped и sliding.

Определяющие классы: Iterator

Абстрактные значения-члены

абстрактный def hasNext: Boolean

Проверяет, может ли этот итератор предоставить ещё один элемент.

возвращает: true , если последующий вызов next вернёт элемент, false в противном случае.

Определяющие классы: Iterator
Примечание: Повторное использование: итератор остаётся допустимым для дальнейшего использования, независимо от возвращаемого результата.

абстрактный def next(): A

Производит следующий элемент этого итератора.

возвращает: следующий элемент этого итератора, если hasNext является true, в противном случае поведение не определено.

Определяющие классы: Iterator
Примечание: Повторное использование: итератор остаётся допустимым для дальнейшего использования, независимо от возвращаемого результата.

Члены-значения конкретного типа

final def !=(arg0: Any): Boolean

Тестирует неравенство двух объектов.

возвращает: true если !(this == that), в противном случае false.

Definition Classes: AnyRef → Any

final def ##(): Int

Эквивалентно x.hashCode за исключением упакованных числовых типов и null. Для числовых типов возвращается значение хэша, согласованное с равенством значений: если два экземпляра типа значения сравниваются как true, то ## будет генерировать одинаковое значение хэша для каждого из них. Для null возвращается хэш-код, где null.hashCode генерирует NullPointerException.

возвращает: значение хэша, согласованное с ==

Definition Classes: AnyRef → Any

def +(other: String): String

Неявный: Этот член добавлен с помощью неявного преобразования из AbstractIterator[A] в any2stringadd[AbstractIterator[A]], выполненного методом any2stringadd в scala.Predef.
Definition Classes: any2stringadd

def ++(that: ⇒ Iterator[A]): Iterator[A]

[сценарий использования]

Конкатенация текущего итератора с другим.

that: другой итератор
возвращает: новый итератор, который сначала возвращает значения, производимые текущим итератором, а затем — значения, производимые итератором that.

Definition Classes: Iterator

def ->[B](y: B): (AbstractIterator[A], B)

Неявный: Этот член добавлен с помощью неявного преобразования из AbstractIterator[A] в ArrowAssoc[AbstractIterator[A]], выполненного методом ArrowAssoc в scala.Predef.
Definition Classes: ArrowAssoc
Аннотации: @inline()

def /:[B](z: B)(op: (B, A) ⇒ B): B

Применяет бинарный оператор к начальному значению и всем элементам этого итерабельного или итератора, слева направо.

Примечание: /: — альтернативная синтаксическая конструкция для foldLeft; z /: xs равно xs foldLeft z.

Примеры:

Обратите внимание, что функция свертки, используемая для вычисления b, эквивалентна функции, используемой для вычисления c.

scala> val a = List(1,2,3,4)
a: List[Int] = List(1, 2, 3, 4)

scala> val b = (5 /: a)(_+_)
b: Int = 15

scala> val c = (5 /: a)((x,y) => x + y)
c: Int = 15

Примечание: не завершается для бесконечных коллекций.

Примечание: может возвращать разные результаты для разных запусков, если тип базовой коллекции не упорядочен или оператор не ассоциативен и коммутативен.

B

тип результата бинарного оператора.

z

начальное значение.

op

бинарный оператор.

возвращает

результат вставки op между последовательными элементами этого итерабельного или итератора слева направо с начальным значением z слева:

op(...op(op(z, x_1), x_2), ..., x_n)

где x₁, ..., x_n — элементы этого итерабельного или итератора.

Definition Classes: TraversableOnce → GenTraversableOnce

def :\[B](z: B)(op: (A, B) ⇒ B): B

Применяет бинарный оператор ко всем элементам этого итерабельного или итератора и начальному значению, справа налево.

Примечание: :\ — альтернативная синтаксическая конструкция для foldRight; xs :\ z равно xs foldRight z.

Примечание: не завершается для бесконечных коллекций.

Примеры:

scala> val a = List(1,2,3,4)
a: List[Int] = List(1, 2, 3, 4)

scala> val b = (a :\ 5)(_+_)
b: Int = 15

scala> val c = (a :\ 5)((x,y) => x + y)
c: Int = 15

B

тип результата бинарного оператора.

z

начальное значение

op

бинарный оператор

возвращает

результат вставки op между последовательными элементами этого итерабельного или итератора справа налево с начальным значением z справа:

op(x_1, op(x_2, ... op(x_n, z)...))

где x₁, ..., x_n — элементы этого итерабельного или итератора.

Definition Classes: TraversableOnce → GenTraversableOnce

final def ==(arg0: Any): Boolean

Выражение x == that эквивалентно if (x eq null) that eq null else x.equals(that).

возвращает: true если объект-получатель эквивалентен аргументу; false в противном случае.

Definition Classes: AnyRef → Any

def addString(b: StringBuilder): StringBuilder

Добавляет все элементы этого обхода или итератора к строковому билдеру. Записанный текст состоит из строковых представлений (относительно метода toString) всех элементов этого обхода или итератора без каких-либо разделительных строк.

Пример:

scala> val a = List(1,2,3,4)
a: List[Int] = List(1, 2, 3, 4)

scala> val b = new StringBuilder()
b: StringBuilder =

scala> val h = a.addString(b)
h: StringBuilder = 1234

b: строковый билдер, к которому добавляются элементы.
returns: строковый билдер b, к которому были добавлены элементы.

Определяющие классы: TraversableOnce

def addString(b: StringBuilder, sep: String): StringBuilder

Добавляет все элементы этого обхода или итератора к строковому билдеру, используя разделительную строку. Записанный текст состоит из строковых представлений (относительно метода toString) всех элементов этого обхода или итератора, разделенных строкой sep.

Пример:

scala> val a = List(1,2,3,4)
a: List[Int] = List(1, 2, 3, 4)

scala> val b = new StringBuilder()
b: StringBuilder =

scala> a.addString(b, ", ")
res0: StringBuilder = 1, 2, 3, 4

b: строковый билдер, к которому добавляются элементы.
sep: разделительная строка.
returns: строковый билдер b, к которому были добавлены элементы.

Определяющие классы: TraversableOnce

def addString(b: StringBuilder, start: String, sep: String, end: String): StringBuilder

Добавляет все элементы этого обхода или итератора к строковому билдеру, используя начальную, конечную и разделительные строки. Записанный текст начинается со строки start и заканчивается строкой end. Внутри, строковые представления (относительно метода toString) всех элементов этого обхода или итератора разделены строкой sep.

Пример:

scala> val a = List(1,2,3,4)
a: List[Int] = List(1, 2, 3, 4)

scala> val b = new StringBuilder()
b: StringBuilder =

scala> a.addString(b , "List(" , ", " , ")")
res5: StringBuilder = List(1, 2, 3, 4)

b: строковый билдер, к которому добавляются элементы.
start: начальная строка.
sep: разделительная строка.
end: конечная строка.
returns: строковый билдер b, к которому были добавлены элементы.

Определяющие классы: TraversableOnce

def aggregate[B](z: ⇒ B)(seqop: (B, A) ⇒ B, combop: (B, B) ⇒ B): B

Агрегирует результаты применения оператора к последующим элементам.

Это более общая форма fold и reduce. Она похожа на foldLeft тем, что не требует, чтобы результат был супертипом типа элемента. Кроме того, она позволяет обрабатывать параллельные коллекции частями, а затем объединять промежуточные результаты.

aggregate разделяет обход или итератор на разделы и обрабатывает каждый раздел, последовательно применяя seqop, начиная с z (как foldLeft). Затем эти промежуточные результаты объединяются с помощью combop (как fold). Реализация этой операции может работать с произвольным количеством разделов коллекции (даже 1), поэтому combop может вызываться произвольное количество раз (даже 0).

В качестве примера рассмотрим суммирование целочисленных значений списка символов. Начальное значение для суммы равно 0. Сначала seqop преобразует каждый входной символ в Int и добавляет его к сумме (раздела). Затем combop просто нужно суммировать промежуточные результаты разделов:

List('a', 'b', 'c').aggregate(0)({ (sum, ch) => sum + ch.toInt }, { (p1, p2) => p1 + p2 })

B: тип накопленных результатов
z: начальное значение для накопленного результата раздела — обычно это будет нейтральный элемент для оператора seqop (например, Nil для конкатенации списков или 0 для суммирования) и может вычисляться более одного раза
seqop: оператор, используемый для накопления результатов внутри раздела
combop: ассоциативный оператор, используемый для объединения результатов из разных разделов

Определяющие классы: TraversableOnce → GenTraversableOnce

final def asInstanceOf[T0]: T0

Преобразует принимающий объект в тип T0.

Обратите внимание, что успех преобразования во время выполнения зависит от семантики стирания Scala. Поэтому выражение 1.asInstanceOf[String] вызовет ClassCastException во время выполнения, а выражение List(1).asInstanceOf[List[String]] — нет. В последнем примере, поскольку аргумент типа стирается во время компиляции, невозможно проверить, соответствуют ли содержимое списка запрашиваемому типу.

returns: принимающий объект.

Определяющие классы: Any
Возбуждаемые исключения: ClassCastException если принимающий объект не является экземпляром стирания типа T0.

def buffered: BufferedIterator[A]

Создает буферизованный итератор из этого итератора.

returns: буферизованный итератор, возвращающий те же значения, что и этот итератор.

Определяющие классы: Iterator
Примечание: Повторное использование: после вызова этого метода следует отказаться от итератора, к которому он был применен, и использовать только возвращенный итератор. Использование старого итератора не определено, может быть изменено и может привести к изменениям нового итератора.
См. также: scala.collection.BufferedIterator

def clone(): AnyRef

Создайте копию объекта получателя.

По умолчанию реализация метода clone зависит от платформы.

возвращает: копию объекта получателя.

Атрибуты: protected[lang]
Определяющие классы: AnyRef
Аннотации: @throws( ... ) @native()
Примечание: не указано SLS как член AnyRef

def collect[B](pf: PartialFunction[A, B]): Iterator[B]

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

pf: частичная функция, которая фильтрует и отображает итератор.
возвращает: новый итератор, который выдает каждое значение x , производимое этим итератором, для которого pf определена, изображение pf(x).

Определяющие классы: Iterator
Аннотации: @migration
Миграция: (Изменено в версии 2.8.0) collect изменилось. Предыдущее поведение можно воспроизвести с помощью toSeq.
Примечание: Повторное использование: после вызова этого метода следует удалить вызываемый итератор и использовать только возвращённый итератор. Использование старого итератора не определено, может измениться и может привести к изменениям в новом итераторе также.

def collectFirst[B](pf: PartialFunction[A, B]): Option[B]

Находит первый элемент в итерабельной последовательности или итераторе, для которого заданная частичная функция определена, и применяет частичную функцию к нему.

Примечание: может не завершаться для бесконечных коллекций.

Примечание: может возвращать разные результаты при разных запусках, если тип коллекции не упорядочен.

pf: частичная функция
возвращает: значения Option, содержащие pf, применённое к первому значению, для которого оно определено, или None , если такого значения нет.

Определяющие классы: TraversableOnce

def contains(elem: Any): Boolean

Проверяет, содержит ли этот итератор заданное значение в качестве элемента.

Примечание: может не завершиться для бесконечных итераторов.

elem: тестируемый элемент.
возвращает: true , если этот итератор производит какое-то значение, которое равно (как определено ==) elem, false в противном случае.

Определяющие классы: Iterator
Примечание: Повторное использование: после вызова этого метода следует удалить вызываемый итератор. Его использование не определено и может быть изменено.

def copyToArray(xs: Array[A], start: Int, len: Int): Unit

[use case]

Копирует выбранные значения, производимые этим итератором, в массив. Заполняет заданный массив xs , начиная с индекса start , с максимум len значениями, производимыми этим итератором. Копирование прекратится, как только будет достигнут конец текущего итератора, или конец массива, или len элементы были скопированы.

Примечание: не завершится для бесконечных итераторов.

xs: массив для заполнения.
start: начальный индекс.
len: максимальное количество копируемых элементов.

Определяющие классы: Iterator → TraversableOnce → GenTraversableOnce

def copyToArray(xs: Array[A]): Unit

[use case]

Копирует элементы этой последовательности или итератора в массив. Заполняет заданный массив xs значениями этой последовательности или итератора. Копирование прекратится, как только будет достигнут конец текущей последовательности или итератора, или конец целевого массива.

Примечание: не завершится для бесконечных итераторов.

xs: массив для заполнения.

Определяющие классы: TraversableOnce → GenTraversableOnce

def copyToArray(xs: Array[A], start: Int): Unit

[use case]

Копирует элементы этой последовательности или итератора в массив. Заполняет заданный массив xs значениями этой последовательности или итератора, начиная с индекса start. Копирование прекратится, как только будет достигнут конец текущей последовательности или итератора, или конец целевого массива.

Примечание: не завершится для бесконечных итераторов.

xs: массив для заполнения.
start: начальный индекс.

Определяющие классы: TraversableOnce → GenTraversableOnce

def copyToBuffer[B >: A](dest: Buffer[B]): Unit

Копирует все элементы этой последовательности или итератора в буфер.

Примечание: не завершится для бесконечных коллекций.

dest: буфер, в который копируются элементы.

Определяющие классы: TraversableOnce

def corresponds[B](that: GenTraversableOnce[B])(p: (A, B) ⇒ Boolean): Boolean

Проверяет, соответствует ли каждый элемент этого итератора соответствующему элементу другого набора данных, удовлетворяя условию предиката.

B: тип элементов that
that: другой набор данных
p: предикат для проверки соответствия элементов из обоих наборов данных
returns: true если оба набора данных имеют одинаковую длину и p(x, y) равно true для всех соответствующих элементов x этого итератора и y из that, в противном случае false

Definition Classes: Iterator

def count(p: (A) ⇒ Boolean): Int

Подсчитывает количество элементов в наборе или итераторе, которые удовлетворяют предикату.

p: предикат для проверки элементов.
returns: количество элементов, удовлетворяющих предикату p.

Definition Classes: TraversableOnce → GenTraversableOnce

def drop(n: Int): Iterator[A]

Пропускает первые n элементов этого итератора или всю его длину, в зависимости от того, что меньше.

n: количество пропускаемых элементов
returns: итератор, который генерирует все значения текущего итератора, за исключением первых n значений.

Definition Classes: Iterator
Note: Переиспользование: После вызова этого метода следует удалить вызвавший его итератор и использовать только возвращённый. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новом итераторе тоже.

def dropWhile(p: (A) ⇒ Boolean): Iterator[A]

Пропускает самую длинную последовательность элементов этого итератора, удовлетворяющих данному предикату p, и возвращает итератор оставшихся элементов.

p: предикат для пропуска элементов.
returns: итератор, состоящий из оставшихся элементов

Definition Classes: Iterator
Note: Переиспользование: После вызова этого метода следует удалить вызвавший его итератор и использовать только возвращённый. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новом итераторе тоже.

def duplicate: (Iterator[A], Iterator[A])

Создаёт два новых итератора, которые оба итерируют по тем же элементам, что и этот итератор (в том же порядке). Дублируемые итераторы считаются равными, если они находятся на одном и том же элементе.

Поскольку большинство методов для итераторов делают исходный итератор непригодным для дальнейшего использования, этот метод предоставляет надёжный способ вызова нескольких таких методов для итератора.

returns: пара итераторов

Definition Classes: Iterator
Note: Реализация может выделять временное хранилище для элементов, проитерированных одним итератором, но ещё не другим.
,
Переиспользование: После вызова этого метода следует удалить вызвавший его итератор и использовать только возвращённые итераторы. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новых итераторах тоже.

def ensuring(cond: (AbstractIterator[A]) ⇒ Boolean, msg: ⇒ Any): AbstractIterator[A]

Неявный: Этот член добавлен неявным преобразованием из AbstractIterator[A] в Ensuring[AbstractIterator[A]] с помощью метода Ensuring в scala.Predef.
Definition Classes: Ensuring

def ensuring(cond: (AbstractIterator[A]) ⇒ Boolean): AbstractIterator[A]

Неявный: Этот член добавлен неявным преобразованием из AbstractIterator[A] в Ensuring[AbstractIterator[A]] с помощью метода Ensuring в scala.Predef.
Definition Classes: Ensuring

def ensuring(cond: Boolean, msg: ⇒ Any): AbstractIterator[A]

Неявный: Этот член добавлен неявным преобразованием из AbstractIterator[A] в Ensuring[AbstractIterator[A]], выполненным методом Ensuring в scala.Predef.
Классы определения: Ensuring

def ensuring(cond: Boolean): AbstractIterator[A]

Неявный: Этот член добавлен неявным преобразованием из AbstractIterator[A] в Ensuring[AbstractIterator[A]], выполненным методом Ensuring в scala.Predef.
Классы определения: Ensuring

final def eq(arg0: AnyRef): Boolean

Проверяет, является ли аргумент (that) ссылкой на объект-получатель (this).

Метод eq реализует отношение эквивалентности на не-null экземплярах AnyRef, и имеет три дополнительных свойства:

x

y

AnyRef

x.eq(y)

true

false

x

AnyRef

x.eq(null)

null.eq(x)

false

null.eq(null)

true

При переопределении методов equals или hashCode важно обеспечить, чтобы их поведение соответствовало равенству ссылок. Поэтому, если два объекта являются ссылками друг на друга (o1 eq o2), они должны быть равны друг другу (o1 == o2) и они должны хешироваться к одному и тому же значению (o1.hashCode == o2.hashCode).

возвращает: true если аргумент является ссылкой на объект-получатель; false в противном случае.

Классы определения: AnyRef

def equals(arg0: Any): Boolean

Метод равенства для типов ссылок. По умолчанию делегирует вызов к eq.

См. также equals в scala.Any.

возвращает: true если объект-получатель эквивалентен аргументу; false в противном случае.

Классы определения: AnyRef → Any

def exists(p: (A) ⇒ Boolean): Boolean

Проверяет, выполняется ли предикат для некоторых значений, производимых этим итератором.

Примечание: может не завершиться для бесконечных итераторов.

p: предикат для проверки элементов.
возвращает: true если данный предикат p выполняется для некоторых значений, производимых этим итератором, иначе false.

Классы определения: Iterator → TraversableOnce → GenTraversableOnce
Примечание: Переиспользование: После вызова этого метода необходимо выбросить итератор, на котором он был вызван. Использование его не определено и может быть изменено.

def filter(p: (A) ⇒ Boolean): Iterator[A]

Возвращает итератор по всем элементам этого итератора, которые удовлетворяют предикату p. Порядок элементов сохраняется.

p: предикат для проверки значений.
возвращает: итератор, который производит те значения этого итератора, которые удовлетворяют предикату p.

Классы определения: Iterator
Примечание: Переиспользование: После вызова этого метода необходимо выбросить итератор, на котором он был вызван, и использовать только возвращенный итератор. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новом итераторе тоже.

def filterNot(p: (A) ⇒ Boolean): Iterator[A]

Создаёт итератор по всем элементам этого итератора, которые не удовлетворяют предикату p.

p: предикат для проверки значений.
возвращает: итератор, который производит те значения этого итератора, которые не удовлетворяют предикату p.

Классы определения: Iterator
Примечание: Переиспользование: После вызова этого метода необходимо выбросить итератор, на котором он был вызван, и использовать только возвращенный итератор. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новом итераторе тоже.

def finalize(): Unit

Вызывается сборщиком мусора на объекте-получателе, когда больше нет ссылок на объект.

Подробности о том, когда и будет ли вызываться метод finalize, а также взаимодействие между finalize и нелокальными возвратами и исключениями, зависят от платформы.

Атрибуты: protected[lang]
Классы определения: AnyRef
Аннотации: @throws( classOf[java.lang.Throwable] )
Примечание: не указано SLS как член AnyRef

def find(p: (A) ⇒ Boolean): Option[A]

Находит первое значение, производимое итератором, удовлетворяющее предикату, если таковое есть.

Примечание: может не завершиться для бесконечных итераторов.

p: предикат, используемый для проверки значений.
returns: значение типа Option, содержащее первое значение, производимое итератором, которое удовлетворяет предикату p, или None если такого значения нет.

Definition Classes: Iterator → TraversableOnce → GenTraversableOnce
Note: Переиспользование: после вызова этого метода нужно удалить итератор, на котором был вызван метод. Использование исходного итератора не определено и может измениться.

def flatMap[B](f: (A) ⇒ GenTraversableOnce[B]): Iterator[B]

Создает новый итератор, применяя функцию ко всем значениям, производимым этим итератором, и конкатенируя результаты.

f: функция, применяемая к каждому элементу.
returns: итератор, полученный в результате применения заданной функции, принимающей итератор f к каждому значению, производимому этим итератором, и конкатенации результатов.

Definition Classes: Iterator
Note: Переиспользование: после вызова этого метода нужно удалить итератор, на котором был вызван метод, и использовать только возвращённый итератор. Использование старого итератора не определено, может измениться и может привести к изменениям в новом итераторе.

def fold[A1 >: A](z: A1)(op: (A1, A1) ⇒ A1): A1

Выполняет свёртку элементов этого обходчика или итератора с использованием указанного ассоциативного бинарного оператора.

Порядок выполнения операций над элементами не определён и может быть не детерминированным.

Примечание: не завершится для коллекций бесконечного размера.

A1: параметр типа для бинарного оператора, надтип A.
z: нейтральный элемент для операции свёртки; может быть добавлен к результату произвольное число раз, и не должен изменять результат (например, Nil для конкатенации списков, 0 для сложения или 1 для умножения).
op: бинарный оператор, который должен быть ассоциативным.
returns: результат применения оператора свёртки op между всеми элементами и z, или z если этот обходчик или итератор пустой.

Definition Classes: TraversableOnce → GenTraversableOnce

def foldLeft[B](z: B)(op: (B, A) ⇒ B): B

Применяет бинарный оператор к начальному значению и всем элементам этого обходчика или итератора слева направо.

Примечание: не завершится для коллекций бесконечного размера.

Примечание: может возвращать разные результаты при разных запусках, если тип базовой коллекции не упорядочен или оператор не ассоциативен и коммутативен.

B

тип результата бинарного оператора.

z

начальное значение.

op

бинарный оператор.

returns

результат вставки op между последовательными элементами этого обходчика или итератора слева направо с начальным значением z слева:

op(...op(z, x_1), x_2, ..., x_n)

где x₁, ..., x_n — элементы этого обходчика или итератора. Возвращает z если этот обходчик или итератор пустой.

Definition Classes: TraversableOnce → GenTraversableOnce

def foldRight[B](z: B)(op: (A, B) ⇒ B): B

Применяет бинарный оператор ко всем элементам этого обходчика или итератора и начальному значению, справа налево.

Примечание: не завершится для коллекций бесконечного размера.

B

тип результата бинарного оператора.

z

начальное значение.

op

бинарный оператор.

returns

результат вставки op между последовательными элементами этого обходчика или итератора справа налево с начальным значением z справа:

op(x_1, op(x_2, ... op(x_n, z)...))

где x₁, ..., x_n — элементы этого обходчика или итератора. Возвращает z если этот обходчик или итератор пустой.

Definition Classes: TraversableOnce → GenTraversableOnce

def forall(p: (A) ⇒ Boolean): Boolean

Проверяет, выполняется ли предикат для всех значений, производимых этим итератором.

Примечание: может не завершиться для бесконечных итераторов.

p: предикат, используемый для проверки элементов.
returns: true если данный предикат p выполняется для всех значений, производимых этим итератором, в противном случае false.

Definition Classes: Iterator → TraversableOnce → GenTraversableOnce
Note: Переиспользование: после вызова этого метода нужно удалить итератор, на котором был вызван метод. Использование исходного итератора не определено и может измениться.

def foreach(f: (A) ⇒ Unit): Unit

[use case]

Применяет функцию f ко всем значениям, производимым этим итератором.

f: функция, которая применяется для побочного эффекта к каждому элементу. Результат функции f игнорируется.

Классы определений: Iterator → TraversableOnce → GenTraversableOnce

def formatted(fmtstr: String): String

Возвращает строку, отформатированную в соответствии с заданной строкой format. Строки формата аналогичны строкам формата String.format (@см. java.lang.String.format).

Неявный: Этот член добавляется неявным преобразованием из AbstractIterator[A] в StringFormat[AbstractIterator[A]] с помощью метода StringFormat в scala.Predef.
Классы определений: StringFormat
Аннотации: @inline()

final def getClass(): Class[_]

Возвращает представление класса во время выполнения объекта.

возвращает: объект класса, соответствующий типу времени выполнения получателя.

Классы определений: AnyRef → Any
Аннотации: @native()

def grouped[B >: A](size: Int): GroupedIterator[B]

Возвращает итератор, который группирует этот итератор в блоки фиксированного размера. Примеры использования:

// Returns List(List(1, 2, 3), List(4, 5, 6), List(7)))
(1 to 7).iterator grouped 3 toList
// Returns List(List(1, 2, 3), List(4, 5, 6))
(1 to 7).iterator grouped 3 withPartial false toList
// Returns List(List(1, 2, 3), List(4, 5, 6), List(7, 20, 25)
// Illustrating that withPadding's argument is by-name.
val it2 = Iterator.iterate(20)(_ + 5)
(1 to 7).iterator grouped 3 withPadding it2.next toList

Классы определений: Iterator
Примечание: Переиспользование: После вызова этого метода необходимо удалить итератор, на котором он был вызван, и использовать только итератор, который был возвращён. Использование старого итератора является неопределённым, может изменяться и может привести к изменениям в новом итераторе также.

def hasDefiniteSize: Boolean

Проверяет, имеет ли этот итератор известный размер.

возвращает: true для пустых итераторов, false в противном случае.

Классы определений: Iterator → TraversableOnce → GenTraversableOnce
Примечание: Переиспользование: Итератор остаётся допустимым для дальнейшего использования независимо от возвращаемого результата.

def hashCode(): Int

Метод hashCode для ссылочных типов. См. hashCode в scala.Any.

возвращает: значение кода хэш-суммы для этого объекта.

Классы определений: AnyRef → Any
Аннотации: @native()

def indexOf[B >: A](elem: B, from: Int): Int

Возвращает индекс первого вхождения указанного объекта в этом итерируемом объекте после или на некотором начальном индексе.

Примечание: может не завершиться для бесконечных итераторов.

elem: элемент для поиска.
from: начальный индекс
возвращает: индекс >= from первого вхождения elem в значениях, производимых этим итератором, или -1, если такой элемент не существует до конца итератора.

Классы определений: Iterator
Примечание: Переиспользование: После вызова этого метода необходимо удалить итератор, на котором он был вызван. Его использование неопределённо и может изменяться.

def indexOf[B >: A](elem: B): Int

Возвращает индекс первого вхождения указанного объекта в этом итерируемом объекте.

Примечание: может не завершиться для бесконечных итераторов.

elem: элемент для поиска.
возвращает: индекс первого вхождения elem в значениях, производимых этим итератором, или -1, если такой элемент не существует до конца итератора.

Классы определений: Iterator
Примечание: Переиспользование: После вызова этого метода необходимо удалить итератор, на котором он был вызван. Его использование неопределённо и может изменяться.

def indexWhere(p: (A) ⇒ Boolean, from: Int): Int

Возвращает индекс первого значения, удовлетворяющего предикату, или -1, после или на некотором начальном индексе.

Примечание: может не завершиться для бесконечных итераторов.

p: предикат для проверки значений
from: начальный индекс
возвращает: индекс >= from первого значения, удовлетворяющего p, или -1, если такой элемент не существует до конца итератора.

Классы определений: Iterator
Примечание: Переиспользование: После вызова этого метода необходимо удалить итератор, на котором он был вызван. Его использование неопределённо и может изменяться.

def indexWhere(p: (A) ⇒ Boolean): Int

Возвращает индекс первого сгенерированного значения, удовлетворяющего предикату, или -1.

Примечание: может не завершаться для бесконечных итераторов.

p: предикат для проверки значений
returns: индекс первого сгенерированного значения, удовлетворяющего p, или -1, если такого элемента не существует до достижения конца итератора.

Definition Classes: Iterator
Note: Переиспользование: После вызова этого метода следует удалить итератор, на котором он был вызван. Использование его не определено и может быть изменено.

def isEmpty: Boolean

Проверяет, пуст ли этот итератор.

returns: true если hasNext ложно, false в противном случае.

Definition Classes: Iterator → TraversableOnce → GenTraversableOnce
Note: Переиспользование: итератор остается действительным для дальнейшего использования, независимо от возвращаемого результата.

final def isInstanceOf[T0]: Boolean

Проверяет, является ли динамический тип получаемого объекта T0.

Обратите внимание, что результат проверки выполняется с учётом стирания типов Scala. Следовательно, выражение 1.isInstanceOf[String] вернёт false, а выражение List(1).isInstanceOf[List[String]] вернёт true. В последнем примере, так как тип аргумента стирается во время компиляции, проверить, являются ли содержимое списка указанного типа, невозможно.

returns: true если получаемый объект является экземпляром стираемого типа T0; false в противном случае.

Definition Classes: Any

def isTraversableAgain: Boolean

Проверяет, можно ли повторно пройти по этому итератору.

returns: false

Definition Classes: Iterator → GenTraversableOnce
Note: Переиспользование: итератор остается действительным для дальнейшего использования, независимо от возвращаемого результата.

def length: Int

Возвращает количество элементов в этом итераторе.

Примечание: не будет завершаться для бесконечных итераторов.

Definition Classes: Iterator
Note: Переиспользование: После вызова этого метода следует удалить итератор, на котором он был вызван. Использование его не определено и может быть изменено.

def map[B](f: (A) ⇒ B): Iterator[B]

Создает новый итератор, который отображает все произведенные значения этого итератора в новые значения с помощью функции преобразования.

f: функция преобразования
returns: новый итератор, который преобразует каждое значение, произведенное этим итератором, применяя функцию f к нему.

Definition Classes: Iterator
Note: Переиспользование: После вызова этого метода следует удалить вызвавший итератор и использовать только возвращённый итератор. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новом итераторе.

def max: A

[use case]

Находит наибольший элемент.

returns: наибольший элемент этого итератора или коллекции.

Definition Classes: TraversableOnce → GenTraversableOnce
Исключения: UnsupportedOperationException если этот итератор или коллекция пуста.

def maxBy[B](f: (A) ⇒ B): A

[use case]

Находит первый элемент, который даёт наибольшее значение, измеряемое функцией f.

B: Тип результата функции f.
f: Функция измерения.
returns: первый элемент этого итератора или коллекции с наибольшим значением, измеренным функцией f.

Definition Classes: TraversableOnce → GenTraversableOnce
Исключения: UnsupportedOperationException если этот итератор или коллекция пуста.

def min: A

[use case]

Находит наименьший элемент.

returns: наименьший элемент этого итератора или коллекции

Definition Classes: TraversableOnce → GenTraversableOnce
Исключения: UnsupportedOperationException если этот итератор или коллекция пуста.

def minBy[B](f: (A) ⇒ B): A

[use case]

Находит первый элемент, который даёт наименьшее значение, измеренное функцией f.

B: Тип результата функции f.
f: Функция измерения.
returns: первый элемент этого перебираемого объекта или итератора с наименьшим значением, измеренным функцией f.

Definition Classes: TraversableOnce → GenTraversableOnce
Исключения: UnsupportedOperationException, если этот перебираемый объект или итератор пуст.

def mkString: String

Отображает все элементы этого перебираемого объекта или итератора в строке.

returns: строковое представление этого перебираемого объекта или итератора. В результирующей строке строковые представления (в соответствии с методом toString) всех элементов этого перебираемого объекта или итератора следуют друг за другом без разделительной строки.

Definition Classes: TraversableOnce → GenTraversableOnce

def mkString(sep: String): String

Отображает все элементы этого перебираемого объекта или итератора в строке с разделительной строкой.

sep: разделительная строка.
returns: строковое представление этого перебираемого объекта или итератора. В результирующей строке строковые представления (в соответствии с методом toString) всех элементов этого перебираемого объекта или итератора разделены строкой sep.

Definition Classes: TraversableOnce → GenTraversableOnce

def mkString(start: String, sep: String, end: String): String

Отображает все элементы этого перебираемого объекта или итератора в строке, используя начальную, конечную и разделительные строки.

start: начальная строка.
sep: разделительная строка.
end: конечная строка.
returns: строковое представление этого перебираемого объекта или итератора. Результирующая строка начинается со строки start и заканчивается строкой end. Внутри строковые представления (в соответствии с методом toString) всех элементов этого перебираемого объекта или итератора разделены строкой sep.

Definition Classes: TraversableOnce → GenTraversableOnce

final def ne(arg0: AnyRef): Boolean

Эквивалентно !(this eq that).

returns: true если аргумент не является ссылкой на объект-приемник; false в противном случае.

Definition Classes: AnyRef

def nonEmpty: Boolean

Проверяет, не пуст ли перебираемый объект или итератор.

returns: true если перебираемый объект или итератор содержит хотя бы один элемент; false в противном случае.

Definition Classes: TraversableOnce → GenTraversableOnce

final def notify(): Unit

Разбуждает единственную нить, ждущую монитора объекта-приемника.

Definition Classes: AnyRef
Annotations: @native()
Примечание: не указано SLS в качестве члена AnyRef

final def notifyAll(): Unit

Разбуждает все нити, ждущие монитора объекта-приемника.

Definition Classes: AnyRef
Annotations: @native()
Примечание: не указано SLS в качестве члена AnyRef

def padTo(len: Int, elem: A): Iterator[A]

[use case]

Добавляет значение элемента в этот итератор, пока не будет достигнута заданная целевая длина.

len: целевая длина
elem: значение дополнения
returns: новый итератор, содержащий все значения этого итератора, за которым следует минимальное количество вхождений elem, так что количество сгенерированных значений составляет как минимум len.

Definition Classes: Iterator

def partition(p: (A) ⇒ Boolean): (Iterator[A], Iterator[A])

Разделяет этот итератор на два итератора в соответствии с предикатом.

p: предикат для разделения
returns: пара итераторов: итератор, удовлетворяющий предикату p, и итератор, который не удовлетворяет. Относительный порядок элементов в результирующих итераторах такой же, как и в исходном итераторе.

Definition Classes: Iterator
Примечание: Повторное использование: после вызова этого метода следует удалить итератор, на котором он был вызван, и использовать только возвращенные итераторы. Использование старого итератора неопределенно, может измениться, и может привести к изменениям в новых итераторах также.

def patch[B >: A](from: Int, patchElems: Iterator[B], replaced: Int): Iterator[B]

Возвращает этот итератор с изменёнными значениями. Замена по отрицательным индексам такая же, как замена, начинающаяся с 0. Замена по индексам, равным или большим длины исходного итератора, добавляет замену в конец. Если заменяемых значений больше, чем фактически существует, избыток игнорируется.

from: Начальный индекс замены
patchElems: Итератор значений замены
replaced: Количество значений в исходном итераторе, которые заменяются заменой.

Definition Classes: Iterator
Note: Переиспользование: После вызова этого метода следует удалить итератор, на котором он был вызван, а также переданный в качестве параметра, и использовать только возвращённый итератор. Использование старых итераторов неопределённо, может измениться и может привести к изменениям в новом итераторе тоже.

def product: A

[use case]

Перемножает элементы этого набора.

returns: произведение всех элементов в этом итерабельном объекте или итераторе чисел типа Int. Вместо Int, может быть использован любой другой тип T с неявной реализацией Numeric[T] в качестве типа элемента итерабельного объекта или итератора и как возвращаемый тип product. Примеры таких типов: Long, Float, Double, BigInt.

Definition Classes: TraversableOnce → GenTraversableOnce

def reduce[A1 >: A](op: (A1, A1) ⇒ A1): A1

Редуцирует элементы этого итерабельного объекта или итератора с использованием указанного ассоциативного бинарного оператора.

Порядок выполнения операций над элементами не определён и может быть не детерминированным.

A1: Параметр типа для бинарного оператора, надтипа A.
op: Бинарный оператор, который должен быть ассоциативным.
returns: Результат применения оператора reduce op между всеми элементами, если итерабельный объект или итератор не пустые.

Definition Classes: TraversableOnce → GenTraversableOnce
Исключения: UnsupportedOperationException если этот итерабельный объект или итератор пустой.

def reduceLeft[B >: A](op: (B, A) ⇒ B): B

Применяет бинарный оператор ко всем элементам этого итерабельного объекта или итератора слева направо.

Примечание: не будет завершаться для коллекций бесконечного размера.

Примечание: может возвращать разные результаты для разных запусков, если тип базовой коллекции не упорядочен или оператор не является ассоциативным и коммутативным.

B

тип результата бинарного оператора.

op

бинарный оператор.

returns

результат вставки op между последовательными элементами этого итерабельного объекта или итератора слева направо:

op( op( ... op(x_1, x_2) ..., x_{n-1}), x_n)

где x₁, ..., x_n являются элементами этого итерабельного объекта или итератора.

Definition Classes: TraversableOnce
Исключения: UnsupportedOperationException если этот итерабельный объект или итератор пустой.

def reduceLeftOption[B >: A](op: (B, A) ⇒ B): Option[B]

Необязательно применяет бинарный оператор ко всем элементам этого итерабельного объекта или итератора слева направо.

Примечание: не будет завершаться для коллекций бесконечного размера.

B: тип результата бинарного оператора.
op: бинарный оператор.
returns: значение опции, содержащее результат reduceLeft(op) если этот итерабельный объект или итератор не пустой, None в противном случае.

Definition Classes: TraversableOnce → GenTraversableOnce

def reduceOption[A1 >: A](op: (A1, A1) ⇒ A1): Option[A1]

Редуцирует элементы этого итерабельного объекта или итератора, если таковые имеются, с использованием указанного ассоциативного бинарного оператора.

Порядок выполнения операций над элементами не определён и может быть не детерминированным.

A1: Параметр типа для бинарного оператора, надтипа A.
op: Бинарный оператор, который должен быть ассоциативным.
returns: Значение опции, содержащее результат применения оператора reduce op между всеми элементами, если коллекция не пустая, и None в противном случае.

Definition Classes: TraversableOnce → GenTraversableOnce

def reduceRight[B >: A](op: (A, B) ⇒ B): B

Применяет бинарный оператор ко всем элементам этого итерируемого объекта или итератора, слева направо.

Примечание: не будет завершаться для бесконечных коллекций.

Примечание: может возвращать разные результаты для разных запусков, если тип базовой коллекции не упорядочен, или оператор не ассоциативен и не коммутативен.

B

тип результата бинарного оператора.

op

бинарный оператор.

returns

результат вставки op между последовательными элементами этого итерируемого объекта или итератора, слева направо:

op(x_1, op(x_2, ..., op(x_{n-1}, x_n)...))

где x₁, ..., x_n — элементы этого итерируемого объекта или итератора.

Definition Classes: TraversableOnce → GenTraversableOnce
Исключения: UnsupportedOperationException если этот итерируемый объект или итератор пуст.

def reduceRightOption[B >: A](op: (A, B) ⇒ B): Option[B]

Необязательно применяет бинарный оператор ко всем элементам этого итерируемого объекта или итератора, слева направо.

Примечание: не будет завершаться для бесконечных коллекций.

B: тип результата бинарного оператора.
op: бинарный оператор.
returns: значение Option, содержащее результат reduceRight(op) если этот итерируемый объект или итератор не пуст, None в противном случае.

Definition Classes: TraversableOnce → GenTraversableOnce

def reversed: List[A]

Attributes: protected[this]
Definition Classes: TraversableOnce

def sameElements(that: Iterator[_]): Boolean

Проверяет, генерирует ли другой итератор те же значения, что и этот.

Примечание: не завершится для бесконечных итераторов.

that: другой итератор
returns: true, если оба итератора генерируют те же элементы в том же порядке, false в противном случае.

Definition Classes: Iterator
Примечание: Переиспользование: После вызова этого метода нужно удалить итератор, на котором он был вызван, а также переданный в качестве параметра. Использование старых итераторов не определено и может быть изменено.

def scanLeft[B](z: B)(op: (B, A) ⇒ B): Iterator[B]

Создаёт коллекцию, содержащую кумулятивные результаты применения оператора слева направо, включая начальное значение.

Примечание: не будет завершаться для бесконечных итераторов.

Примечание: может возвращать разные результаты для разных запусков, если тип базовой коллекции не упорядочен.

B: тип элементов в результирующей коллекции
z: начальное значение
op: бинарный оператор, применяемый к промежуточному результату и элементу
returns: итератор с промежуточными результатами

Definition Classes: Iterator
Примечание: Переиспользование: После вызова этого метода нужно удалить итератор, на котором он был вызван, и использовать только возвращённый итератор. Использование старого итератора не определено, может быть изменено, и может привести к изменениям в новом итераторе тоже.

def scanRight[B](z: B)(op: (A, B) ⇒ B): Iterator[B]

Создаёт коллекцию, содержащую кумулятивные результаты применения оператора справа налево. Головной элемент коллекции — последний кумулятивный результат.

Примечание: не будет завершаться для бесконечных итераторов.

B: тип элементов в результирующей коллекции
z: начальное значение
op: бинарный оператор, применяемый к промежуточному результату и элементу
returns: итератор с промежуточными результатами

Definition Classes: Iterator
Примечание: Переиспользование: После вызова этого метода нужно удалить итератор, на котором он был вызван, и использовать только возвращённый итератор. Использование старого итератора не определено, может быть изменено, и может привести к изменениям в новом итераторе тоже.

def seq: Iterator[A]

Версия этой коллекции, все операции в которой выполняются последовательно (т.е., в однопоточном режиме).

Этот метод возвращает ссылку на эту коллекцию. В параллельных коллекциях он переопределён для возврата последовательной реализации этой коллекции. В обоих случаях сложность составляет O(1).

returns: последовательный вид коллекции.

Definition Classes: Iterator → TraversableOnce → GenTraversableOnce

def size: Int

Размер этого итерируемого объекта или итератора.

Примечание: не будет завершаться для коллекций бесконечного размера.

возвращает: количество элементов в этом итерируемом объекте или итераторе.

Определяющие классы: TraversableOnce → GenTraversableOnce

def sizeHintIfCheap: Int

Размер этой коллекции или итератора, если его можно вычислить недорого

возвращает: количество элементов в этой коллекции или итераторе, или -1, если размер нельзя определить недорого

Атрибуты: protected[collection]
Определяющие классы: GenTraversableOnce

def slice(from: Int, until: Int): Iterator[A]

Создает итератор, возвращающий интервал значений, производимых этим итератором.

from: индекс первого элемента в этом итераторе, который является частью среза. Если отрицательный, срез начинается с нуля.
until: индекс первого элемента, следующего за срезом. Если отрицательный, срез пустой.
возвращает: итератор, который продвигает этот итератор мимо первых from элементов с использованием drop, и затем берет until - from элементов, используя take.

Определяющие классы: Iterator
Примечание: Переиспользование: после вызова этого метода нужно удалить вызываемый итератор и использовать только возвращённый итератор. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новом итераторе тоже.

def sliceIterator(from: Int, until: Int): Iterator[A]

Создает необязательно ограниченный срез, неограниченный, если until отрицательный.

Атрибуты: protected
Определяющие классы: Iterator

def sliding[B >: A](size: Int, step: Int = 1): GroupedIterator[B]

Возвращает итератор, который представляет «скользящее окно» представление этого итератора. Первый аргумент — размер окна, а второй аргумент step — это на сколько сдвигать окно на каждой итерации. step по умолчанию 1.

По умолчанию GroupedIterator может быть настроен для дополнения частичного результата до размера size или подавления частичного результата полностью.

Примеры использования:

// Returns List(List(1, 2, 3), List(2, 3, 4), List(3, 4, 5))
(1 to 5).iterator.sliding(3).toList
// Returns List(List(1, 2, 3, 4), List(4, 5))
(1 to 5).iterator.sliding(4, 3).toList
// Returns List(List(1, 2, 3, 4))
(1 to 5).iterator.sliding(4, 3).withPartial(false).toList
// Returns List(List(1, 2, 3, 4), List(4, 5, 20, 25))
// Illustrating that withPadding's argument is by-name.
val it2 = Iterator.iterate(20)(_ + 5)
(1 to 5).iterator.sliding(4, 3).withPadding(it2.next).toList

возвращает: Итератор, генерирующий Seq[B] размером size, за исключением последнего элемента (который может быть единственным элементом), который будет усечён, если оставшихся элементов для группировки меньше, чем size . Это поведение можно настроить.

Определяющие классы: Iterator
Примечание: Переиспользование: после вызова этого метода нужно удалить вызываемый итератор и использовать только возвращённый итератор. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новом итераторе тоже.

def span(p: (A) ⇒ Boolean): (Iterator[A], Iterator[A])

Разделяет этот итератор на пару префикс/суффикс в соответствии с предикатом.

p: предикат проверки
возвращает: пару итераторов, состоящую из самого длинного префикса этого, элементы которого удовлетворяют p, и остальной части итератора.

Определяющие классы: Iterator
Примечание: Переиспользование: после вызова этого метода нужно удалить вызываемый итератор и использовать только возвращённые итераторы. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новых итераторах тоже.

def sum: A

[use case]

Суммирует элементы этой коллекции.

возвращает: сумма всех элементов в этом итерируемом объекте или итераторе чисел типа Int. Вместо Int, любой другой тип T с неявным Numeric[T] реализацией может быть использован как тип элемента итерируемого объекта или итератора и как тип результата sum. Примеры таких типов: Long, Float, Double, BigInt.

Определяющие классы: TraversableOnce → GenTraversableOnce

final def synchronized[T0](arg0: ⇒ T0): T0

Определяющие классы: AnyRef

def take(n: Int): Iterator[A]

Выбирает первые n значений этого итератора.

n: количество значений для взятия
возвращает: итератор, генерирующий только первые n значений этого итератора, или весь итератор, если он генерирует меньше, чем n значений.

Определяющие классы: Iterator
Примечание: Переиспользование: после вызова этого метода нужно удалить вызываемый итератор и использовать только возвращённый итератор. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новом итераторе тоже.

def takeWhile(p: (A) ⇒ Boolean): Iterator[A]

Берет самый длинный префикс значений, производимых этим итератором, которые удовлетворяют предикату.

p: Предикат, используемый для проверки элементов.
returns: Итератор, возвращающий значения, производимые этим итератором, пока этот итератор не произведёт значение, которое не удовлетворяет предикату p.

Definition Classes: Итератор
Note: Повторное использование: после вызова этого метода следует удалить итератор, на котором он был вызван, и использовать только возвращённый итератор. Использование старого итератора не определено, может измениться и может привести к изменениям в новом итераторе также.

def to[Col[_]]: Col[A]

[use case]

Преобразует эту итерационную последовательность или итератор в другой, копируя все элементы.

Примечание: не завершит работу для бесконечных итераторов.

Col: Тип коллекции для построения.
returns: новая коллекция, содержащая все элементы этой итерационной последовательности или итератора.

Definition Classes: TraversableOnce → GenTraversableOnce

def toArray: Массив[A]

[use case]

Преобразует эту итерационную последовательность или итератор в массив.

Примечание: не завершит работу для бесконечных итераторов.

returns: массив, содержащий все элементы этой итерационной последовательности или итератора. Должен быть доступен ClassTag, для типа элементов этой итерационной последовательности или итератора.

Definition Classes: TraversableOnce → GenTraversableOnce

def toBuffer[B >: A]: Буфер[B]

Использует содержимое этой итерационной последовательности или итератора для создания нового изменяемого буфера.

Примечание: не завершит работу для бесконечных коллекций.

returns: буфер, содержащий все элементы этой итерационной последовательности или итератора.

Definition Classes: TraversableOnce → GenTraversableOnce

def toIndexedSeq: immutable.IndexedSeq[A]

Преобразует эту итерационную последовательность или итератор в индексированную последовательность.

Примечание: не завершит работу для бесконечных коллекций.

returns: индексированная последовательность, содержащая все элементы этой итерационной последовательности или итератора.

Definition Classes: TraversableOnce → GenTraversableOnce

def toIterable: Итерабельный[A]

Преобразует эту итерационную последовательность или итератор в итерабельную коллекцию. Обратите внимание, что выбор целевого Iterable является ленивым в этой реализации по умолчанию, так как эта TraversableOnce может быть ленивой и неоценённой (т.е. это может быть итератор, который итерабелен только один раз).

Примечание: не завершит работу для бесконечных коллекций.

returns: итерабельный элемент, содержащий все элементы этой итерационной последовательности или итератора.

Definition Classes: TraversableOnce → GenTraversableOnce

def toIterator: Итератор[A]

Возвращает итератор по элементам в этой итерационной последовательности или итераторе. Вернёт тот же итератор, если этот экземпляр уже является итератором.

Примечание: не завершит работу для бесконечных итераторов.

returns: итератор, содержащий все элементы этой итерационной последовательности или итератора.

Definition Classes: Итератор → GenTraversableOnce

def toList: Список[A]

Преобразует эту итерационную последовательность или итератор в список.

Примечание: не завершит работу для бесконечных коллекций.

returns: список, содержащий все элементы этой итерационной последовательности или итератора.

Definition Classes: TraversableOnce → GenTraversableOnce

def toMap[T, U]: Карта[T, U]

[use case]

Преобразует эту итерационную последовательность или итератор в карту. Этот метод недоступен, если элементы не являются членами Tuple2, каждая ((T, U)) становится парой ключ-значение в карте. Повторяющиеся ключи будут перезаписаны более поздними ключами: если это неупорядоченная коллекция, то ключ в результирующей карте не определён.

Примечание: не завершит работу для бесконечных итераторов.

returns: карта типа immutable.Map[T, U], содержащая все пары ключ/значение типа (T, U) этой итерационной последовательности или итератора.

Definition Classes: TraversableOnce → GenTraversableOnce

def toSeq: Последовательность[A]

Преобразует эту итерационную последовательность или итератор в последовательность. Как и toIterable, она ленивая в этой реализации по умолчанию, так как эта TraversableOnce может быть ленивой и неоценённой.

Примечание: не завершит работу для бесконечных коллекций.

returns: последовательность, содержащая все элементы этой итерационной последовательности или итератора.

Definition Classes: TraversableOnce → GenTraversableOnce

def toSet[B >: A]: immutable.Множество[B]

Преобразует этот итерируемый объект или итератор в множество.

Примечание: не завершит работу для коллекций бесконечного размера.

возвращает: множество, содержащее все элементы этого итерируемого объекта или итератора.

Определяющие классы: TraversableOnce → GenTraversableOnce

def toStream: immutable.Stream[A]

Преобразует этот итерируемый объект или итератор в поток.

возвращает: поток, содержащий все элементы этого итерируемого объекта или итератора.

Определяющие классы: Iterator → GenTraversableOnce

def toString(): String

Преобразует этот итератор в строку.

возвращает: "<iterator>" пуст или нет итератор.

Определяющие классы: Iterator → AnyRef → Any
Примечание: Повторное использование: итератор остается действительным для дальнейшего использования, независимо от возвращаемого результата.

def toTraversable: Traversable[A]

Преобразует этот итерируемый объект или итератор в неспецифическое Traversable. Возвратит ту же коллекцию, если этот экземпляр уже Traversable.

Примечание: не завершит работу для бесконечных итераторов.

возвращает: Traversable, содержащий все элементы этого итерируемого объекта или итератора.

Определяющие классы: Iterator → TraversableOnce → GenTraversableOnce

def toVector: Vector[A]

Преобразует этот итерируемый объект или итератор в вектор.

Примечание: не завершит работу для коллекций бесконечного размера.

возвращает: вектор, содержащий все элементы этого итерируемого объекта или итератора.

Определяющие классы: TraversableOnce → GenTraversableOnce

final def wait(): Unit

Определяющие классы: AnyRef
Аннотации: @throws( ... )

final def wait(arg0: Long, arg1: Int): Unit

Определяющие классы: AnyRef
Аннотации: @throws( ... )

final def wait(arg0: Long): Unit

Определяющие классы: AnyRef
Аннотации: @throws( ... ) @native()

def withFilter(p: (A) ⇒ Boolean): Iterator[A]

Создает итератор по всем элементам этого итератора, которые удовлетворяют предикату p. Порядок элементов сохраняется.

Примечание: withFilter эквивалентно filter для итераторов. Она существует для того, чтобы выражения for с фильтрами работали над итераторами.

p: предикат, используемый для проверки значений.
возвращает: итератор, который генерирует те значения этого итератора, которые удовлетворяют предикату p.

Определяющие классы: Iterator
Примечание: Повторное использование: после вызова этого метода следует удалить вызываемый на нем итератор и использовать только возвращенный итератор. Использование старого итератора не определено, может измениться и может привести к изменениям в новом итераторе.

def zip[B](that: Iterator[B]): Iterator[(A, B)]

Создаёт итератор, сформированный из этого итератора и другого итератора путём объединения соответствующих значений в пары. Если один из двух итераторов длиннее другого, оставшиеся элементы игнорируются.

that: Итератор, предоставляющий вторую половину каждой пары результатов
возвращает: новый итератор, содержащий пары, состоящие из соответствующих элементов этого итератора и that. Количество элементов, возвращаемых новым итератором, равно минимуму из количества элементов, возвращаемых этим итератором и that.

Определяющие классы: Iterator
Примечание: Повторное использование: после вызова этого метода следует удалить итератор, на котором он был вызван, а также переданный в качестве параметра, и использовать только возвращенный итератор. Использование старых итераторов не определено, может измениться и может привести к изменениям в новом итераторе.

def zipAll[B](that: Iterator[B], thisElem: A, thatElem: B): Iterator[(A, B)]

[случай использования]

Создаёт итератор, образованный из этого итератора и другого итератора путём объединения соответствующих элементов парами. Если один из двух итераторов короче другого, используются элементы-заполнители для расширения более короткого итератора до длины более длинного.

that: итератор that может иметь разную длину по сравнению с текущим итератором.
thisElem: элемент thisElem используется для заполнения результирующего итератора, если текущий итератор короче that
thatElem: элемент thatElem используется для заполнения результирующего итератора, если that короче текущего итератора
returns: новый итератор, содержащий пары, состоящие из соответствующих значений этого итератора и that. Длина возвращаемого итератора — максимальная из длин этого итератора и that. Если текущий итератор короче that, значения thisElem используются для заполнения результата. Если that короче этого итератора, значения thatElem используются для заполнения результата.

Классы определений: Iterator

def zipWithIndex: Iterator[(A, Int)]

Создаёт итератор, сопоставляющий каждый элемент, производимый этим итератором, с его индексом, считая с 0.

returns: новый итератор, содержащий пары, состоящие из соответствующих элементов этого итератора и их индексов.

Классы определений: Iterator
Примечание: Переиспользование: после вызова этого метода нужно избавиться от итератора, на котором он был вызван, и использовать только возвращённый итератор. Использование старого итератора не определено, может измениться и может привести к изменениям в новом итераторе тоже.

def →[B](y: B): (AbstractIterator[A], B)

Неявный: Этот член добавлен неявным преобразованием из AbstractIterator[A] в ArrowAssoc[AbstractIterator[A]], выполненным методом ArrowAssoc в scala.Predef.
Классы определений: ArrowAssoc

Затенённые неявные члены-значения

def filter(p: (A) ⇒ Boolean): TraversableOnce[A]

Неявный

Этот член добавлен неявным преобразованием из AbstractIterator[A] в MonadOps[A], выполненным методом MonadOps в scala.collection.TraversableOnce.

Затенение

Этот неявный унаследованный член затенён одним или несколькими членами в этом классе.
Чтобы получить доступ к этому члену, можно использовать приведение типа:

(abstractIterator: MonadOps[A]).filter(p)

Классы определений

MonadOps

def flatMap[B](f: (A) ⇒ GenTraversableOnce[B]): TraversableOnce[B]

Неявный

Затенение

(abstractIterator: MonadOps[A]).flatMap(f)

Классы определений

MonadOps

def map[B](f: (A) ⇒ B): TraversableOnce[B]

Неявный

Затенение

(abstractIterator: MonadOps[A]).map(f)

Классы определений

MonadOps

def withFilter(p: (A) ⇒ Boolean): Iterator[A]

Неявный

Затенение

(abstractIterator: MonadOps[A]).withFilter(p)

Классы определений

MonadOps

© 2002-2019 EPFL, with contributions from Lightbend.
Licensed under the Apache License, Version 2.0.
https://www.scala-lang.org/api/2.12.9/scala/collection/AbstractIterator.html