Класс scala.collection.GroupedIterator

class GroupedIterator[B >: A](self: Iterator[B], size: Int, step: Int) extends AbstractIterator[Seq[B]]

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

Типичные применения достигаются с помощью методов grouped и sliding.

Наследуемые классы

Исходный код

class GroupedIterator[B >: A](self: Iterator[B], size: Int, step: Int) extends AbstractIterator[Seq[B]]

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

Типичные применения достигаются с помощью методов grouped и sliding.

Конкретные методы

Исходный код

def hasNext: Boolean

Исходный код@throws(scala.throws.$lessinit$greater$default$1[scala.NoSuchElementException])

def next(): Seq[B]

Исходный код

def withPadding(x: => B): GroupedIterator[B]

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

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

Исходный код

def withPartial(x: Boolean): GroupedIterator[B]

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

Указывает, может ли последний сегмент возвращаться с менее чем size элементами. Если нет, некоторые элементы исходного итератора могут не быть возвращены вообще.

Наследуемые методы

Исходный код@inline

final def ++[B >: Seq[B]](xs: => IterableOnce[B]): Iterator[B]

Исходный код@inline

final 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

Исходный код@inline

final 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

Исходный код

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)

Исходный код

def buffered: BufferedIterator[Seq[B]]

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

Исходный код

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

Source

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

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

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

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

Source

def concat[B >: Seq[B]](xs: => IterableOnce[B]): Iterator[B]

Source

def contains(elem: Any): Boolean

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

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

Source

def copyToArray[B >: Seq[B]](xs: Array[B], start: Int, len: Int): Int

Копирует элементы в массив, возвращая количество скопированных элементов.

Заполняет заданный массив xs начиная с индекса start не более чем len элементами этой коллекции.

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

Source@deprecatedOverriding("This should always forward to the 3-arg version of this method", since = "2.13.4")

def copyToArray[B >: Seq[B]](xs: Array[B], start: Int): Int

Копирует элементы в массив, возвращая количество скопированных элементов.

Заполняет заданный массив xs начиная с индекса start значениями этой коллекции.

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

Source@deprecatedOverriding("This should always forward to the 3-arg version of this method", since = "2.13.4")

def copyToArray[B >: Seq[B]](xs: Array[B]): Int

Копирует элементы в массив, возвращая количество скопированных элементов.

Заполняет заданный массив xs начиная с индекса start значениями этой коллекции.

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

Source

def corresponds[B](that: IterableOnce[B])(p: (Seq[B], B) => Boolean): Boolean

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

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

Source

def count(p: Seq[B] => Boolean): Int

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

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

Source

def distinct: Iterator[Seq[B]]

Создаёт новый итератор из этого итератора без каких-либо дублированных элементов.

Source

def distinctBy[B](f: Seq[B] => B): Iterator[Seq[B]]

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

Исходный код

def drop(n: Int): Iterator[Seq[B]]

Исходный код

def dropWhile(p: Seq[B] => Boolean): Iterator[Seq[B]]

Исходный код

def duplicate: (Iterator[Seq[B]], Iterator[Seq[B]])

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

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

Исходный код

def exists(p: Seq[B] => Boolean): Boolean

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

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

Исходный код

def filter(p: Seq[B] => Boolean): Iterator[Seq[B]]

Исходный код

def filterNot(p: Seq[B] => Boolean): Iterator[Seq[B]]

Исходный код

def find(p: Seq[B] => Boolean): Option[Seq[B]]

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

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

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

Исходный код

def flatMap[B](f: Seq[B] => IterableOnce[B]): Iterator[B]

Исходный код

def flatten[B](implicit ev: Seq[B] => IterableOnce[B]): Iterator[B]

Исходный код

def fold[A1 >: Seq[B]](z: A1)(op: (A1, A1) => A1): A1

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

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

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

Исходный код

def foldLeft[B](z: B)(op: (B, Seq[B]) => B): B

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

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

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

Исходный код

def foldRight[B](z: B)(op: (Seq[B], B) => B): B

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

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

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

Исходный код

def forall(p: Seq[B] => Boolean): Boolean

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

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

Исходный код

