Spec-Zone.ru › Scala 2.12 Library

Класс scala.collection.parallel.immutable.ParVector.ParVectorIterator

класс ParVectorIterator extends VectorIterator[T] with SeqSplitter[T]

Источник
ParVector.scala
Линейные надтипы

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

новый ParVectorIterator(_start: Int, _end: Int)

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

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

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

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

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

класс Appended[U >: T, PI <: SeqSplitter[U]] extends SeqSplitter.Appended[U, PI] with SeqSplitter[U]

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

класс Mapped[S] extends SeqSplitter.Mapped[S] with SeqSplitter[S]

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

класс Patched[U >: T] extends SeqSplitter[U]

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

класс Taken extends SeqSplitter.Taken with SeqSplitter[T]

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

класс Zipped[S] extends SeqSplitter.Zipped[S] with SeqSplitter[(T, S)]

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

класс ZippedAll[U >: T, S] extends SeqSplitter.ZippedAll[U, S] with SeqSplitter[(U, S)]

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

Значения членов

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

Неявный
Этот член добавлен благодаря неявной конвертации из ParVectorIterator в any2stringadd[ParVectorIterator] при помощи метода any2stringadd в scala.Predef.
Definition Classes
any2stringadd

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

[use case]

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

that

другой итератор

returns

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

Definition Classes
Iterator
Полная сигнатура

def ->[B](y: B): (ParVectorIterator, B)

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

