Spec-Zone.ru › Scala 2.12 Library

Класс scala.collection.parallel.mutable.ParArray.ParArrayIterator

класс ParArrayIterator extends SeqSplitter[T]

Источник
ParArray.scala
Линейные супертипы

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

новый ParArrayIterator(i: Int = 0, until: Int = length, arr: Array[Any] = array)

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

класс 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

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

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

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

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

that

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

returns

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

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

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

Неявный
Этот член добавлен неявным преобразованием из ParArrayIterator в ArrowAssoc[ParArrayIterator] выполняемое методом 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[S](z: ⇒ S)(seqop: (S, T) ⇒ S, combop: (S, S) ⇒ S): S

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

Definition Classes
IterableSplitter

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

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

val arr: Array[Any]

final def asInstanceOf[T0]: T0

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

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

возвращает

текущий объект.

Определяющие классы
Any
Исключения

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

def buffered: BufferedIterator[T]

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

возвращает

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

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

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

См. также

scala.collection.BufferedIterator

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

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

def clone(): AnyRef

Создаёт копию объекта.

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

возвращает

копию объекта.

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

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

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

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

pf

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

возвращает

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

Определяющие классы
Iterator
Аннотации
@migration
Миграция

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

Примечание

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

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

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

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

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

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

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

pf

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

возвращает

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

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

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

def contains(elem: Any): Boolean

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

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

elem

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

returns

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

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

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

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

Definition Classes
ParArrayIterator → AugmentedIterableIterator

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

[use case]

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

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

xs

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

start

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

len

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

Definition Classes
ParArrayIterator → 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
ParArrayIterator → AugmentedIterableIterator → TraversableOnce → GenTraversableOnce

def drop(n: Int): ParArrayIterator

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

n

количество элементов для удаления

returns

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

Definition Classes
ParArrayIterator → IterableSplitter → Iterator

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

Definition Classes
ParArrayIterator → AugmentedIterableIterator

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

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

p

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

returns

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

Definition Classes
Iterator
Note

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

def dup: ParArrayIterator

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

Definition Classes
ParArrayIterator → SeqSplitter → IterableSplitter

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

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

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

returns

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

Definition Classes
Iterator
Note

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

,

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

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

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

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

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

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

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

def ensuring(cond: Boolean): ParArrayIterator

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

final def eq(arg0: AnyRef): Boolean

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

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

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

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

возвращает

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

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

def equals(arg0: Any): Boolean

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

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

возвращает

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

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

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

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

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

p

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

возвращает

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

Классы определений
ParArrayIterator → 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]

Классы определений
ParArrayIterator → 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]

Definition Classes
ParArrayIterator → AugmentedIterableIterator

def finalize(): Unit

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

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

Attributes
protected[lang]
Definition Classes
AnyRef
Annotations
@throws( classOf[java.lang.Throwable] )
Примечание

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

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

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

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

p

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

возвращает

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

Definition Classes
ParArrayIterator → Iterator → TraversableOnce → GenTraversableOnce
Примечание

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

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

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

f

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

возвращает

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

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

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

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

Definition Classes
ParArrayIterator → AugmentedIterableIterator

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

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

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

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

z

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

op

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

возвращает

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

Definition Classes
ParArrayIterator → AugmentedIterableIterator → TraversableOnce → GenTraversableOnce

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

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

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

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

z

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

op

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

returns

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

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

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

Definition Classes
ParArrayIterator → 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
ParArrayIterator → Iterator → TraversableOnce → GenTraversableOnce
Note

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

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

[use case]

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

f

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

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

def formatted(fmtstr: String): String

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

Неявный
Этот член добавлен неявным преобразованием из ParArrayIterator в StringFormat[ParArrayIterator] через метод StringFormat в scala.Predef.
Definition Classes
StringFormat
Annotations
@inline()

final def getClass(): Class[_]

Возвращает представление runtime-класса объекта.

returns

объект класса, соответствующий runtime-типу получателя.

Definition Classes
AnyRef → Any
Annotations
@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

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

возвращает

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

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

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

def hashCode(): Int

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

возвращает

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

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

var i: Int

def indexFlag: Int

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

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

возвращает

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

Definition Classes
DelegatedSignalling → Signalling

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

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

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

elem

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

from

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

возвращает

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

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

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

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

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

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

elem

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

возвращает

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

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

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

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

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

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

возвращает

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

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

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

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

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

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

p

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

from

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

возвращает

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

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

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

def isAborted: Boolean

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

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

возвращает

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

Definition Classes
DelegatedSignalling → Signalling

def isEmpty: Boolean

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

возвращает

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

Definition Classes
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

Определяющие классы
ParArrayIterator → AugmentedSeqIterator

def length: Int

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

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

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

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

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

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

f

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

возвращает

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

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

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

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

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

def max: A

[use case]

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