def foreach[U](f: Seq[B] => U): Unit

Применяет f к каждому элементу для побочных эффектов Примечание: параметр [U] необходим для помощи в выводе типов scalac.

Исходный код

def grouped[B >: Seq[B]](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

Исходный код

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

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

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

Исходный код

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

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

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

Исходный код

def indexWhere(p: Seq[B] => Boolean, from: Int): Int

Исходный код@deprecatedOverriding("isEmpty is defined as !hasNext; override hasNext instead", "2.13.0")

override def isEmpty: Boolean

Исходный код

def isTraversableAgain: Boolean

Проверяет, может ли этот набор быть многократно пройден. Всегда true для Iterable и false для Iterator, если не переопределено.

Исходный код@inline

final def iterator: Iterator[Seq[B]]

Исходный код

def knownSize: Int

Исходный код@inline

final def length: Int

Исходный код

def map[B](f: Seq[B] => B): Iterator[B]

Исходный код

def max[B >: Seq[B]](implicit ord: Ordering[B]): Seq[B]

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

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

Исходный код

def maxBy[B](f: Seq[B] => B)(implicit cmp: Ordering[B]): Seq[B]

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

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

Источник

def maxByOption[B](f: Seq[B] => B)(implicit cmp: Ordering[B]): Option[Seq[B]]

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

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

Источник

def maxOption[B >: Seq[B]](implicit ord: Ordering[B]): Option[Seq[B]]

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

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

Источник

def min[B >: Seq[B]](implicit ord: Ordering[B]): Seq[B]

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

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

Источник

def minBy[B](f: Seq[B] => B)(implicit cmp: Ordering[B]): Seq[B]

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

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

Источник

def minByOption[B](f: Seq[B] => B)(implicit cmp: Ordering[B]): Option[Seq[B]]

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

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

Источник

def minOption[B >: Seq[B]](implicit ord: Ordering[B]): Option[Seq[B]]

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

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

Источник@inline

final def mkString: String

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

Делегирует addString, который может быть переопределён.

Источник@inline

final def mkString(sep: String): String

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

Делегирует addString, который может быть переопределён.

Источник

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

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

Делегирует addString, который может быть переопределён.

Source

def nextOption(): Option[Seq[B]]

Оборачивает значение next() в опцию.

Source@deprecatedOverriding("nonEmpty is defined as !isEmpty; override isEmpty instead", "2.13.0")

def nonEmpty: Boolean

Проверяет, не является ли коллекция пустой.

Source

def padTo[B >: Seq[B]](len: Int, elem: B): Iterator[B]

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

Source

def partition(p: Seq[B] => Boolean): (Iterator[Seq[B]], Iterator[Seq[B]])

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

Source

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

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

Source

def product[B >: Seq[B]](implicit num: Numeric[B]): B

Умножает элементы этой коллекции.

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

Исходный код

def reduce[B >: Seq[B]](op: (B, B) => B): B

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

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

Исходный код

def reduceLeft[B >: Seq[B]](op: (B, Seq[B]) => B): B

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

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

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

Исходный код

def reduceLeftOption[B >: Seq[B]](op: (B, Seq[B]) => B): Option[B]

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

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

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

Исходный код

def reduceOption[B >: Seq[B]](op: (B, B) => B): Option[B]

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

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

Исходный код

def reduceRight[B >: Seq[B]](op: (Seq[B], B) => B): B

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

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

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

Исходный код

def reduceRightOption[B >: Seq[B]](op: (Seq[B], B) => B): Option[B]

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

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

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

Исходный код

protected def reversed: Iterable[Seq[B]]

Исходный код

def sameElements[B >: Seq[B]](that: IterableOnce[B]): Boolean

Проверяет, совпадают ли соответствующие элементы заданной коллекции с элементами этого итератора (с учетом ==).

Исходный код

def scanLeft[B](z: B)(op: (B, Seq[B]) => B): Iterator[B]

Исходный код

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

Исходный код

def sliding[B >: Seq[B]](size: Int, step: Int): GroupedIterator[B]

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

Возвращённый GroupedIterator может быть настроен на заполнение частичного результата до размера size или полное подавление частичного результата.

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

// Returns List(ArraySeq(1, 2, 3), ArraySeq(2, 3, 4), ArraySeq(3, 4, 5))
(1 to 5).iterator.sliding(3).toList
// Returns List(ArraySeq(1, 2, 3, 4), ArraySeq(4, 5))
(1 to 5).iterator.sliding(4, 3).toList
// Returns List(ArraySeq(1, 2, 3, 4))
(1 to 5).iterator.sliding(4, 3).withPartial(false).toList
// Returns List(ArraySeq(1, 2, 3, 4), ArraySeq(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

Исходный код

def span(p: Seq[B] => Boolean): (Iterator[Seq[B]], Iterator[Seq[B]])

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

Примечание: c span p эквивалентно (но, возможно, более эффективно, чем) (c takeWhile p, c dropWhile p), при условии, что вычисление предиката p не вызывает побочных эффектов.

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

Исходный код

def splitAt(n: Int): (Iterator[Seq[B]], Iterator[Seq[B]])

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

Примечание: c splitAt n эквивалентно (но, возможно, более эффективно, чем) (c take n, c drop n).

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

Исходный код

def stepper[S <: Stepper[_]](implicit shape: StepperShape[Seq[B], S]): S

Возвращает scala.collection.Stepper для элементов этой коллекции.

Stepper позволяет создавать Java-поток для работы с коллекцией, см. scala.jdk.StreamConverters. Для коллекций, содержащих примитивные значения, Stepper может использоваться как итератор, который не упаковывает элементы.

Неявный параметр scala.collection.StepperShape определяет тип возвращаемого Stepper в соответствии с типом элементов этой коллекции.

• Для коллекций Int, Short, Byte или Char, возвращается scala.collection.IntStepper

• Для коллекций Double или Float, возвращается scala.collection.DoubleStepper

• Для коллекций Long возвращается scala.collection.LongStepper

• Для любого другого типа элементов возвращается scala.collection.AnyStepper

Обратите внимание, что этот метод переопределён в подклассах, и тип возвращаемого значения уточняется до S with EfficientSplit, например scala.collection.IndexedSeqOps.stepper. Для степперов, помеченных как scala.collection.Stepper.EfficientSplit, преобразователи в scala.jdk.StreamConverters позволяют создавать параллельные потоки, тогда как обычные степперы могут быть преобразованы только в последовательные потоки.

Исходный код

def sum[B >: Seq[B]](implicit num: Numeric[B]): B

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

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

Исходный код

def take(n: Int): Iterator[Seq[B]]

Исходный код

def takeWhile(p: Seq[B] => Boolean): Iterator[Seq[B]]

Исходный код

override def tapEach[U](f: Seq[B] => U): Iterator[Seq[B]]

Исходный код

def to[C1](factory: Factory[Seq[B], C1]): C1

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

xs.to(List) xs.to(ArrayBuffer) xs.to(BitSet) // для xs: Iterable[Int]

Исходный код

def toArray[B >: Seq[B] : ClassTag]: Array[B]

Преобразует коллекцию в массив.

Примечание реализации: НЕ вызывайте Array.from из этого метода.

Исходный код@inline

final def toBuffer[B >: Seq[B]]: Buffer[B]

Исходный код

def toIndexedSeq: IndexedSeq[Seq[B]]

Исходный код

def toList: List[Seq[B]]

Исходный код

def toMap[K, V](implicit ev: Seq[B] <:< (K, V)): Map[K, V]

Исходный код

def toSeq: Seq[Seq[B]]

Исходный код

def toSet[B >: Seq[B]]: Set[B]

Исходный код

override def toString: String

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

Исходный код

def toVector: Vector[Seq[B]]

Исходный код

def withFilter(p: Seq[B] => Boolean): Iterator[Seq[B]]

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

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

Исходный код

def zip[B](that: IterableOnce[B]): Iterator[(Seq[B], B)]

Источник

def zipAll[A1 >: Seq[B], B](that: IterableOnce[B], thisElem: A1, thatElem: B): Iterator[(A1, B)]

Источник

def zipWithIndex: Iterator[(Seq[B], Int)]