def /:[B](z: B)(op: (B, T) ⇒ 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: (T, 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 abort(): Unit

Отправляет сигнал прерывания другим рабочим процессам.

Флаг прерывания, установленный в true, означает, что рабочий процесс может прерваться и произвести любой результат, поскольку его результат не повлияет на конечный результат вычисления. Примерами операций, использующих это, являются методы find, forall и exists.

Definition Classes
DelegatedSignalling → Signalling

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, T) ⇒ 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

ассоциативный оператор, используемый для объединения результатов из разных разделов

Definition Classes
TraversableOnce → GenTraversableOnce

def appendParIterable[U >: T, PI <: IterableSplitter[U]](that: PI): ParVectorIterator.Appended[U, PI]

Definition Classes
IterableSplitter

def appendParSeq[U >: T, PI <: SeqSplitter[U]](that: PI): Appended[U, PI]

Definition Classes
SeqSplitter

final def asInstanceOf[T0]: T0

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

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

returns

получаемый объект.

Definition Classes
Any
Исключения

ClassCastException, если получаемый объект не является экземпляром стирания типа T0.

def buffered: BufferedIterator[T]

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

returns

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

Definition Classes
Iterator
Примечание

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

См. также

scala.collection.BufferedIterator

def buildString(closure: ((String) ⇒ Unit) ⇒ Unit): String

Атрибуты
protected
Definition Classes
IterableSplitter

def clone(): AnyRef

Создаёт копию получаемого объекта.

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

returns

копия получаемого объекта.

Атрибуты
protected[lang]
Definition Classes
AnyRef
Аннотации
@throws( ... ) @native()
Примечание

не указано в SLS как член AnyRef

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

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

pf

частичная функция, которая фильтрует и отображает итератор.

returns

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

Definition Classes
Iterator
Аннотации
@migration
Миграция

(Изменено в версии 2.8.0) collect изменено. Предыдущее поведение можно воспроизвести с помощью toSeq.

Примечание

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

def collect2combiner[S, That](pf: PartialFunction[T, S], cb: Combiner[S, That]): Combiner[S, That]

Definition Classes
AugmentedIterableIterator

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

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

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

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

pf

частичная функция

returns

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

Definition Classes
TraversableOnce
Пример:

    Seq("a", 1, 5L).collectFirst({ case x: Int => x*10 }) = Some(10)

def contains(elem: Any): Boolean

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

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

elem

тестируемый элемент.

returns

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

Definition Classes
Iterator
Примечание

Переиспользование: После вызова этого метода следует удалить вызываемый итератор. Использование его не определено и может быть изменено.

def copy2builder[U >: T, Coll, Bld <: Builder[U, Coll]](b: Bld): Bld

Definition Classes
AugmentedIterableIterator

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

[use case]

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

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

xs

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

start

начальный индекс.

len

максимальное количество копируемых элементов.

Definition Classes
AugmentedIterableIterator → Iterator → TraversableOnce → GenTraversableOnce
Полная сигнатура

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

[use case]

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

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

xs

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

Definition Classes
TraversableOnce → GenTraversableOnce
Полная сигнатура

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

[use case]

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

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

xs

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

start

начальный индекс.

Definition Classes
TraversableOnce → GenTraversableOnce
Полная сигнатура

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

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

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

dest

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

Definition Classes
TraversableOnce

def corresponds[S](corr: (T, S) ⇒ Boolean)(that: scala.Iterator[S]): Boolean

Definition Classes
AugmentedSeqIterator

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

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

B

тип элементов that

that

другая коллекция

p

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

returns

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

Definition Classes
Iterator

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

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

p

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

returns

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

Definition Classes
AugmentedIterableIterator → TraversableOnce → GenTraversableOnce

def drop(n: Int): IterableSplitter[T]

Отбрасывание реализовано как простое жадное потребление.

n

количество элементов для отбрасывания

returns

итератор, который генерирует все значения текущего итератора, но пропускает первые n значения.

Definition Classes
IterableSplitter → Iterator

def drop2combiner[U >: T, This](n: Int, cb: Combiner[U, This]): Combiner[U, This]

Definition Classes
AugmentedIterableIterator

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

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

p

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

returns

итератор, состоящий из оставшихся элементов

Definition Classes
Iterator
Note

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

def dup: SeqSplitter[T]

Создаёт копию этого итератора.

Definition Classes
ParVectorIterator → SeqSplitter → IterableSplitter

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

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

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

returns

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

Definition Classes
Iterator
Note

Реализация может выделять временное хранилище для элементов, перебираемых одним итератором, но ещё не перебираемых другим.

,

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

def ensuring(cond: (ParVectorIterator) ⇒ Boolean, msg: ⇒ Any): ParVectorIterator

Implicit
Этот член добавлен неявным преобразованием из ParVectorIterator в Ensuring[ParVectorIterator] выполненным методом Ensuring в scala.Predef.
Definition Classes
Ensuring

def ensuring(cond: (ParVectorIterator) ⇒ Boolean): ParVectorIterator

Implicit
Этот член добавлен неявным преобразованием из ParVectorIterator в Ensuring[ParVectorIterator] выполненным методом Ensuring в scala.Predef.
Definition Classes
Ensuring

def ensuring(cond: Boolean, msg: ⇒ Any): ParVectorIterator

Implicit
Этот член добавлен неявным преобразованием из ParVectorIterator в Ensuring[ParVectorIterator] выполненным методом Ensuring в scala.Predef.
Definition Classes
Ensuring

def ensuring(cond: Boolean): ParVectorIterator

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

final def eq(arg0: AnyRef): Boolean

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

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

    Он согласован: для любых объектов x и y типа AnyRef результат многократного вызова x.eq(y) будет последовательно true или последовательно false.Для любого объекта x типа AnyRef вызовы x.eq(null) и null.eq(x) возвращают false. null.eq(null) возвращает true.

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

возвращает

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

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

def equals(arg0: Any): Boolean

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

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

возвращает

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

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

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

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

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

p

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

возвращает

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

Классы-определения
Iterator → TraversableOnce → GenTraversableOnce
Примечание

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

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

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

p

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

возвращает

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

Классы-определения
Iterator
Примечание

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

def filter2combiner[U >: T, This](pred: (T) ⇒ Boolean, cb: Combiner[U, This]): Combiner[U, This]

Классы-определения
AugmentedIterableIterator

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

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

p

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

возвращает

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

Классы-определения
Iterator
Примечание

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

def filterNot2combiner[U >: T, This](pred: (T) ⇒ Boolean, cb: Combiner[U, This]): Combiner[U, This]

Классы-определения
AugmentedIterableIterator

def finalize(): Unit

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

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

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

не указано SLS как член AnyRef

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

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

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

p

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

возвращает

значение опциона, содержащее первое значение, производимое итератором, которое удовлетворяет предикату p, или None если такового не существует.

Определяющие классы
Iterator → TraversableOnce → GenTraversableOnce
Примечание

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

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

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

f

функция, применяемая к каждому элементу.

возвращает

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

Определяющие классы
Iterator
Примечание

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

def flatmap2combiner[S, That](f: (T) ⇒ GenTraversableOnce[S], cb: Combiner[S, That]): Combiner[S, That]

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

def fold[U >: T](z: U)(op: (U, U) ⇒ U): U

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

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

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

z

нейтральный элемент для операции сложения; может быть добавлен к результату произвольное количество раз, и не должен изменять результат (например, Nil для конкатенации списков, 0 для сложения или 1 для умножения).

op

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

возвращает

результат применения оператора сложения op между всеми элементами и z, или z если этот итератор или коллекция пуста.

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

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

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

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

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

B

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

z

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

op

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

возвращает

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

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

где x1, ..., xn — это элементы этого итератора или коллекции. Возвращает z если этот итератор или коллекция пуста.

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

def foldRight[B](z: B)(op: (T, 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: (T) ⇒ Boolean): Boolean

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

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

p

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

returns

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

Definition Classes
Iterator → TraversableOnce → GenTraversableOnce
Note

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

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

[use case]

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

f

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

Definition Classes
Iterator → TraversableOnce → GenTraversableOnce
Полная сигнатура

def formatted(fmtstr: String): String

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

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

final def getClass(): Class[_]

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

returns

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

Definition Classes
AnyRef → Any
Аннотации
@native()

def grouped[B >: T](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
VectorIterator → Iterator
Note

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

def hashCode(): Int

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

returns

значение хэш-кода для этого объекта.

Definition Classes
AnyRef → Any
Аннотации
@native()

def indexFlag: Int

Возвращает значение флага индекса.

Флаг индекса содержит целое число, имеющее определённый смысл, специфичный для операции. Например, операция takeWhile устанавливает флаг индекса в позицию элемента, где предикат не выполняется. Другие рабочие процессы могут проверять этот индекс против индексов, с которыми они работают, и возвращать значение, если этот индекс меньше их индекса. Примерами операций, использующих это, являются takeWhile, dropWhile, span и indexOf.

возвращает

значение флага индекса

Определяющие классы
DelegatedSignalling → Signalling

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

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

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

elem

элемент для поиска.

from

начальный индекс

возвращает

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

Определяющие классы
Iterator
Примечание

Повторное использование: после вызова этого метода итератор необходимо отбросить. Его дальнейшее использование не определено и может быть изменено.

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

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

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

elem

элемент для поиска.

возвращает

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

Определяющие классы
Iterator
Примечание

Повторное использование: после вызова этого метода итератор необходимо отбросить. Его дальнейшее использование не определено и может быть изменено.

def indexWhere(pred: (T) ⇒ Boolean): Int

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

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

возвращает

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

Определяющие классы
AugmentedSeqIterator → Iterator
Примечание

Повторное использование: после вызова этого метода итератор необходимо отбросить. Его дальнейшее использование не определено и может быть изменено.

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

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

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

p

предикат для проверки значений

from

начальный индекс

возвращает

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

Определяющие классы
Iterator
Примечание

Повторное использование: после вызова этого метода итератор необходимо отбросить. Его дальнейшее использование не определено и может быть изменено.

def isAborted: Boolean

Проверяет, был ли выпущен сигнал прерывания.

Флаг прерывания, равный true, означает, что рабочий процесс может прерваться и произвести любой результат, поскольку его результат не повлияет на окончательный результат вычисления. Примерами операций, использующих это, являются find, forall и exists методы.

возвращает

состояние прерывания

Определяющие классы
DelegatedSignalling → Signalling

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 isRemainingCheap: Boolean

Для большинства коллекций эта операция выполняется быстро. Исключения могут переопределить этот метод.

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

def isTraversableAgain: Boolean

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

возвращает

false

Определяющие классы
Iterator → GenTraversableOnce
Примечание

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

def lastIndexWhere(pred: (T) ⇒ Boolean): Int

Definition Classes
AugmentedSeqIterator

def length: Int

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

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

Definition Classes
Iterator
Примечание

Повторное использование: После вызова этого метода следует удалить вызвавший его итератор. Использование старого итератора не определено и может быть изменено.

def map[S](f: (T) ⇒ S): Mapped[S]

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

f

функция преобразования

returns

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

Definition Classes
SeqSplitter → IterableSplitter → Iterator
Примечание

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

def map2combiner[S, That](f: (T) ⇒ S, cb: Combiner[S, That]): Combiner[S, That]

Definition Classes
AugmentedIterableIterator

def max: A

[use case]

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

returns

наибольший элемент этого перебираемого объекта или итератора.

Definition Classes
AugmentedIterableIterator → TraversableOnce → GenTraversableOnce
Полная подпись
Исключения

UnsupportedOperationException если этот перебираемый объект или итератор пуст.

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

[use case]

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

B

Тип результата функции f.

f

Функция измерения.

returns

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

Definition Classes
TraversableOnce → GenTraversableOnce
Полная подпись
Исключения

UnsupportedOperationException если этот перебираемый объект или итератор пуст.

def min: A

[use case]

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

returns

наименьший элемент этого перебираемого объекта или итератора

Definition Classes
AugmentedIterableIterator → TraversableOnce → GenTraversableOnce
Полная подпись
Исключения

UnsupportedOperationException если этот перебираемый объект или итератор пуст.

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

[use case]

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

B

Тип результата функции f.

f

Функция измерения.

returns

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

Definition Classes
TraversableOnce → GenTraversableOnce
Полная подпись
Исключения

UnsupportedOperationException если этот перебираемый объект или итератор пуст.

def mkString: String

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

returns

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

Definition Classes
TraversableOnce → GenTraversableOnce

def mkString(sep: String): String

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

sep

разделительная строка.

returns

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

Definition Classes
TraversableOnce → GenTraversableOnce
Пример:

    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(): T

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

returns

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

Definition Classes
VectorIterator → Iterator
Примечание

Переиспользование: итератор остается валидным для дальнейшего использования независимо от возвращаемого результата.

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: T): Iterator[T]

[use case]

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

len

целевая длина

elem

значение для дополнения

returns

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

Definition Classes
Iterator
Полная сигнатура

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

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

p

предикат для разделения

returns

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

Definition Classes
Iterator
Примечание

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

def partition2combiners[U >: T, This](pred: (T) ⇒ Boolean, btrue: Combiner[U, This], bfalse: Combiner[U, This]): (Combiner[U, This], Combiner[U, This])

Definition Classes
AugmentedIterableIterator

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

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

from

Индекс начала замены

patchElems

Итератор значений вставки

replaced

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

Definition Classes
Iterator
Note

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

def patchParSeq[U >: T](from: Int, patchElems: SeqSplitter[U], replaced: Int): Patched[U]

Definition Classes
SeqSplitter

def prefixLength(pred: (T) ⇒ Boolean): Int

Definition Classes
AugmentedSeqIterator

def product: A

[use case]

Произведение элементов этого набора.

возвращает

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

Definition Classes
AugmentedIterableIterator → TraversableOnce → GenTraversableOnce
Полная подпись

def psplit(sizes: Int*): Seq[ParVectorIterator]

Разделяет разделитель на отдельные представления.

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

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

Например, пусть у нас есть разделитель ps с 100 элементами. Вызов:

ps.split(50, 25, 25, 10, 5)

вернёт последовательность из пяти разделителей, последние два из которых пустые. С другой стороны, вызов:

ps.split(50, 40)

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

Примечание: этот метод фактически делает текущий разделитель недействительным.

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

sizes

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

возвращает

последовательность непересекающихся итераторов подпоследовательностей этого параллельного итератора

Definition Classes
ParVectorIterator → SeqSplitter → PreciseSplitter

def psplitWithSignalling(sizes: Int*): scala.Seq[SeqSplitter[T]]

Definition Classes
SeqSplitter

def reduce[U >: T](op: (U, U) ⇒ U): U

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

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

op

Бинарный оператор, который должен быть ассоциативным.

returns

Результат применения оператора reduce op между всеми элементами, если итерируемый объект или итератор не пустой.

Definition Classes
AugmentedIterableIterator → TraversableOnce → GenTraversableOnce
Исключения

UnsupportedOperationException, если этот итерируемый объект или итератор пустой.

def reduceLeft[U >: T](howmany: Int, op: (U, U) ⇒ U): U

Definition Classes
AugmentedIterableIterator

def reduceLeft[B >: T](op: (B, T) ⇒ 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 >: T](op: (B, T) ⇒ B): Option[B]

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

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

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

B

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

op

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

returns

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

Definition Classes
TraversableOnce → GenTraversableOnce

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

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

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

A1

Параметр типа для бинарного оператора, являющийся супертипом A.

op

Бинарный оператор, который должен быть ассоциативным.

returns

Значение опционального типа, содержащее результат применения оператора reduce op между всеми элементами, если коллекция не пустая, и None в противном случае.

Definition Classes
TraversableOnce → GenTraversableOnce

def reduceRight[B >: T](op: (T, 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 >: T](op: (T, B) ⇒ B): Option[B]

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

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

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

B

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

op

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

returns

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

Definition Classes
TraversableOnce → GenTraversableOnce

def remaining: Int

Количество элементов, которые этот итератор должен ещё обработать. Этот метод не изменяет состояние итератора. В отличие от версии этого метода в супертрайте, метод remaining в ParSeqLike.this.ParIterator должен возвращать точное количество элементов, оставшихся в итераторе.

returns

точное количество элементов, которые этот итератор ещё должен пройти

Definition Classes
ParVectorIterator → SeqSplitter → AugmentedSeqIterator → IterableSplitter → RemainsIterator

def reverse: SeqSplitter[T]

Definition Classes
SeqSplitter

def reverse2combiner[U >: T, This](cb: Combiner[U, This]): Combiner[U, This]

Definition Classes
AugmentedSeqIterator

def reverseMap2combiner[S, That](f: (T) ⇒ S, cb: Combiner[S, That]): Combiner[S, That]

Definition Classes
AugmentedSeqIterator

def reversed: List[T]

Attributes
protected[this]
Definition Classes
TraversableOnce

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

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

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

that

другой итератор

returns

true, если оба итератора производят одни и те же элементы в том же порядке, false в противном случае.

Definition Classes
Iterator
Примечание

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

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

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

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

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

B

тип элементов в результирующей коллекции

z

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

op

бинарный оператор, применяемый к промежуточному результату и элементу

returns

итератор с промежуточными результатами

Definition Classes
Iterator
Примечание

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

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

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

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

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

B

тип элементов в результирующей коллекции

z

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

op

бинарный оператор, применяемый к промежуточному результату и элементу

returns

итератор с промежуточными результатами

Definition Classes
Iterator
Пример:
    Iterator(1, 2, 3, 4).scanRight(0)(_ + _).toList == List(10, 9, 7, 4, 0)
Примечание

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

def scanToArray[U >: T, A >: U](z: U, op: (U, U) ⇒ U, array: Array[A], from: Int): Unit

Definition Classes
AugmentedIterableIterator

def scanToCombiner[U >: T, That](howmany: Int, startValue: U, op: (U, U) ⇒ U, cb: Combiner[U, That]): Combiner[U, That]

Definition Classes
AugmentedIterableIterator

def scanToCombiner[U >: T, That](startValue: U, op: (U, U) ⇒ U, cb: Combiner[U, That]): Combiner[U, That]

Definition Classes
AugmentedIterableIterator

def seq: Iterator[T]

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

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

returns

последовательный вид набора данных.

Definition Classes
Iterator → TraversableOnce → GenTraversableOnce

def setIndexFlag(f: Int): Unit

Устанавливает значение флага индекса.

Флаг индекса хранит целое число, имеющее определённый смысл для конкретной операции. Например, операция takeWhile устанавливает флаг индекса в позицию элемента, где предикат терпит неудачу. Другие рабочие процессы могут сравнивать этот индекс с индексами, над которыми они работают, и возвращаться, если этот индекс меньше их индекса. Примеры операций, использующих это, — takeWhile, dropWhile, span и indexOf.

f

значение, в которое устанавливается флаг индекса.

Definition Classes
DelegatedSignalling → Signalling

def setIndexFlagIfGreater(f: Int): Unit

Устанавливает значение флага индекса, если аргумент больше текущего значения. Этот метод выполняет это атомарно.

Флаг индекса хранит целое число, имеющее определённый смысл для конкретной операции. Например, операция takeWhile устанавливает флаг индекса в позицию элемента, где предикат терпит неудачу. Другие рабочие процессы могут сравнивать этот индекс с индексами, над которыми они работают, и возвращаться, если этот индекс меньше их индекса. Примеры операций, использующих это, — takeWhile, dropWhile, span и indexOf.

f

значение, в которое устанавливается флаг индекса

Definition Classes
DelegatedSignalling → Signalling

def setIndexFlagIfLesser(f: Int): Unit

Устанавливает значение флага индекса, если аргумент меньше текущего значения. Этот метод выполняет это атомарно.

Флаг индекса хранит целое число, имеющее определённый смысл для конкретной операции. Например, операция takeWhile устанавливает флаг индекса в позицию элемента, где предикат терпит неудачу. Другие рабочие процессы могут сравнивать этот индекс с индексами, над которыми они работают, и возвращаться, если этот индекс меньше их индекса. Примеры операций, использующих это, — takeWhile, dropWhile, span и indexOf.

f

значение, в которое устанавливается флаг индекса

Definition Classes
DelegatedSignalling → Signalling

def shouldSplitFurther[S](coll: parallel.ParIterable[S], parallelismLevel: Int): Boolean

Definition Classes
IterableSplitter

val signalDelegate: Signalling

Делегат, к которому перенаправляются вызовы методов.

Definition Classes
IterableSplitter → DelegatedSignalling

def size: Int

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

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

returns

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

Definition Classes
TraversableOnce → GenTraversableOnce

def sizeHintIfCheap: Int

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

returns

количество элементов в этом наборе или итераторе, или -1, если размер нельзя определить дёшево

Attributes
protected[collection]
Definition Classes
GenTraversableOnce

def slice(from1: Int, until1: Int): SeqSplitter[T]

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

returns

итератор, который перемещает этот итератор мимо первых from элементов с использованием drop, и затем берёт until - from элементов, используя take.

Definition Classes
SeqSplitter → IterableSplitter → Iterator
Note

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

def slice2combiner[U >: T, This](from: Int, until: Int, cb: Combiner[U, This]): Combiner[U, This]

Definition Classes
AugmentedIterableIterator

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

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

Attributes
protected
Definition Classes
Iterator

def sliding[B >: T](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 элементов для группировки. Это поведение можно настроить.

Definition Classes
Iterator
Note

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

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

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

p

предикат проверки

returns

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

Definition Classes
Iterator
Note

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

def span2combiners[U >: T, This](p: (T) ⇒ Boolean, before: Combiner[U, This], after: Combiner[U, This]): (Combiner[U, This], Combiner[U, This])

Definition Classes
AugmentedIterableIterator

def split: Seq[ParVectorIterator]

Разделяет итератор на последовательность несвязных представлений.

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

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

Примечание: этот метод фактически делает текущий разделитель недействительным.

возвращает

последовательность несвязных итераторов коллекции

Definition Classes
ParVectorIterator → SeqSplitter → PreciseSplitter → IterableSplitter → Splitter

def splitAt2combiners[U >: T, This](at: Int, before: Combiner[U, This], after: Combiner[U, This]): (Combiner[U, This], Combiner[U, This])

Definition Classes
AugmentedIterableIterator

def splitWithSignalling: scala.Seq[SeqSplitter[T]]

Definition Classes
SeqSplitter → IterableSplitter

def sum: A

[use case]

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

возвращает

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

Definition Classes
AugmentedIterableIterator → TraversableOnce → GenTraversableOnce
Полная сигнатура

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

Definition Classes
AnyRef

def tag: Int

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

Definition Classes
DelegatedSignalling → Signalling

def take(n: Int): SeqSplitter[T]

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

n

количество значений для выбора

возвращает

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

Definition Classes
SeqSplitter → IterableSplitter → Iterator
Примечание

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

def take2combiner[U >: T, This](n: Int, cb: Combiner[U, This]): Combiner[U, This]

Definition Classes
AugmentedIterableIterator

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

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

p

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

returns

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

Definition Classes
Iterator
Примечание

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

def takeWhile2combiner[U >: T, This](p: (T) ⇒ Boolean, cb: Combiner[U, This]): (Combiner[U, This], Boolean)

Definition Classes
AugmentedIterableIterator

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

[use case]

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

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

Col

Тип коллекции для построения.

returns

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

Definition Classes
TraversableOnce → GenTraversableOnce
Полная сигнатура

def toArray: Array[A]

[use case]

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

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

returns

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

Definition Classes
TraversableOnce → GenTraversableOnce
Полная сигнатура

def toBuffer[B >: T]: Buffer[B]

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

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

returns

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

Definition Classes
TraversableOnce → GenTraversableOnce

def toIndexedSeq: immutable.IndexedSeq[T]

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

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

returns

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

Definition Classes
TraversableOnce → GenTraversableOnce

def toIterable: Iterable[T]

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

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

returns

коллекция Iterable, содержащая все элементы этого перебираемого или итератора.

Definition Classes
TraversableOnce → GenTraversableOnce

def toIterator: Iterator[T]

Возвращает Iterator над элементами в этом перебираемом или итераторе. Возвратит тот же Iterator, если этот экземпляр уже является Iterator.

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

returns

Iterator, содержащий все элементы этого перебираемого или итератора.

Definition Classes
Iterator → GenTraversableOnce

def toList: List[T]

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

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

returns

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

Definition Classes
TraversableOnce → GenTraversableOnce

def toMap[T, U]: collection.Map[T, U]

[use case]

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

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

returns

карта типа immutable.Map[T, U] содержащая все пары ключ/значение типа (T, U) этого итерируемого объекта или итератора.

Definition Classes
TraversableOnce → GenTraversableOnce
Полная подпись

def toParArray: ParArray[T]

Неявный
Этот член добавлен неявным преобразованием из ParVectorIterator в CollectionsHaveToParArray[ParVectorIterator, T] выполненное методом CollectionsHaveToParArray в scala.collection.parallel. Это преобразование произойдёт только в том случае, если в области видимости находится неявное значение типа (ParVectorIterator) ⇒ GenTraversableOnce[T].
Definition Classes
CollectionsHaveToParArray

def toSeq: Seq[T]

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

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

returns

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

Definition Classes
TraversableOnce → GenTraversableOnce

def toSet[B >: T]: immutable.Set[B]

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

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

returns

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

Definition Classes
TraversableOnce → GenTraversableOnce

def toStream: immutable.Stream[T]

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

returns

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

Definition Classes
Iterator → GenTraversableOnce

def toString(): String

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

returns

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

Definition Classes
Iterator → AnyRef → Any
Примечание

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

def toTraversable: Traversable[T]

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

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

returns

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

Definition Classes
Iterator → TraversableOnce → GenTraversableOnce

def toVector: Vector[T]

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

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

returns

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

Definition Classes
TraversableOnce → GenTraversableOnce

def updated2combiner[U >: T, That](индекс: Int, элемент: U, cb: Combiner[U, That]): Combiner[U, That]

Definition Classes
AugmentedSeqIterator

final def wait(): Unit

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

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

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

final def wait(arg0: Long): Unit

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

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

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

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

p

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

returns

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

Определения классов
Iterator
Примечание

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

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

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

that

Итератор, предоставляющий вторую часть каждой пары результата

returns

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

Определения классов
Iterator
Примечание

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

def zip2combiner[U >: T, S, That](otherpit: RemainsIterator[S], cb: Combiner[(U, S), That]): Combiner[(U, S), That]

Определения классов
AugmentedIterableIterator

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

[use case]

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

that

итератор, длина которого может отличаться от длины текущего итератора.

thisElem

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

thatElem

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

returns

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

Определения классов
Iterator
Полная подпись

def zipAll2combiner[U >: T, S, That](that: RemainsIterator[S], thiselem: U, thatelem: S, cb: Combiner[(U, S), That]): Combiner[(U, S), That]

Definition Classes
AugmentedIterableIterator

def zipAllParSeq[S, U >: T, R >: S](that: SeqSplitter[S], thisElem: U, thatElem: R): ZippedAll[U, R]

Definition Classes
SeqSplitter → IterableSplitter

def zipParSeq[S](that: SeqSplitter[S]): Zipped[S]

Definition Classes
SeqSplitter → IterableSplitter

def zipWithIndex: Iterator[(T, Int)]

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

возвращает

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

Definition Classes
Iterator
Примечание

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

def →[B](y: B): (ParVectorIterator, B)

Неявный
Этот член добавлен неявным преобразованием из ParVectorIterator в ArrowAssoc[ParVectorIterator] выполненным методом ArrowAssoc в scala.Predef.
Definition Classes
ArrowAssoc

Скрытые неявные члены значения

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

Неявный
Этот член добавлен неявным преобразованием из ParVectorIterator в MonadOps[T] с помощью метода MonadOps в scala.collection.TraversableOnce.
Скрытие
Этот неявно унаследованный член скрывается одним или несколькими членами в этом классе.
Для доступа к этому члену можно использовать приведение типа:
(parVectorIterator: MonadOps[T]).filter(p)
Классы определений
MonadOps

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

Неявный
Этот член добавлен неявным преобразованием из ParVectorIterator в MonadOps[T] с помощью метода MonadOps в scala.collection.TraversableOnce.
Скрытие
Этот неявно унаследованный член скрывается одним или несколькими членами в этом классе.
Для доступа к этому члену можно использовать приведение типа:
(parVectorIterator: MonadOps[T]).flatMap(f)
Классы определений
MonadOps

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

Неявный
Этот член добавлен неявным преобразованием из ParVectorIterator в MonadOps[T] с помощью метода MonadOps в scala.collection.TraversableOnce.
Скрытие
Этот неявно унаследованный член скрывается одним или несколькими членами в этом классе.
Для доступа к этому члену можно использовать приведение типа:
(parVectorIterator: MonadOps[T]).map(f)
Классы определений
MonadOps

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

Неявный
Этот член добавлен неявным преобразованием из ParVectorIterator в MonadOps[T] с помощью метода MonadOps в scala.collection.TraversableOnce.
Скрытие
Этот неявно унаследованный член скрывается одним или несколькими членами в этом классе.
Для доступа к этому члену можно использовать приведение типа:
(parVectorIterator: MonadOps[T]).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/parallel/immutable/ParVector$ParVectorIterator.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API