возвращает

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

Определяющие классы
AugmentedIterableIterator → TraversableOnce → GenTraversableOnce
Полная сигнатура
Исключения

UnsupportedOperationException если эта коллекция или итератор пуста.

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

[use case]

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

B

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

f

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

возвращает

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

Определяющие классы
TraversableOnce → GenTraversableOnce
Полная сигнатура
Исключения

UnsupportedOperationException если эта коллекция или итератор пуста.

def min: A

[use case]

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

возвращает

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

Определяющие классы
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
ParArrayIterator → 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
ParArrayIterator → AugmentedIterableIterator

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

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

from

Начальный индекс для замены

patchElems

Итератор значений замены

replaced

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

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

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

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

Definition Classes
SeqSplitter

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

Definition Classes
ParArrayIterator → AugmentedSeqIterator

def product: A

[use case]

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

returns

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

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

def psplit(sizesIncomplete: Int*): scala.Seq[ParArrayIterator]

Разделяет разделитель на непересекающиеся представления.

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

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

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

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

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

ps.split(50, 40)

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

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

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

returns

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

Definition Classes
ParArrayIterator → 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
Exceptions thrown

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
Exceptions thrown

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

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

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

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

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

B

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

op

бинарная операция.

returns

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

Definition Classes
TraversableOnce → GenTraversableOnce

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

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

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

A1

тип параметра для бинарной операции, супертип A.

op

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

returns

Объект Option, содержащий результат применения оператора 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
ParArrayIterator → 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
ParArrayIterator → 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: scala.Iterator[_]): Boolean

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

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

that

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

returns

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

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

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

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

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

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

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

B

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

z

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

op

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

returns

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

Definition Classes
Iterator
Note

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

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)
Note

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

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

Definition Classes
ParArrayIterator → AugmentedIterableIterator

def scanToArray_quick[U](srcarr: Array[Any], destarr: Array[Any], op: (U, U) ⇒ U, z: U, srcfrom: Int, srcntil: Int, destfrom: Int): Unit

Attributes
protected

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: scala.Seq[ParArrayIterator]

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

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

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

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

returns

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

Definition Classes
ParArrayIterator → 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.

Классы определений
ParArrayIterator → AugmentedIterableIterator → TraversableOnce → GenTraversableOnce
Полная подпись

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

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

def tag: Int

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

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

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

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

n

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

возвращает

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

Классы определений
SeqSplitter → IterableSplitter → Iterator
Примечание

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

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

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

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

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

p

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

возвращает

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

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

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

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

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

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

[use case]

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

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

Col

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

возвращает

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

Классы определений
TraversableOnce → GenTraversableOnce
Полная подпись

def toArray: Array[A]

[use case]

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

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

возвращает

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

Классы определений
TraversableOnce → GenTraversableOnce
Полная подпись

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

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

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

returns

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

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

def toIndexedSeq: immutable.IndexedSeq[T]

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

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

returns

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

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

def toIterable: Iterable[T]

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

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

returns

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

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

def toIterator: Iterator[T]

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

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

returns

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

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

def toList: List[T]

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

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

returns

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

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

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

[use case]

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

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

returns

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

Классы-определения
TraversableOnce → GenTraversableOnce
Полная сигнатура

def toParArray: ParArray[T]

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

def toSeq: Seq[T]

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

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

returns

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

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

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

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

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

returns

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

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

def toStream: immutable.Stream[T]

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

returns

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

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

def toString(): String

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

returns

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

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

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

def toTraversable: Traversable[T]

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

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

returns

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

Definition Classes
Iterator → TraversableOnce → GenTraversableOnce

def toVector: Vector[T]

Преобразует это обходное множество или итератор в вектор.

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

returns

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

Definition Classes
TraversableOnce → GenTraversableOnce

val until: Int

def updated2combiner[U >: T, That](index: Int, elem: U, cb: Combiner[U, That]): Combiner[U, That]

Definition Classes
AugmentedSeqIterator

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

Definition Classes
AnyRef
Annotations
@throws( ... ) @native()

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

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

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

p

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

returns

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

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

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

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

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

that

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

returns

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

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

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

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

Definition Classes
AugmentedIterableIterator

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

[use case]

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

that

итератор that может иметь другую длину, чем самописный итератор.

thisElem

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

thatElem

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

returns

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

Definition Classes
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.

returns

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

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

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

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

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

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

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

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

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

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

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

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

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

Неявный
Этот член добавлен с помощью неявного преобразования из ParArrayIterator в MonadOps[T] выполненным методом MonadOps в scala.collection.TraversableOnce.
Затенение
Этот неявный унаследованный член затенён одним или несколькими членами в этом классе.
Для доступа к этому члену можно использовать приведение типа:
(parArrayIterator: 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/mutable/ParArray$ParArrayIterator.html

Spec-Zone.ru

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