Трейт scala.collection.BufferedIterator
трейт BufferedIterator[+A] extends Iterator[A]
Члены-типы
класс 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 head: A
абстрактный def next(): A
Возвращает следующий элемент этого итератора.
- возвращает
следующий элемент этого итератора, если
hasNextявляетсяtrue, в противном случае поведение неопределённо.
- Определяющие классы
- Iterator
- Примечание
Повторное использование: итератор остаётся действительным для дальнейшего использования независимо от возвращаемого результата.
Члены-значения конкретного типа
final def !=(arg0: Any): Boolean
Проверка двух объектов на неравенство.
- returns
trueесли !(this == that), в противном случае false.
- Definition Classes
- AnyRef → Any
final def ##(): Int
Эквивалентно x.hashCode за исключением упакованных числовых типов и null. Для чисел он возвращает значение хэш-функции, которое согласуется с равенством значений: если две экземпляра типа значения сравниваются как true, то ## будет генерировать одно и то же значение хэш-функции для каждого из них. Для null возвращает хэш-код, где null.hashCode выбрасывает NullPointerException.
- returns
значение хэш-функции, согласованное с ==
- Definition Classes
- AnyRef → Any
def +(other: String): String
- Неявный
- Этот член добавляется благодаря неявной конверсии из BufferedIterator[A] в any2stringadd[BufferedIterator[A]], выполненной методом any2stringadd в scala.Predef.
- Definition Classes
- any2stringadd
def ++(that: ⇒ Iterator[A]): Iterator[A]
Конкатенация этого итератора с другим.
- that
другой итератор
- returns
новый итератор, который сначала выдает значения, генерируемые этим итератором, а затем значения, генерируемые итератором
that.
- Definition Classes
- Iterator
def ->[B](y: B): (BufferedIterator[A], B)
- Неявный
- Этот член добавляется благодаря неявной конверсии из BufferedIterator[A] в ArrowAssoc[BufferedIterator[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
бинарный оператор.
- returns
-
результат вставки
opмежду последовательными элементами этого итерируемого объекта или последовательности слева направо с начальным значениемzслева:op(...op(op(z, x_1), x_2), ..., x_n)
где
x1, ..., xn- элементы этого итерируемого объекта или последовательности.
- Definition Classes
- TraversableOnce → GenTraversableOnce
def :\[B](z: B)(op: (A, B) ⇒ B): B
Применение бинарного оператора ко всем элементам этого итерируемого объекта или последовательности и начальному значению справа налево.
Примечание: :\ - это альтернативная запись для foldRight; xs :\ z эквивалентно xs foldRight z.
Примечание: не завершится для бесконечных коллекций.
Примечание: может возвращать разные результаты для разных запусков, если тип коллекции не упорядочен или оператор не ассоциативен и коммутативен.
Примеры:
Обратите внимание, что функция сворачивания, используемая для вычисления b, эквивалентна функции, используемой для вычисления c.
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
бинарный оператор
- returns
-
результат вставки
opмежду последовательными элементами этого итерируемого объекта или последовательности справа налево с начальным значениемzсправа:op(x_1, op(x_2, ... op(x_n, z)...))
где
x1, ..., xn- элементы этого итерируемого объекта или последовательности.
- Definition Classes
- TraversableOnce → GenTraversableOnce
final def ==(arg0: Any): Boolean
Выражение x == that эквивалентно if (x eq null) that eq null else x.equals(that).
- returns
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, в которую были добавлены элементы.
- Definition Classes
- 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, в которую были добавлены элементы.
- Definition Classes
- 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, в которую были добавлены элементы.
- Definition Classes
- 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 преобразует каждый входной символ в целое число и добавляет его к сумме (раздела). Затем combop просто суммирует промежуточные результаты разделов:
List('a', 'b', 'c').aggregate(0)({ (sum, ch) => sum + ch.toInt }, { (p1, p2) => p1 + p2 })
final def asInstanceOf[T0]: T0
Приводит получаемый объект к типу T0.
Обратите внимание, что успех приведения типов во время выполнения зависит от семантики стирания Scala. Поэтому выражение 1.asInstanceOf[String] выбросит ClassCastException во время выполнения, а выражение List(1).asInstanceOf[List[String]] нет. В последнем примере, потому что аргумент типа стирается во время компиляции, невозможно проверить, содержат ли элементы списка требуемый тип.
- returns
получаемый объект.
- Definition Classes
- Any
- Exceptions thrown
ClassCastException, если получаемый объект не является экземпляром стираемого типаT0.
def buffered: BufferedIterator.this.type
Создаёт буферизированный итератор из этого итератора.
- returns
буферизированный итератор, генерирующий те же значения, что и этот итератор.
- Definition Classes
- BufferedIterator → Iterator
- Note
Переиспользование: после вызова этого метода, следует отбросить вызываемый итератор и использовать только возвращённый итератор. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новом итераторе тоже.
- See also
def clone(): AnyRef
Создайте копию объекта-приемника.
По умолчанию реализация метода clone зависит от платформы.
- возвращает
копию объекта-приемника.
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
Seq("a", 1, 5L).collectFirst({ case x: Int => x*10 }) = Some(10)
def contains(elem: Any): Boolean
Проверяет, содержит ли этот итератор заданное значение как элемент.
Примечание: может не завершиться для бесконечных итераторов.
- elem
элемент для проверки.
- возвращает
true, если этот итератор производит какое-то значение, которое равно (как определяется==)elem,falseв противном случае.
- Определяющие классы
- Iterator
- Примечание
Повторное использование: После вызова этого метода следует удалить вызываемый на нём итератор. Его использование не определено и может измениться.
def copyToArray(xs: Array[A], start: Int, len: Int): Unit
Копирует выбранные значения, производимые этим итератором, в массив. Заполняет данный массив xs , начиная с индекса start , не более чем len значениями, производимыми этим итератором. Копирование прекратится, когда будет достигнут конец текущего итератора или конец массива, или len элементов были скопированы.
Примечание: не завершится для бесконечных итераторов.
- xs
массив для заполнения.
- start
начальный индекс.
- len
максимальное количество копируемых элементов.
- Определяющие классы
- Iterator → TraversableOnce → GenTraversableOnce
def copyToArray(xs: Array[A]): Unit
Копирует элементы этого траверсабла или итератора в массив. Заполняет данный массив xs значениями этого траверсабла или итератора. Копирование прекратится, когда будет достигнут конец текущего траверсабла или итератора, или конец целевого массива.
Примечание: не завершится для бесконечных итераторов.
- xs
массив для заполнения.
- Определяющие классы
- TraversableOnce → GenTraversableOnce
def copyToArray(xs: Array[A], start: Int): Unit
Копирует элементы этого траверсабла или итератора в массив. Заполняет данный массив 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: (BufferedIterator[A]) ⇒ Boolean, msg: ⇒ Any): BufferedIterator[A]
- Implicit
- Этот член добавлен неявным преобразованием из BufferedIterator[A] в Ensuring[BufferedIterator[A]] выполняемым методом Ensuring в scala.Predef.
- Definition Classes
- Ensuring
def ensuring(cond: (BufferedIterator[A]) ⇒ Boolean): BufferedIterator[A]
- Implicit
- Этот член добавлен неявным преобразованием из BufferedIterator[A] в Ensuring[BufferedIterator[A]] выполняемым методом Ensuring в scala.Predef.
- Definition Classes
- Ensuring
def ensuring(cond: Boolean, msg: ⇒ Any): BufferedIterator[A]
- Неявный
- Этот член добавлен неявным преобразованием из BufferedIterator[A] в Ensuring[BufferedIterator[A]] с помощью метода Ensuring в scala.Predef.
- Классы-определения
- Ensuring
def ensuring(cond: Boolean): BufferedIterator[A]
- Неявный
- Этот член добавлен неявным преобразованием из BufferedIterator[A] в Ensuring[BufferedIterator[A]] с помощью метода Ensuring в scala.Predef.
- Классы-определения
- Ensuring
final def eq(arg0: AnyRef): Boolean
Проверяет, является ли аргумент (that) ссылкой на объект-получатель (this).
Метод eq реализует отношение эквивалентности на не-null экземплярах AnyRef, и имеет три дополнительных свойства:
-
Он согласован: для любых не-null экземпляров
x и y типа AnyRef, несколько вызовов x.eq(y) последовательно возвращают true или последовательно возвращают false.Для любого не-null экземпляра 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
- Примечание
Переиспользование: После вызова этого метода итератор, на котором он был вызван, следует удалить. Использование его не определено и может быть изменено.
def flatMap[B](f: (A) ⇒ GenTraversableOnce[B]): Iterator[B]
Создаёт новый итератор, применяя функцию ко всем значениям, производимым этим итератором, и конкатенируя результаты.
- f
функция для применения к каждому элементу.
- returns
итератор, полученный путём применения заданной функции, возвращающей итератор
fк каждому значению, производимому этим итератором, и конкатенации результатов.
- Definition Classes
- Iterator
- Примечание
Переиспользование: После вызова этого метода итератор, на котором он был вызван, следует удалить и использовать только возвращённый итератор. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новом итераторе.
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)
где
x1, ..., xn— элементы этого итерируемого объекта или итератора. Возвращает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)...))
где
x1, ..., xn— элементы этого итерируемого объекта или итератора. Возвращаетzесли этот итерируемый объект или итератор пуст.
- Definition Classes
- TraversableOnce → GenTraversableOnce
def forall(p: (A) ⇒ Boolean): Boolean
Проверяет, выполняется ли предикат для всех значений, производимых этим итератором.
Примечание: может не завершиться для бесконечных итераторов.
- p
предикат для проверки элементов.
- returns
trueесли заданный предикатpвыполняется для всех значений, производимых этим итератором, в противном случаеfalse.
- Definition Classes
- Iterator → TraversableOnce → GenTraversableOnce
- Примечание
Переиспользование: После вызова этого метода итератор, на котором он был вызван, следует удалить. Использование его не определено и может быть изменено.
def foreach(f: (A) ⇒ Unit): Unit
Применяет функцию f ко всем значениям, произведённым этим итератором.
- f
функция, которая применяется для побочного эффекта к каждому элементу. Результат функции
fотбрасывается.
- Определяющие классы
- Iterator → TraversableOnce → GenTraversableOnce
def formatted(fmtstr: String): String
Возвращает строку, отформатированную в соответствии с заданной format строкой. Строки форматирования аналогичны String.format (@см. java.lang.String.format).
- Неявный
- Этот член добавлен с помощью неявного преобразования из BufferedIterator[A] в StringFormat[BufferedIterator[A]] методом StringFormat в scala.Predef.
- Определяющие классы
- StringFormat
- Аннотации
- @inline()
final def getClass(): Class[_]
Возвращает представление класса времени выполнения объекта.
- возвращает
объект класса, соответствующий типу времени выполнения получателя.
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.
- возвращает
значение хэш-кода для этого объекта.
def headOption: Option[A]
Возвращает опцию следующего элемента итератора, не продвигая его дальше.
- возвращает
следующий элемент этого итератора, если у него есть следующий элемент
Noneесли его нет
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
предикат для проверки значений
- возвращает
индекс первого произведённого значения, удовлетворяющего
p, или -1, если такого элемента не существует до достижения конца итератора.
- Определяющие классы
- Iterator
- Примечание
Повторное использование: после вызова этого метода следует удалить итератор, на котором он был вызван. Его использование не определено и может измениться.
def isEmpty: Boolean
Проверяет, пуст ли этот итератор.
- возвращает
trueесли hasNext ложно,falseв противном случае.
- Определяющие классы
- Iterator → TraversableOnce → GenTraversableOnce
- Примечание
Повторное использование: итератор остаётся действительным для дальнейшего использования независимо от возвращаемого результата.
final def isInstanceOf[T0]: Boolean
Проверяет, является ли динамический тип объекта-получателя T0.
Обратите внимание, что результат проверки выполняется с учётом семантики стирания Scala. Поэтому выражение 1.isInstanceOf[String] вернёт false, а выражение List(1).isInstanceOf[List[String]] вернёт true. В последнем примере, из-за стирания типа аргумента в процессе компиляции, нельзя проверить, относятся ли содержимое списка к указанному типу.
- возвращает
trueесли объект-получатель является экземпляром стирания типаT0;falseв противном случае.
- Определяющие классы
- Any
def isTraversableAgain: Boolean
Проверяет, можно ли многократно пройти по этому итератору.
- возвращает
false
- Определяющие классы
- Iterator → GenTraversableOnce
- Примечание
Повторное использование: итератор остаётся действительным для дальнейшего использования независимо от возвращаемого результата.
def length: Int
Возвращает количество элементов в этом итераторе.
Примечание: не завершится для бесконечных итераторов.
- Определяющие классы
- Iterator
- Примечание
Повторное использование: после вызова этого метода следует удалить итератор, на котором он был вызван. Его использование не определено и может измениться.
def map[B](f: (A) ⇒ B): Iterator[B]
Создаёт новый итератор, отображающий все произведённые значения этого итератора в новые значения с помощью функции преобразования.
- f
функция преобразования
- возвращает
новый итератор, который преобразует каждое значение, производимое этим итератором, применив к нему функцию
f.
- Определяющие классы
- Iterator
- Примечание
Повторное использование: после вызова этого метода следует удалить итератор, на котором он был вызван, и использовать только возвращённый итератор. Использование старого итератора не определено, может измениться и может привести к изменениям в новом итераторе тоже.
def max: A
Находит наибольший элемент.
- возвращает
наибольший элемент этого перечислимого или итератора.
- Определяющие классы
- TraversableOnce → GenTraversableOnce
- Исключения
UnsupportedOperationExceptionесли этот перечислимый или итератор пуст.
def maxBy[B](f: (A) ⇒ B): A
Находит первый элемент, который даёт наибольшее значение, измеренное функцией f.
- B
Тип результата функции f.
- f
Функция измерения.
- возвращает
первый элемент этого перечислимого или итератора с наибольшим значением, измеренным функцией f.
- Определяющие классы
- TraversableOnce → GenTraversableOnce
- Исключения
UnsupportedOperationExceptionесли этот перечислимый или итератор пуст.
def min: A
Находит наименьший элемент.
- возвращает
наименьший элемент этого перечислимого или итератора
- Определяющие классы
- TraversableOnce → GenTraversableOnce
- Исключения
UnsupportedOperationExceptionесли этот перечислимый или итератор пуст.
def minBy[B](f: (A) ⇒ B): A
Находит первый элемент, который возвращает наименьшее значение, измеренное функцией 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
List(1, 2, 3).mkString("|") = "1|2|3"
def mkString(start: String, sep: String, end: String): String
Отображает все элементы этого обходчика или итератора в строке с использованием начальной, конечной и разделительных строк.
- start
начальная строка.
- sep
разделительная строка.
- end
конечная строка.
- returns
строковое представление этого обходчика или итератора. Результирующая строка начинается со строки
startи заканчивается строкойend. Внутри строковые представления (относительно методаtoString) всех элементов этого обходчика или итератора разделены строкойsep.
- Definition Classes
- TraversableOnce → GenTraversableOnce
List(1, 2, 3).mkString("(", "; ", ")") = "(1; 2; 3)"
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]
Добавляет значение элемента к этому итератору до тех пор, пока не будет достигнута заданная целевая длина.
- len
целевая длина
- elem
значение заполнения
- returns
новый итератор, состоящий из производства всех значений этого итератора, за которым следует минимальное количество вхождений
elem, так что количество производимых значений составляет как минимумlen.
- Definition Classes
- Iterator
def partition(p: (A) ⇒ Boolean): (Iterator[A], Iterator[A])
Разделяет этот итератор на два итератора в соответствии с предикатом.
- p
предикат, по которому следует разделить
- returns
пара итераторов: итератор, удовлетворяющий предикату
pи итератор, который этого не делает. Относительный порядок элементов в результирующих итераторах такой же, как и в исходном итераторе.
- Definition Classes
- Iterator
- Note
Использование: После вызова этого метода нужно удалить исходный итератор и использовать только возвращенные итераторы. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новых итераторах.
def patch[B >: A](from: Int, patchElems: Iterator[B], replaced: Int): Iterator[B]
Возвращает этот итератор с измененными значениями. Замена по отрицательным индексам эквивалентна замене, начинающейся с 0. Замена по индексам, равным или большим длины исходного итератора, добавляет замену в конец. Если количество заменяемых значений больше, чем фактически существует, избыток игнорируется.
- from
Начальный индекс для замены
- patchElems
Итератор значений замены
- replaced
Количество значений в исходном итераторе, заменяемых заменой.
- Definition Classes
- Iterator
- Note
Использование: После вызова этого метода нужно удалить исходный итератор, а также переданный в качестве параметра, и использовать только возвращенный итератор. Использование старых итераторов не определено, может быть изменено и может привести к изменениям в новом итераторе.
def product: A
Перемножает элементы этого набора.
- 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)где
x1, ..., xn- элементы этого итерируемого или итератора.
- Definition Classes
- TraversableOnce
- Исключения
UnsupportedOperationException, если этот итерируемый или итератор пустой.
def reduceLeftOption[B >: A](op: (B, A) ⇒ B): Option[B]
Необязательно применяет бинарный оператор ко всем элементам этого итерируемого или итератора, слева направо.
Примечание: не будет завершаться для бесконечно больших коллекций.
Примечание: может возвращать разные результаты для разных запусков, если тип базовой коллекции не упорядочен или оператор не ассоциативен и коммутативен.
- B
тип результата бинарного оператора.
- op
бинарный оператор.
- returns
значения Option, содержащее результат
reduceLeft(op), если этот итерируемый или итератор не пустой,Noneв противном случае.
- Definition Classes
- TraversableOnce → GenTraversableOnce
def reduceOption[A1 >: A](op: (A1, A1) ⇒ A1): Option[A1]
Уменьшает элементы этого перебираемого объекта или итератора, если таковые имеются, с использованием указанного ассоциативного бинарного оператора.
Порядок выполнения операций над элементами не определён и может быть недетерминированным.
- A1
Тип параметр для бинарного оператора, надтипом
A.- op
Бинарный оператор, который должен быть ассоциативным.
- returns
Значение типа Option, содержащее результат применения оператора 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)...))где
x1, ..., xn— элементы этого перебираемого объекта или итератора.
- Definition Classes
- TraversableOnce → GenTraversableOnce
- Exceptions thrown
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
- Note
Переиспользование: после вызова этого метода нужно удалить итератор, на котором он был вызван, а также переданный в качестве параметра. Использование старых итераторов неопределено и может измениться.
def scanLeft[B](z: B)(op: (B, A) ⇒ B): Iterator[B]
Создаёт коллекцию, содержащую кумулятивные результаты применения оператора слева направо, включая начальное значение.
Примечание: не будет завершаться для бесконечных итераторов.
Примечание: может возвращать разные результаты для разных запусков, если тип базовой коллекции не упорядочен.
- B
тип элементов в результирующей коллекции
- z
начальное значение
- op
бинарный оператор, применяемый к промежуточному результату и элементу
- returns
итератор с промежуточными результатами
- Definition Classes
- Iterator
- Note
Переиспользование: после вызова этого метода нужно удалить итератор, на котором он был вызван, и использовать только возвращённый итератор. Использование старого итератора не определено, может измениться, и может привести к изменениям в новом итераторе.
def scanRight[B](z: B)(op: (A, B) ⇒ B): Iterator[B]
Создаёт коллекцию, содержащую кумулятивные результаты применения оператора справа налево. Первый элемент коллекции — последний кумулятивный результат.
Примечание: не будет завершаться для бесконечных итераторов.
Примечание: может возвращать разные результаты для разных запусков, если тип базовой коллекции не упорядочен.
- B
тип элементов в результирующей коллекции
- z
начальное значение
- op
бинарный оператор, применяемый к промежуточному результату и элементу
- returns
итератор с промежуточными результатами
- Definition Classes
- Iterator
- Note
Переиспользование: после вызова этого метода нужно удалить итератор, на котором он был вызван, и использовать только возвращённый итератор. Использование старого итератора не определено, может измениться, и может привести к изменениям в новом итераторе.
Iterator(1, 2, 3, 4).scanRight(0)(_ + _).toList == List(10, 9, 7, 4, 0)
def seq: Iterator[A]
Версия этого набора со всеми операциями, реализованными последовательно (т.е., в однопоточном режиме).
Этот метод возвращает ссылку на этот набор. В параллельных наборах он переопределен для возврата последовательной реализации этого набора. В обоих случаях его сложность составляет O(1).
- возвращает
последовательный вид набора.
- Определяющие классы
- 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
Суммирует элементы этого набора.
- возвращает
сумма всех элементов в этом итерируемом объекте или итераторе чисел типа
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
Предикат, используемый для проверки элементов.
- возвращает
Итератор, возвращающий значения, производимые этим итератором, пока этот итератор не произведет значение, которое не удовлетворяет предикату
p.
- Классы-определения
- Iterator
- Примечание
Переиспользование: После вызова этого метода следует удалить итератор, на котором он был вызван, и использовать только возвращенный итератор. Использование старого итератора не определено, может измениться и может привести к изменениям в новом итераторе.
def to[Col[_]]: Col[A]
Преобразует этот итератор или перебираемую коллекцию в другой, копируя все элементы.
Примечание: не завершится для бесконечных итераторов.
- Col
Тип коллекции, которую нужно создать.
- возвращает
новая коллекция, содержащая все элементы этой перебираемой коллекции или итератора.
- Классы-определения
- TraversableOnce → GenTraversableOnce
def toArray: Array[A]
Преобразует эту перебираемую коллекцию или итератор в массив.
Примечание: не завершится для бесконечных итераторов.
- возвращает
массив, содержащий все элементы этой перебираемой коллекции или итератора. Для типа элемента этой перебираемой коллекции или итератора должен быть доступен
ClassTag.
- Классы-определения
- TraversableOnce → GenTraversableOnce
def toBuffer[B >: A]: Buffer[B]
Использует содержимое этой перебираемой коллекции или итератора для создания нового изменяемого буфера.
Примечание: не завершится для бесконечно больших коллекций.
- возвращает
буфер, содержащий все элементы этой перебираемой коллекции или итератора.
- Классы-определения
- TraversableOnce → GenTraversableOnce
def toIndexedSeq: immutable.IndexedSeq[A]
Преобразует эту перебираемую коллекцию или итератор в индексированную последовательность.
Примечание: не завершится для бесконечно больших коллекций.
- возвращает
индексированная последовательность, содержащая все элементы этой перебираемой коллекции или итератора.
- Классы-определения
- TraversableOnce → GenTraversableOnce
def toIterable: Iterable[A]
Преобразует эту перебираемую коллекцию или итератор в коллекцию iterable. Примечание: выбор целевого Iterable является ленивым в этой реализации по умолчанию, так как этот TraversableOnce может быть ленивым и не вычисленным (то есть он может быть итератором, который доступен только один раз).
Примечание: не завершится для бесконечно больших коллекций.
- возвращает
iterable, содержащая все элементы этой перебираемой коллекции или итератора.
- Классы-определения
- TraversableOnce → GenTraversableOnce
def toIterator: Iterator[A]
Возвращает итератор над элементами в этой перебираемой коллекции или итераторе. Вернет тот же итератор, если этот экземпляр уже является итератором.
Примечание: не завершится для бесконечных итераторов.
- возвращает
итератор, содержащий все элементы этой перебираемой коллекции или итератора.
- Классы-определения
- Iterator → GenTraversableOnce
def toList: List[A]
Преобразует эту перебираемую коллекцию или итератор в список.
Примечание: не завершится для бесконечно больших коллекций.
- возвращает
список, содержащий все элементы этой перебираемой коллекции или итератора.
- Классы-определения
- TraversableOnce → GenTraversableOnce
def toMap[T, U]: Map[T, U]
Преобразует эту перебираемую коллекцию или итератор в карту. Этот метод недоступен, если элементы не являются членами Tuple2, каждый ((T, U)) становится парой ключ-значение в карте. Повторяющиеся ключи будут перезаписаны последующими ключами: если это неупорядоченная коллекция, ключ в результирующей карте не определен.
Примечание: не завершится для бесконечных итераторов.
- возвращает
карта типа
immutable.Map[T, U]содержащая все пары ключ/значение типа(T, U)этой перебираемой коллекции или итератора.
- Классы-определения
- TraversableOnce → GenTraversableOnce
def toSeq: Seq[A]
Преобразует эту итерационную последовательность или итератор в последовательность. Как и в toIterable, в этом реализации по умолчанию это ленивая операция, так как эта TraversableOnce может быть ленивой и не вычисленный.
Примечание: не завершится для бесконечных коллекций.
- returns
последовательность, содержащая все элементы этой итерационной последовательности или итератора.
- Definition Classes
- TraversableOnce → GenTraversableOnce
def toSet[B >: A]: immutable.Set[B]
Преобразует эту итерационную последовательность или итератор в множество.
Примечание: не завершится для бесконечных коллекций.
- returns
множество, содержащее все элементы этой итерационной последовательности или итератора.
- Definition Classes
- TraversableOnce → GenTraversableOnce
def toStream: immutable.Stream[A]
Преобразует эту итерационную последовательность или итератор в поток.
- returns
поток, содержащий все элементы этой итерационной последовательности или итератора.
- Definition Classes
- Iterator → GenTraversableOnce
def toString(): String
Преобразует этот итератор в строку.
- returns
"<iterator>"пуст ли итератор или нет.
def toTraversable: Traversable[A]
Преобразует эту итерационную последовательность или итератор в неопределенную итерационную последовательность. Вернёт ту же коллекцию, если этот экземпляр уже является итерационной последовательностью.
Примечание: не завершится для бесконечных итераторов.
- returns
итерационная последовательность, содержащая все элементы этой итерационной последовательности или итератора.
- Definition Classes
- Iterator → TraversableOnce → GenTraversableOnce
def toVector: Vector[A]
Преобразует эту итерационную последовательность или итератор в вектор.
Примечание: не завершится для бесконечных коллекций.
- returns
вектор, содержащий все элементы этой итерационной последовательности или итератора.
- Definition Classes
- TraversableOnce → GenTraversableOnce
final def wait(): Unit
- Definition Classes
- AnyRef
- Annotations
- @throws( ... )
final def wait(arg0: Long, arg1: Int): Unit
- Definition Classes
- AnyRef
- Annotations
- @throws( ... )
final def wait(arg0: Long): Unit
def withFilter(p: (A) ⇒ Boolean): Iterator[A]
Создаёт итератор над всеми элементами этого итератора, которые удовлетворяют предикату p. Порядок элементов сохраняется.
Примечание: withFilter эквивалентно filter для итераторов. Оно существует для того, чтобы выражения for с фильтрами работали над итераторами.
- p
предикат, используемый для проверки значений.
- returns
итератор, который генерирует те значения этого итератора, которые удовлетворяют предикату
p.
- Definition Classes
- Iterator
- Note
Использование: После вызова этого метода нужно удалить тот итератор, на котором он был вызван, и использовать только возвращённый итератор. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новом итераторе тоже.
def zip[B](that: Iterator[B]): Iterator[(A, B)]
Создаёт итератор, образованный из этого итератора и другого итератора путём объединения соответствующих значений в пары. Если один из двух итераторов длиннее другого, его оставшиеся элементы игнорируются.
- that
Итератор, предоставляющий вторую половину каждой пары результата
- returns
новый итератор, содержащий пары, состоящие из соответствующих элементов этого итератора и
that. Количество элементов, возвращаемых новым итератором, является минимальным из количества элементов, возвращаемых этим итератором иthat.
- Definition Classes
- Iterator
- Note
Переиспользование: После вызова этого метода необходимо удалить итератор, на котором он был вызван, а также переданный в качестве параметра и использовать только итератор, который был возвращён. Использование старых итераторов неопределено, может быть изменено и может привести к изменениям в новом итераторе также.
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используются для дополнения результата.
- Definition Classes
- Iterator
def zipWithIndex: Iterator[(A, Int)]
Создаёт итератор, который связывает каждый элемент, производимый этим итератором, с его индексом, начиная с 0.
- returns
новый итератор, содержащий пары, состоящие из соответствующих элементов этого итератора и их индексов.
- Definition Classes
- Iterator
- Note
Переиспользование: После вызова этого метода необходимо удалить итератор, на котором он был вызван, и использовать только возвращённый итератор. Использование старого итератора неопределено, может быть изменено и может привести к изменениям в новом итераторе также.
def →[B](y: B): (BufferedIterator[A], B)
- Implicit
- Этот член добавлен неявным преобразованием из BufferedIterator[A] в ArrowAssoc[BufferedIterator[A]] с помощью метода ArrowAssoc в scala.Predef.
- Definition Classes
- ArrowAssoc
Затенённые неявные члены значения
def filter(p: (A) ⇒ Boolean): TraversableOnce[A]
- Неявный
- Этот член добавлен с помощью неявного преобразования из BufferedIterator[A] в MonadOps[A], выполненного методом MonadOps в scala.collection.TraversableOnce.
- Затенение
- Этот неявно унаследованный член затенён одним или несколькими членами в этом классе.
Для доступа к этому члену можно использовать приведение типа:(bufferedIterator: MonadOps[A]).filter(p)
- Определяющие классы
- MonadOps
def flatMap[B](f: (A) ⇒ GenTraversableOnce[B]): TraversableOnce[B]
- Неявный
- Этот член добавлен с помощью неявного преобразования из BufferedIterator[A] в MonadOps[A], выполненного методом MonadOps в scala.collection.TraversableOnce.
- Затенение
- Этот неявно унаследованный член затенён одним или несколькими членами в этом классе.
Для доступа к этому члену можно использовать приведение типа:(bufferedIterator: MonadOps[A]).flatMap(f)
- Определяющие классы
- MonadOps
def map[B](f: (A) ⇒ B): TraversableOnce[B]
- Неявный
- Этот член добавлен с помощью неявного преобразования из BufferedIterator[A] в MonadOps[A], выполненного методом MonadOps в scala.collection.TraversableOnce.
- Затенение
- Этот неявно унаследованный член затенён одним или несколькими членами в этом классе.
Для доступа к этому члену можно использовать приведение типа:(bufferedIterator: MonadOps[A]).map(f)
- Определяющие классы
- MonadOps
def withFilter(p: (A) ⇒ Boolean): Iterator[A]
- Неявный
- Этот член добавлен с помощью неявного преобразования из BufferedIterator[A] в MonadOps[A], выполненного методом MonadOps в scala.collection.TraversableOnce.
- Затенение
- Этот неявно унаследованный член затенён одним или несколькими членами в этом классе.
Для доступа к этому члену можно использовать приведение типа:(bufferedIterator: 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/BufferedIterator.html
Буферизованные итераторы — это итераторы, которые предоставляют метод
head, позволяющий просмотреть следующий элемент, не отбрасывая его.2.8