Класс scala.collection.Iterator.GroupedIterator
класс GroupedIterator[B >: A] extends AbstractIterator[Seq[B]] with Iterator[Seq[B]]
Члены типов
класс GroupedIterator[B >: A] extends AbstractIterator[Seq[B]] with Iterator[Seq[B]]
Гибкий итератор для преобразования Iterator[A] в Iterator[Seq[A]], с настраиваемым размером последовательности, шагом и стратегией обработки элементов, которые не укладываются равномерно.
Типичные применения можно достичь с помощью методов grouped и sliding.
- Определяющие классы
- 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
- Неявный
- Этот член добавлен неявным преобразованием из GroupedIterator[B] в any2stringadd[GroupedIterator[B]], выполненным методом any2stringadd в scala.Predef.
- Definition Classes
- any2stringadd
def ++(that: ⇒ Iterator[Seq[B]]): Iterator[Seq[B]]
Конкатенация данного итератора с другим.
- that
другой итератор
- возвращает
новый итератор, который сначала выдает значения, производимые данным итератором, за которыми следуют значения, производимые итератором
that.
- Definition Classes
- Iterator
def ->[B](y: B): (GroupedIterator[B], B)
- Неявный
- Этот член добавлен неявным преобразованием из GroupedIterator[B] в ArrowAssoc[GroupedIterator[B]], выполненным методом ArrowAssoc в scala.Predef.
- Definition Classes
- ArrowAssoc
- Аннотации
- @inline()
def /:[B](z: B)(op: (B, Seq[B]) ⇒ 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)
где
x1, ..., xnявляются элементами данного перечислимого или итератора.
- Definition Classes
- TraversableOnce → GenTraversableOnce
def :\[B](z: B)(op: (Seq[B], 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
бинарный оператор
- возвращает
-
результат вставки
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).
- возвращает
trueесли объект-получатель эквивалентен аргументу;falseв противном случае.
- Классы определения
- 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
строковый буфер, в который будут добавлены элементы.
- возвращает
строковый буфер
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
разделительная строка.
- возвращает
строковый буфер
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
конечная строка.
- возвращает
строковый буфер
b, в который были добавлены элементы.
- Классы определения
- TraversableOnce
def aggregate[B](z: ⇒ B)(seqop: (B, Seq[B]) ⇒ 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 })
- 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]] — нет. В последнем примере, поскольку аргумент типа стирается на этапе компиляции, невозможно проверить, соответствуют ли содержимое списка требуемому типу.
- возвращает
объект-получатель.
- Классы определения
- Any
- Исключения
ClassCastException, если объект-получатель не является экземпляром стирания типаT0.
def buffered: BufferedIterator[Seq[B]]
Создаёт буферизованный итератор из этого итератора.
- возвращает
буферизованный итератор, генерирующий те же значения, что и этот итератор.
- Классы определения
- Iterator
- Примечание
Переиспользование: после вызова этого метода старый итератор должен быть отброшен, и использоваться только возвращённый. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новом итераторе тоже.
- См. также
def clone(): AnyRef
Создайте копию объекта-получателя.
По умолчанию реализация метода clone зависит от платформы.
- returns
копия объекта-получателя.
def collect[B](pf: PartialFunction[Seq[B], B]): Iterator[B]
Создает итератор, преобразуя значения, производимые этим итератором, с помощью частичной функции, отбрасывая те значения, для которых частичная функция не определена.
- pf
частичная функция, которая фильтрует и отображает итератор.
- returns
новый итератор, который возвращает каждое значение
x, производимое этим итератором, для которогоpfопределена, изображениеpf(x).
- Определяющие классы
- Iterator
- Аннотации
- @migration
- Миграция
(Изменено в версии 2.8.0)
collectизменилось. Предыдущее поведение можно воспроизвести с помощьюtoSeq.- Примечание
Повторное использование: после вызова этого метода следует удалить итератор, на котором он был вызван, и использовать только возвращенный итератор. Использование старого итератора не определено, может измениться и может привести к изменениям в новом итераторе.
def collectFirst[B](pf: PartialFunction[Seq[B], B]): Option[B]
Находит первый элемент из перечислимого или итератора, для которого заданная частичная функция определена, и применяет частичную функцию к нему.
Примечание: может не завершаться для бесконечных коллекций.
Примечание: может возвращать разные результаты для разных запусков, если тип базовой коллекции не упорядочен.
- pf
частичная функция
- returns
значение option, содержащее pf, примененное к первому значению, для которого оно определено, или
None, если такового нет.
- Определяющие классы
- TraversableOnce
Seq("a", 1, 5L).collectFirst({ case x: Int => x*10 }) = Some(10)
def contains(elem: Any): Boolean
Проверяет, содержит ли этот итератор данное значение в качестве элемента.
Примечание: может не завершаться для бесконечных итераторов.
- elem
тестируемый элемент.
- returns
true, если этот итератор производит некоторое значение, которое равно (как определяется==)elem,falseиначе.
- Определяющие классы
- Iterator
- Примечание
Повторное использование: после вызова этого метода следует удалить итератор, на котором он был вызван. Его использование не определено и может измениться.
def copyToArray(xs: Array[Seq[B]], 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 >: Seq[B]](dest: Buffer[B]): Unit
Копирует все элементы этого итерируемого объекта или итератора в буфер.
Примечание: не будет завершаться для коллекций бесконечного размера.
- dest
Буфер, в который копируются элементы.
- Definition Classes
- TraversableOnce
def corresponds[B](that: GenTraversableOnce[B])(p: (Seq[B], B) ⇒ Boolean): Boolean
Проверяет, соответствует ли каждый элемент этого итератора соответствующему элементу другой коллекции, удовлетворяя условию предиката.
- B
тип элементов
that- that
другая коллекция
- p
предикат проверки, который сопоставляет элементы обеих коллекций
- returns
trueесли обе коллекции имеют одинаковую длину иp(x, y)являетсяtrueдля всех соответствующих элементовxэтого итератора иythat, в противном случаеfalse
- Definition Classes
- Iterator
def count(p: (Seq[B]) ⇒ Boolean): Int
Считает количество элементов в итерируемом объекте или итераторе, которые удовлетворяют предикату.
- p
предикат для проверки элементов.
- returns
количество элементов, удовлетворяющих предикату
p.
- Definition Classes
- TraversableOnce → GenTraversableOnce
def drop(n: Int): Iterator[Seq[B]]
Пропускает первые n элементов этого итератора или длину итератора, что меньше.
- n
количество пропускаемых элементов
- returns
итератор, который генерирует все значения текущего итератора, за исключением первых
nзначений.
- Definition Classes
- Iterator
- Note
Переиспользование: После вызова этого метода следует удалить вызываемый итератор и использовать только возвращённый итератор. Использование старого итератора не определено, может измениться и может привести к изменениям в новом итераторе тоже.
def dropWhile(p: (Seq[B]) ⇒ Boolean): Iterator[Seq[B]]
Пропускает самую длинную последовательность элементов этого итератора, которые удовлетворяют заданному предикату p, и возвращает итератор оставшихся элементов.
- p
предикат для пропуска элементов.
- returns
итератор, состоящий из оставшихся элементов
- Definition Classes
- Iterator
- Note
Переиспользование: После вызова этого метода следует удалить вызываемый итератор и использовать только возвращённый итератор. Использование старого итератора не определено, может измениться и может привести к изменениям в новом итераторе тоже.
def duplicate: (Iterator[Seq[B]], Iterator[Seq[B]])
Создаёт два новых итератора, которые оба перебирают те же элементы, что и этот итератор (в том же порядке). Дублированные итераторы считаются равными, если они находятся на одном и том же элементе.
Поскольку большинство методов итераторов сделают исходный итератор непригодным для дальнейшего использования, этот метод предоставляет надёжный способ вызова нескольких таких методов для итератора.
- returns
пара итераторов
- Definition Classes
- Iterator
- Note
-
Реализация может выделять временное хранилище для элементов, просмотренных одним итератором, но ещё не просмотренных другим.
,Переиспользование: После вызова этого метода следует удалить вызываемый итератор и использовать только возвращённые итераторы. Использование старого итератора не определено, может измениться и может привести к изменениям в новых итераторах тоже.
def ensuring(cond: (GroupedIterator[B]) ⇒ Boolean, msg: ⇒ Any): GroupedIterator[B]
- Implicit
- Этот член добавлен неявным преобразованием из GroupedIterator[B] в Ensuring[GroupedIterator[B]] при помощи метода Ensuring в scala.Predef.
- Definition Classes
- Ensuring
def ensuring(cond: (GroupedIterator[B]) ⇒ Boolean): GroupedIterator[B]
- Implicit
- Этот член добавлен неявным преобразованием из GroupedIterator[B] в Ensuring[GroupedIterator[B]] при помощи метода Ensuring в scala.Predef.
- Definition Classes
- Ensuring
def ensuring(cond: Boolean, msg: ⇒ Any): GroupedIterator[B]
- Implicit
- Этот член добавлен неявным преобразованием из GroupedIterator[B] в Ensuring[GroupedIterator[B]] с помощью метода Ensuring в scala.Predef.
- Definition Classes
- Ensuring
def ensuring(cond: Boolean): GroupedIterator[B]
- Implicit
- Этот член добавлен неявным преобразованием из GroupedIterator[B] в Ensuring[GroupedIterator[B]] с помощью метода Ensuring в scala.Predef.
- Definition Classes
- Ensuring
final def eq(arg0: AnyRef): Boolean
Проверяет, является ли аргумент (that) ссылкой на объект-получатель (this).
Метод eq реализует отношение эквивалентности на непустых экземплярах 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).
- returns
trueесли аргумент является ссылкой на объект-получатель;falseв противном случае.
- Definition Classes
- AnyRef
def equals(arg0: Any): Boolean
Метод равенства для ссылочных типов. Реализация по умолчанию делегирует вызов методу eq.
См. также equals в scala.Any.
- returns
trueесли объект-получатель эквивалентен аргументу;falseв противном случае.
- Definition Classes
- AnyRef → Any
def exists(p: (Seq[B]) ⇒ Boolean): Boolean
Проверяет, выполняется ли предикат для некоторых значений, производимых этим итератором.
Примечание: может не завершиться для бесконечных итераторов.
- p
предикат, используемый для проверки элементов.
- returns
trueесли данный предикатpвыполняется для некоторых значений, производимых этим итератором; в противном случаеfalse.
- Definition Classes
- Iterator → TraversableOnce → GenTraversableOnce
- Note
Переиспользование: после вызова этого метода итератор, на котором он был вызван, следует удалить. Использование его является неопределённым и может измениться.
def filter(p: (Seq[B]) ⇒ Boolean): Iterator[Seq[B]]
Возвращает итератор по всем элементам этого итератора, удовлетворяющим предикату p. Порядок элементов сохраняется.
- p
предикат, используемый для проверки значений.
- returns
итератор, который производит те значения этого итератора, которые удовлетворяют предикату
p.
- Definition Classes
- Iterator
- Note
Переиспользование: после вызова этого метода старый итератор следует удалить, а использовать только возвращённый. Использование старого итератора неопределенно, может измениться, и может привести к изменениям в новом итераторе.
def filterNot(p: (Seq[B]) ⇒ Boolean): Iterator[Seq[B]]
Создаёт итератор по всем элементам этого итератора, которые не удовлетворяют предикату p.
- p
предикат, используемый для проверки значений.
- returns
итератор, который производит те значения этого итератора, которые не удовлетворяют предикату
p.
- Definition Classes
- Iterator
- Note
Переиспользование: после вызова этого метода старый итератор следует удалить, а использовать только возвращённый. Использование старого итератора неопределенно, может измениться, и может привести к изменениям в новом итераторе.
def finalize(): Unit
Вызывается сборщиком мусора для объекта-получателя, когда больше нет ссылок на объект.
Подробности о том, когда и если вызывается метод finalize, а также взаимодействие между finalize и нелокальными возвратами и исключениями, зависят от платформы.
- Атрибуты
- protected[lang]
- Определяющие классы
- AnyRef
- Аннотации
- @throws( classOf[java.lang.Throwable] )
- Примечание
не указано SLS в качестве члена AnyRef
def find(p: (Seq[B]) ⇒ Boolean): Option[Seq[B]]
Находит первое значение, генерируемое итератором, удовлетворяющее предикату, если таковое имеется.
Примечание: может не завершаться для бесконечных итераторов.
- p
предикат, используемый для проверки значений.
- возвращает
значений в виде опции, содержащей первое значение, генерируемое итератором, удовлетворяющее предикату
p, илиNone, если такого значения нет.
- Определяющие классы
- Iterator → TraversableOnce → GenTraversableOnce
- Примечание
Повторное использование: После вызова этого метода необходимо удалить итератор, на котором он был вызван. Использование его не определено и может быть изменено.
def flatMap[B](f: (Seq[B]) ⇒ GenTraversableOnce[B]): Iterator[B]
Создает новый итератор, применяя функцию ко всем значениям, генерируемым этим итератором, и конкатенируя результаты.
- f
функция, применяемая к каждому элементу.
- возвращает
итератор, полученный в результате применения данной функции, принимающей итератор
fк каждому значению, генерируемому этим итератором, и конкатенации результатов.
- Определяющие классы
- Iterator
- Примечание
Повторное использование: После вызова этого метода следует удалить вызвавший итератор и использовать только возвращенный. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новом итераторе.
def flatten: Iterator[B]
- Неявный
- Этот член добавлен неявным преобразованием из GroupedIterator[B] в FlattenOps[B] через метод flattenTraversableOnce в scala.collection.TraversableOnce. Это преобразование произойдёт только в том случае, если в области видимости есть неявное значение типа (Seq[B]) ⇒ TraversableOnce[B].
- Определяющие классы
- FlattenOps
def fold[A1 >: Seq[B]](z: A1)(op: (A1, A1) ⇒ A1): A1
Складывает элементы этого итератора или traversable с использованием указанного ассоциативного бинарного оператора.
Порядок выполнения операций над элементами не определен и может быть не детерминированным.
Примечание: не завершится для бесконечных коллекций.
- A1
параметр типа для бинарного оператора, являющийся супертипом
A.- z
нейтральный элемент для операции складывания; может добавляться к результату произвольное количество раз и не должен изменять результат (например,
Nilдля конкатенации списков, 0 для сложения или 1 для умножения).- op
бинарный оператор, который должен быть ассоциативным.
- возвращает
результат применения оператора сложения
opмежду всеми элементами иz, илиz, если этот итератор или traversable пустой.
- Определяющие классы
- TraversableOnce → GenTraversableOnce
def foldLeft[B](z: B)(op: (B, Seq[B]) ⇒ B): B
Применяет бинарный оператор к начальному значению и всем элементам этого итератора или traversable слева направо.
Примечание: не завершится для бесконечных коллекций.
Примечание: может возвращать разные результаты для разных запусков, если тип базовой коллекции не упорядочен или оператор не ассоциативен и коммутативен.
- B
тип результата бинарного оператора.
- z
начальное значение.
- op
бинарный оператор.
- возвращает
-
результат вставки
opмежду последовательными элементами этого итератора или traversable слева направо с начальным значениемzслева:op(...op(z, x_1), x_2, ..., x_n)
где
x1, ..., xn— элементы этого итератора или traversable. Возвращаетzесли этот итератор или traversable пустой.
- Определяющие классы
- TraversableOnce → GenTraversableOnce
def foldRight[B](z: B)(op: (Seq[B], 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: (Seq[B]) ⇒ Boolean): Boolean
Проверяет, выполняется ли предикат для всех значений, производимых этим итератором.
Примечание: может не завершаться для бесконечных итераторов.
- p
предикат, используемый для проверки элементов.
- returns
true, если заданный предикатpвыполняется для всех значений, производимых этим итератором, в противном случаеfalse.
- Definition Classes
- Iterator → TraversableOnce → GenTraversableOnce
- Note
Переиспользование: После вызова этого метода нужно удалить итератор, на котором он был вызван. Использование его неопределено и может быть изменено.
def foreach(f: (Seq[B]) ⇒ Unit): Unit
Применяет функцию f ко всем значениям, производимым этим итератором.
- f
функция, которая применяется для побочного эффекта к каждому элементу. Результат функции
fотбрасывается.
- Definition Classes
- Iterator → TraversableOnce → GenTraversableOnce
def formatted(fmtstr: String): String
Возвращает строку, отформатированную в соответствии с заданной format строкой. Строки форматирования аналогичны String.format (@см. java.lang.String.format).
- Неявный
- Этот член добавляется неявным преобразованием из GroupedIterator[B] в StringFormat[GroupedIterator[B]] выполняемым методом StringFormat в scala.Predef.
- Definition Classes
- StringFormat
- Annotations
- @inline()
final def getClass(): Class[_]
Возвращает представление класса во время выполнения объекта.
- returns
объект класса, соответствующий типу времени выполнения получателя.
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
- Definition Classes
- Iterator
- Note
Переиспользование: После вызова этого метода необходимо удалить итератор, на котором он был вызван, и использовать только итератор, который был возвращен. Использование старого итератора неопределено, может быть изменено и может привести к изменениям в новом итераторе.
def hasDefiniteSize: Boolean
Проверяет, имеет ли этот итератор известный размер.
- returns
trueдля пустых итераторов,falseв противном случае.
- Definition Classes
- Iterator → TraversableOnce → GenTraversableOnce
- Note
Переиспользование: итератор остается действительным для дальнейшего использования, независимо от возвращаемого результата.
def hasNext: Boolean
Проверяет, может ли этот итератор предоставить другой элемент.
- returns
true, если последующий вызовnextвернет элемент,falseв противном случае.
- Definition Classes
- GroupedIterator → Iterator
- Note
Переиспользование: итератор остается действительным для дальнейшего использования, независимо от возвращаемого результата.
def hashCode(): Int
def indexOf[B >: Seq[B]](elem: B, from: Int): Int
Возвращает индекс первого вхождения указанного объекта в этом итерируемом объекте после или на некотором начальном индексе.
Примечание: может не завершаться для бесконечных итераторов.
- elem
элемент для поиска.
- from
начальный индекс
- returns
индекс
>= fromпервого вхожденияelemв значения, производимые этим итератором, или -1, если такой элемент не существует до достижения конца итератора.
- Definition Classes
- Iterator
- Note
Повторное использование: после вызова этого метода итератор следует удалить. Использование его не определено и может измениться.
def indexOf[B >: Seq[B]](elem: B): Int
Возвращает индекс первого вхождения указанного объекта в этом итерируемом объекте.
Примечание: может не завершаться для бесконечных итераторов.
- elem
элемент для поиска.
- returns
индекс первого вхождения
elemв значения, производимые этим итератором, или -1, если такого элемента не существует до достижения конца итератора.
- Definition Classes
- Iterator
- Note
Повторное использование: после вызова этого метода итератор следует удалить. Использование его не определено и может измениться.
def indexWhere(p: (Seq[B]) ⇒ Boolean, from: Int): Int
Возвращает индекс первого произведенного значения, удовлетворяющего предикату, или -1, после или на некотором начальном индексе.
Примечание: может не завершаться для бесконечных итераторов.
- p
предикат для проверки значений
- from
начальный индекс
- returns
индекс
>= fromпервого произведенного значения, удовлетворяющегоp, или -1, если такого элемента не существует до достижения конца итератора.
- Definition Classes
- Iterator
- Note
Повторное использование: после вызова этого метода итератор следует удалить. Использование его не определено и может измениться.
def indexWhere(p: (Seq[B]) ⇒ Boolean): Int
Возвращает индекс первого произведенного значения, удовлетворяющего предикату, или -1.
Примечание: может не завершаться для бесконечных итераторов.
- p
предикат для проверки значений
- returns
индекс первого произведенного значения, удовлетворяющего
p, или -1, если такого элемента не существует до достижения конца итератора.
- Definition Classes
- Iterator
- Note
Повторное использование: после вызова этого метода итератор следует удалить. Использование его не определено и может измениться.
def isEmpty: Boolean
Проверяет, является ли этот итератор пустым.
- returns
trueесли hasNext имеет значение false,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: (Seq[B]) ⇒ B): Iterator[B]
Создает новый итератор, отображающий все производимые значения этого итератора в новые значения с использованием функции преобразования.
- f
функция преобразования
- returns
новый итератор, преобразующий каждое значение, производимое этим итератором, путем применения функции
fк нему.
- Definition Classes
- Iterator
- Note
Повторное использование: после вызова этого метода следует удалить исходный итератор и использовать только возвращенный. Использование старого итератора не определено, может измениться и может привести к изменениям в новом итераторе.
def max: A
Находит наибольший элемент.
- returns
наибольший элемент этого обходчика или итератора.
- Definition Classes
- TraversableOnce → GenTraversableOnce
- Exceptions thrown
UnsupportedOperationException, если этот обходчик или итератор пуст.
def maxBy[B](f: (A) ⇒ B): A
Находит первый элемент, который дает наибольшее значение, измеренное функцией f.
- B
Тип результата функции f.
- f
Функция измерения.
- returns
первый элемент этого обходчика или итератора с наибольшим значением, измеренным функцией f.
- Definition Classes
- TraversableOnce → GenTraversableOnce
- Exceptions thrown
UnsupportedOperationExceptionесли этот обходчик или итератор пуст.
def min: A
Находит наименьший элемент.
- returns
наименьший элемент этого обходчика или итератора
- Definition Classes
- TraversableOnce → GenTraversableOnce
- Exceptions thrown
UnsupportedOperationExceptionесли этот обходчик или итератор пуст.
def minBy[B](f: (A) ⇒ B): A
Находит первый элемент, который дает наименьшее значение, измеренное функцией f.
- B
Тип результата функции f.
- f
Функция измерения.
- returns
первый элемент этого обходчика или итератора с наименьшим значением, измеренным функцией f.
- Definition Classes
- TraversableOnce → GenTraversableOnce
- Exceptions thrown
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 next(): List[B]
Создаёт следующий элемент этого итератора.
- возвращает
следующий элемент этого итератора, если
hasNextявляетсяtrue, в противном случае — неопределённое поведение.
- Классы-определения
- GroupedIterator → Iterator
- Примечание
Повторное использование: итератор остаётся допустимым для дальнейшего использования, независимо от возвращаемого результата.
def nonEmpty: Boolean
Проверяет, является ли итерируемая коллекция или итератор непустым.
- возвращает
true, если итерируемая коллекция или итератор содержит по крайней мере один элемент,falseв противном случае.
- Классы-определения
- TraversableOnce → GenTraversableOnce
final def notify(): Unit
Разбуживает один поток, ждущий на мониторе объекта-получателя.
- Классы-определения
- AnyRef
- Аннотации
- @native()
- Примечание
не указан в SLS как член AnyRef
final def notifyAll(): Unit
Разбуживает все потоки, ждущие на мониторе объекта-получателя.
- Классы-определения
- AnyRef
- Аннотации
- @native()
- Примечание
не указан в SLS как член AnyRef
def padTo(len: Int, elem: Seq[B]): Iterator[Seq[B]]
Добавляет значения элементов в этот итератор до достижения заданной целевой длины.
- len
целевая длина
- elem
значение для заполнения
- возвращает
новый итератор, состоящий из всех значений этого итератора, за которыми следует минимальное количество вхождений
elem, чтобы количество произведённых значений было по крайней мереlen.
- Классы-определения
- Iterator
def partition(p: (Seq[B]) ⇒ Boolean): (Iterator[Seq[B]], Iterator[Seq[B]])
Разделяет этот итератор на два итератора в соответствии с предикатом.
- p
предикат для разделения
- возвращает
пару итераторов: итератор, удовлетворяющий предикату
p, и итератор, не удовлетворяющий ему. Относительный порядок элементов в результирующих итераторах такой же, как и в исходном итераторе.
- Классы-определения
- Iterator
- Примечание
Повторное использование: после вызова этого метода следует удалить используемый итератор и использовать только возвращённые. Использование старого итератора является неопределённым, может измениться и может привести к изменениям в новых итераторах тоже.
def patch[B >: Seq[B]](from: Int, patchElems: Iterator[B], replaced: Int): Iterator[B]
Возвращает этот итератор с изменёнными значениями. Замена по отрицательным индексам эквивалентна замене с началом с 0. Замена по индексам, равным или большим длины исходного итератора, добавляет вставка в конец. Если замещаемых значений больше, чем фактически существует, избыток игнорируется.
- from
Индекс начала замены
- patchElems
Итератор значений замены
- replaced
Количество значений в исходном итераторе, которые заменяются вставкой.
- Классы-определения
- Iterator
- Примечание
Повторное использование: после вызова этого метода следует удалить используемый итератор, а также переданный в качестве параметра, и использовать только возвращённый. Использование старых итераторов неопределённо, может измениться и может привести к изменениям в новом итераторе тоже.
def product: A
Умножает элементы этой коллекции.
- возвращает
произведение всех элементов в этой итерируемой коллекции или итераторе чисел типа
Int. ВместоInt, можно использовать любой другой типT, имеющий неявноеNumeric[T]реализацию, как тип элемента итерируемой коллекции или итератора, и как тип результатаproduct. Примеры таких типов:Long,Float,Double,BigInt.
- Классы-определения
- TraversableOnce → GenTraversableOnce
def reduce[A1 >: Seq[B]](op: (A1, A1) ⇒ A1): A1
Уменьшает элементы этого обходчика или итератора, используя указанный ассоциативный бинарный оператор.
Порядок выполнения операций над элементами не определен и может быть не детерминированным.
- A1
Тип параметр для бинарного оператора, надтип
A.- op
Бинарный оператор, который должен быть ассоциативным.
- returns
Результат применения оператора reduce
opмежду всеми элементами, если обходчик или итератор не пустой.
- Definition Classes
- TraversableOnce → GenTraversableOnce
- Исключения
UnsupportedOperationExceptionесли этот обходчик или итератор пустой.
def reduceLeft[B >: Seq[B]](op: (B, Seq[B]) ⇒ 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 >: Seq[B]](op: (B, Seq[B]) ⇒ B): Option[B]
При необходимости применяет бинарный оператор ко всем элементам этого обходчика или итератора слева направо.
Примечание: не будет завершаться для бесконечных коллекций.
Примечание: может возвращать разные результаты для разных запусков, если тип базовой коллекции не упорядочен или оператор не ассоциативен и коммутативен.
- B
тип результата бинарного оператора.
- op
бинарный оператор.
- returns
Значение типа Option, содержащее результат
reduceLeft(op), если этот обходчик или итератор не пустой,Noneв противном случае.
- Definition Classes
- TraversableOnce → GenTraversableOnce
def reduceOption[A1 >: Seq[B]](op: (A1, A1) ⇒ A1): Option[A1]
Уменьшает элементы этого обходчика или итератора, если таковые имеются, используя указанный ассоциативный бинарный оператор.
Порядок выполнения операций над элементами не определен и может быть не детерминированным.
- A1
Тип параметр для бинарного оператора, надтип
A.- op
Бинарный оператор, который должен быть ассоциативным.
- returns
Значение типа Option, содержащее результат применения оператора reduce
opмежду всеми элементами, если коллекция не пустая, иNoneв противном случае.
- Definition Classes
- TraversableOnce → GenTraversableOnce
def reduceRight[B >: Seq[B]](op: (Seq[B], 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
- Исключения
UnsupportedOperationExceptionесли этот обходчик или итератор пустой.
def reduceRightOption[B >: Seq[B]](op: (Seq[B], B) ⇒ B): Option[B]
При необходимости применяет бинарный оператор ко всем элементам этого обходчика или итератора справа налево.
Примечание: не будет завершаться для бесконечных коллекций.
Примечание: может возвращать разные результаты для разных запусков, если тип базовой коллекции не упорядочен или оператор не ассоциативен и коммутативен.
- B
тип результата бинарного оператора.
- op
бинарный оператор.
- returns
Значение типа Option, содержащее результат
reduceRight(op), если этот обходчик или итератор не пустой,Noneв противном случае.
- Definition Classes
- TraversableOnce → GenTraversableOnce
def reversed: List[Seq[B]]
- Атрибуты
- protected[this]
- Классы-определения
- TraversableOnce
def sameElements(that: Iterator[_]): Boolean
Проверяет, генерирует ли другой итератор те же значения, что и этот.
Примечание: не завершится для бесконечных итераторов.
- that
другая итератор
- возвращает
true, если оба итератора генерируют одинаковые элементы в том же порядке,falseв противном случае.
- Классы-определения
- Iterator
- Примечание
Переиспользование: После вызова этого метода следует удалить итератор, на котором он был вызван, а также переданный в качестве параметра. Использование старых итераторов не определено и может быть изменено.
def scanLeft[B](z: B)(op: (B, Seq[B]) ⇒ B): Iterator[B]
Создает коллекцию, содержащую кумулятивные результаты применения оператора слева направо, включая начальное значение.
Примечание: не завершится для бесконечных итераторов.
Примечание: может возвращать разные результаты для разных запусков, если тип базовой коллекции не упорядочен.
- B
тип элементов в результирующей коллекции
- z
начальное значение
- op
бинарный оператор, применяемый к промежуточному результату и элементу
- возвращает
итератор с промежуточными результатами
- Классы-определения
- Iterator
- Примечание
Переиспользование: После вызова этого метода следует удалить итератор, на котором он был вызван, а использовать только возвращенный итератор. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новом итераторе.
def scanRight[B](z: B)(op: (Seq[B], B) ⇒ B): Iterator[B]
Создает коллекцию, содержащую кумулятивные результаты применения оператора справа налево. Первый элемент коллекции - последний кумулятивный результат.
Примечание: не завершится для бесконечных итераторов.
Примечание: может возвращать разные результаты для разных запусков, если тип базовой коллекции не упорядочен.
- B
тип элементов в результирующей коллекции
- z
начальное значение
- op
бинарный оператор, применяемый к промежуточному результату и элементу
- возвращает
итератор с промежуточными результатами
- Классы-определения
- Iterator
- Примечание
Переиспользование: После вызова этого метода следует удалить итератор, на котором он был вызван, а использовать только возвращенный итератор. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новом итераторе.
Iterator(1, 2, 3, 4).scanRight(0)(_ + _).toList == List(10, 9, 7, 4, 0)
def seq: Iterator[Seq[B]]
Версия этой коллекции со всеми операциями, реализованными последовательно (т.е., в однопоточном режиме).
Этот метод возвращает ссылку на эту коллекцию. В параллельных коллекциях он переопределен для возвращения последовательной реализации этой коллекции. В обоих случаях у него сложность O(1).
- возвращает
последовательный вид коллекции.
- Классы-определения
- Iterator → TraversableOnce → GenTraversableOnce
def size: Int
Размер этого итератора или коллекции.
Примечание: не завершится для бесконечных коллекций.
- возвращает
количество элементов в этом итераторе или коллекции.
- Классы-определения
- TraversableOnce → GenTraversableOnce
def sizeHintIfCheap: Int
Размер этой коллекции или итератора, если его можно вычислить без лишних затрат.
- возвращает
количество элементов в этой коллекции или итераторе, или -1, если размер не может быть определен без лишних затрат.
- Атрибуты
- protected[collection]
- Классы-определения
- GenTraversableOnce
def slice(from: Int, until: Int): Iterator[Seq[B]]
Создает итератор, возвращающий интервал значений, производимых этим итератором.
- from
индекс первого элемента в этом итераторе, который является частью среза. Если отрицательный, срез начинается с нуля.
- until
индекс первого элемента, следующего за срезом. Если отрицательный, срез пустой.
- возвращает
итератор, который перемещает этот итератор мимо первых
fromэлементов с помощьюdrop, а затем беретuntil - fromэлементов с помощьюtake.
- Классы-определения
- Iterator
- Примечание
Переиспользование: После вызова этого метода следует удалить итератор, на котором он был вызван, а использовать только возвращенный итератор. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новом итераторе.
def sliceIterator(from: Int, until: Int): Iterator[Seq[B]]
Создаёт срез, необязательно ограниченный, неограниченный, если until отрицательно.
- Атрибуты
- protected
- Определяющие классы
- Iterator
def sliding[B >: Seq[B]](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
- returns
Итератор, генерирующий
Seq[B]размеромsize, за исключением последнего элемента (который может быть единственным), который будет усечён, если оставшихся элементов для группирования меньше, чемsize. Это поведение можно настроить.
- Определяющие классы
- Iterator
- Примечание
Переиспользование: После вызова этого метода нужно удалить итератор, на котором был вызван метод, и использовать только возвращённый итератор. Использование старого итератора не определено, может измениться и может привести к изменениям в новом итераторе.
def span(p: (Seq[B]) ⇒ Boolean): (Iterator[Seq[B]], Iterator[Seq[B]])
Разделяет этот итератор на пару префикс/суффикс в соответствии с предикатом.
- p
предикат проверки
- returns
пара итераторов, состоящая из самого длинного префикса этого итератора, элементы которого удовлетворяют
p, и оставшаяся часть итератора.
- Определяющие классы
- Iterator
- Примечание
Переиспользование: После вызова этого метода нужно удалить итератор, на котором был вызван метод, и использовать только возвращённые итераторы. Использование старого итератора не определено, может измениться и может привести к изменениям в новых итераторах.
def sum: A
Суммирует элементы этой коллекции.
- returns
сумма всех элементов в этом перебираемом объекте или итераторе чисел типа
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[Seq[B]]
Выбирает первые n значений этого итератора.
- n
количество значений для выбора
- returns
итератор, генерирующий только первые
nзначений этого итератора, или весь итератор, если он генерирует меньше, чемnзначений.
- Определяющие классы
- Iterator
- Примечание
Переиспользование: После вызова этого метода нужно удалить итератор, на котором был вызван метод, и использовать только возвращённый итератор. Использование старого итератора не определено, может измениться и может привести к изменениям в новом итераторе.
def takeWhile(p: (Seq[B]) ⇒ Boolean): Iterator[Seq[B]]
Берёт самый длинный префикс значений, генерируемых этим итератором, которые удовлетворяют предикату.
- p
Предикат для проверки элементов.
- returns
Итератор, возвращающий значения, генерируемые этим итератором, пока этот итератор генерирует значения, удовлетворяющие предикату
p.
- Определяющие классы
- Iterator
- Примечание
Переиспользование: После вызова этого метода нужно удалить итератор, на котором был вызван метод, и использовать только возвращённый итератор. Использование старого итератора не определено, может измениться и может привести к изменениям в новом итераторе.
def to[Col[_]]: Col[A]
Преобразует этот перебираемый объект или итератор в другой, копируя все элементы.
Примечание: не завершится для бесконечных итераторов.
- Col
Тип коллекции для построения.
- returns
новая коллекция, содержащая все элементы этого перебираемого объекта или итератора.
- Определяющие классы
- TraversableOnce → GenTraversableOnce
def toArray: Array[A]
Преобразует этот перебираемый объект или итератор в массив.
Примечание: не завершится для бесконечных итераторов.
- returns
массив, содержащий все элементы этого перебираемого объекта или итератора. Должен быть доступен
ClassTagдля типа элементов этого перебираемого объекта или итератора.
- Определяющие классы
- TraversableOnce → GenTraversableOnce
def toBuffer[B >: Seq[B]]: Buffer[B]
Использует содержимое этого обходчика или итератора для создания нового изменяемого буфера.
Примечание: не будет завершаться для коллекций бесконечного размера.
- returns
буфер, содержащий все элементы этого обходчика или итератора.
- Definition Classes
- TraversableOnce → GenTraversableOnce
def toIndexedSeq: immutable.IndexedSeq[Seq[B]]
Преобразует этот обходчик или итератор в индексированную последовательность.
Примечание: не будет завершаться для коллекций бесконечного размера.
- returns
индексированная последовательность, содержащая все элементы этого обходчика или итератора.
- Definition Classes
- TraversableOnce → GenTraversableOnce
def toIterable: Iterable[Seq[B]]
Преобразует этот обходчик или итератор в итерируемую коллекцию. Обратите внимание, что выбор целевого Iterable является ленивым в этой реализации по умолчанию, так как это TraversableOnce может быть ленивым и невычисленным (т. е. это может быть итератор, который доступен только один раз).
Примечание: не будет завершаться для коллекций бесконечного размера.
- returns
итерируемая
Iterable, содержащая все элементы этого обходчика или итератора.
- Definition Classes
- TraversableOnce → GenTraversableOnce
def toIterator: Iterator[Seq[B]]
Возвращает итератор по элементам в этом обходчике или итераторе. Вернет тот же итератор, если этот экземпляр уже является итератором.
Примечание: не будет завершаться для бесконечных итераторов.
- returns
итератор, содержащий все элементы этого обходчика или итератора.
- Definition Classes
- Iterator → GenTraversableOnce
def toList: List[Seq[B]]
Преобразует этот обходчик или итератор в список.
Примечание: не будет завершаться для коллекций бесконечного размера.
- returns
список, содержащий все элементы этого обходчика или итератора.
- Definition Classes
- TraversableOnce → GenTraversableOnce
def toMap[T, U]: Map[T, U]
Преобразует этот обходчик или итератор в словарь. Этот метод недоступен, если элементы не являются членами Tuple2, каждый ((T, U)) становится парой ключ-значение в словаре. Повторные ключи будут перезаписаны последующими ключами: если это неупорядоченная коллекция, то какой ключ находится в результирующем словаре, не определено.
Примечание: не будет завершаться для бесконечных итераторов.
- returns
словарь типа
immutable.Map[T, U], содержащий все пары ключ/значение типа(T, U)этого обходчика или итератора.
- Definition Classes
- TraversableOnce → GenTraversableOnce
def toParArray: ParArray[T]
- Неявный
- Этот член добавляется неявным преобразованием из GroupedIterator[B] в CollectionsHaveToParArray[GroupedIterator[B], T] выполненным методом CollectionsHaveToParArray в scala.collection.parallel. Это преобразование произойдёт только если в области видимости есть неявное значение типа (GroupedIterator[B]) ⇒ GenTraversableOnce[T].
- Definition Classes
- CollectionsHaveToParArray
def toSeq: Seq[Seq[B]]
Преобразует этот обходчик или итератор в последовательность. Как и toIterable, оно ленивое в этой реализации по умолчанию, так как это TraversableOnce может быть ленивым и невычисленным.
Примечание: не будет завершаться для коллекций бесконечного размера.
- returns
последовательность, содержащая все элементы этого обходчика или итератора.
- Definition Classes
- TraversableOnce → GenTraversableOnce
def toSet[B >: Seq[B]]: immutable.Set[B]
Преобразует этот обходчик или итератор в множество.
Примечание: не будет завершаться для коллекций бесконечного размера.
- returns
множество, содержащее все элементы этого обходчика или итератора.
- Definition Classes
- TraversableOnce → GenTraversableOnce
def toStream: immutable.Stream[Seq[B]]
Преобразует это итеративное или перебираемое множество в поток.
- returns
поток, содержащий все элементы этого перебираемого или итеративного множества.
- Definition Classes
- Iterator → GenTraversableOnce
def toString(): String
Преобразует этот итератор в строку.
- returns
"<iterator>"является ли итератор пустым.
def toTraversable: Traversable[Seq[B]]
Преобразует это перебираемое или итеративное множество в неопределенное перебираемое множество. Возвращает ту же коллекцию, если этот экземпляр уже является перебираемым.
Примечание: не завершит работу для бесконечных итераторов.
- returns
Перебираемое множество, содержащее все элементы этого перебираемого или итеративного множества.
- Definition Classes
- Iterator → TraversableOnce → GenTraversableOnce
def toVector: Vector[Seq[B]]
Преобразует это перебираемое или итеративное множество в вектор.
Примечание: не завершит работу для бесконечных коллекций.
- 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: (Seq[B]) ⇒ Boolean): Iterator[Seq[B]]
Создаёт итератор над всеми элементами этого итератора, которые удовлетворяют предикату p. Порядок элементов сохраняется.
Примечание: withFilter эквивалентно filter для итераторов. Оно существует для того, чтобы выражения for с фильтрами работали над итераторами.
- p
предикат для проверки значений.
- returns
итератор, который генерирует те значения этого итератора, которые удовлетворяют предикату
p.
- Definition Classes
- Iterator
- Note
Переиспользование: После вызова этого метода нужно отбросить итератор, на котором он был вызван, и использовать только возвращённый итератор. Использование старого итератора не определено, может измениться и может привести к изменениям в новом итераторе.
def withPadding(x: ⇒ B): GroupedIterator.this.type
Публичные функции, которые можно использовать для настройки итератора перед его использованием.
Дополняет последний сегмент, если необходимо, чтобы все сегменты имели одинаковый размер.
- x
Элемент, который будет добавлен к последнему сегменту, если необходимо.
- returns
Тот же итератор, а не новый.
- Note
-
Этот метод изменяет итератор, на котором он вызван, который может быть безопасно использован после этого.
,Этот метод взаимоисключает
withPartial(true).
def withPartial(x: Boolean): GroupedIterator.this.type
Публичные функции, которые можно использовать для настройки итератора перед его использованием.
Выбирает, может ли последний сегмент быть возвращён с менее чем size элементами. Если нет, то некоторые элементы исходного итератора могут не быть возвращены вообще.
- x
trueесли могут быть возвращены частичные сегменты,falseв противном случае.- returns
Тот же итератор, а не новый.
- Note
-
Этот метод изменяет итератор, на котором он вызван, который может быть безопасно использован после этого.
,Этот метод взаимоисключает
withPadding.
def zip[B](that: Iterator[B]): Iterator[(Seq[B], B)]
Создаёт итератор, образованный из этого итератора и другого итератора путём объединения соответствующих значений в пары. Если один из двух итераторов длиннее другого, его оставшиеся элементы игнорируются.
- that
Итератор, предоставляющий вторую половину каждой пары результата
- returns
новый итератор, содержащий пары, состоящие из соответствующих элементов этого итератора и
that. Количество элементов, возвращаемых новым итератором, является минимальным из количества элементов, возвращаемых этим итератором иthat.
- Definition Classes
- Iterator
- Note
Переиспользование: после вызова этого метода следует удалить итератор, на котором он был вызван, а также переданный в качестве параметра, и использовать только возвращённый итератор. Использование старых итераторов не определено, может быть изменено и может привести к изменениям в новом итераторе также.
def zipAll[B](that: Iterator[B], thisElem: Seq[B], thatElem: B): Iterator[(Seq[B], B)]
Создаёт итератор, образованный из этого итератора и другого итератора путём объединения соответствующих элементов в пары. Если один из двух итераторов короче другого, для заполнения короче итератора используются значения-заполнители до длины длиннее.
- that
итератор
thatможет иметь другую длину по сравнению с исходным итератором.- thisElem
элемент
thisElemиспользуется для заполнения возвращаемого итератора, если исходный итератор корочеthat- thatElem
элемент
thatElemиспользуется для заполнения возвращаемого итератора, еслиthatкороче исходного итератора- returns
новый итератор, содержащий пары, состоящие из соответствующих значений этого итератора и
that. Длина возвращаемого итератора — максимальная из длин этого итератора иthat. Если этот итератор корочеthat, значенияthisElemиспользуются для дополнения результата. Еслиthatкороче этого итератора, значенияthatElemиспользуются для дополнения результата.
- Definition Classes
- Iterator
def zipWithIndex: Iterator[(Seq[B], Int)]
Создаёт итератор, который парсит каждый элемент, производимый этим итератором, с его индексом, считая от 0.
- returns
новый итератор, содержащий пары, состоящие из соответствующих элементов этого итератора и их индексов.
- Definition Classes
- Iterator
- Note
Переиспользование: после вызова этого метода следует удалить итератор, на котором он был вызван, и использовать только возвращённый итератор. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новом итераторе также.
def →[B](y: B): (GroupedIterator[B], B)
- Implicit
- Этот член добавлен неявным преобразованием из GroupedIterator[B] в ArrowAssoc[GroupedIterator[B]], выполненное методом ArrowAssoc в scala.Predef.
- Definition Classes
- ArrowAssoc
Скрытые неявные члены значения
def filter(p: (Seq[B]) ⇒ Boolean): TraversableOnce[Seq[B]]
- Неявный
- Этот член добавляется с помощью неявного преобразования из GroupedIterator[B] в MonadOps[Seq[B]], выполненное методом MonadOps в scala.collection.TraversableOnce.
- Затенение
- Этот неявно унаследованный член затеняется одним или несколькими членами в этом классе.
Для доступа к этому члену можно использовать приведение типа:(groupedIterator: MonadOps[Seq[B]]).filter(p)
- Классы определений
- MonadOps
def flatMap[B](f: (Seq[B]) ⇒ GenTraversableOnce[B]): TraversableOnce[B]
- Неявный
- Этот член добавляется с помощью неявного преобразования из GroupedIterator[B] в MonadOps[Seq[B]], выполненное методом MonadOps в scala.collection.TraversableOnce.
- Затенение
- Этот неявно унаследованный член затеняется одним или несколькими членами в этом классе.
Для доступа к этому члену можно использовать приведение типа:(groupedIterator: MonadOps[Seq[B]]).flatMap(f)
- Классы определений
- MonadOps
def map[B](f: (Seq[B]) ⇒ B): TraversableOnce[B]
- Неявный
- Этот член добавляется с помощью неявного преобразования из GroupedIterator[B] в MonadOps[Seq[B]], выполненное методом MonadOps в scala.collection.TraversableOnce.
- Затенение
- Этот неявно унаследованный член затеняется одним или несколькими членами в этом классе.
Для доступа к этому члену можно использовать приведение типа:(groupedIterator: MonadOps[Seq[B]]).map(f)
- Классы определений
- MonadOps
def withFilter(p: (Seq[B]) ⇒ Boolean): Iterator[Seq[B]]
- Неявный
- Этот член добавляется с помощью неявного преобразования из GroupedIterator[B] в MonadOps[Seq[B]], выполненное методом MonadOps в scala.collection.TraversableOnce.
- Затенение
- Этот неявно унаследованный член затеняется одним или несколькими членами в этом классе.
Для доступа к этому члену можно использовать приведение типа:(groupedIterator: MonadOps[Seq[B]]).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/Iterator$GroupedIterator.html
Гибкий итератор для преобразования
Iterator[A]в Iterator[Seq[A]], с настраиваемым размером последовательности, шагом и стратегией обработки элементов, которые не укладываются равномерно.Типичные применения можно достичь с помощью методов
groupedиsliding.