Spec-Zone.ru › Scala 2.12 Library

Класс scala.collection.parallel.immutable.ParRange.ParRangeIterator

класс ParRangeIterator extends SeqSplitter[Int]

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

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

новый ParRangeIterator(range: immutable.Range = self.range)

Члены типа

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

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

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

[пример использования]

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

that

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

returns

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

Definition Classes
Iterator
Полная подпись

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

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

def /:[B](z: B)(op: (B, Int) ⇒ 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: (Int, 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, Int) ⇒ 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 >: Int, PI <: IterableSplitter[U]](that: PI): ParRangeIterator.Appended[U, PI]

Definition Classes
IterableSplitter

def appendParSeq[U >: Int, 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[Int]

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

returns

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

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

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

См. также

scala.collection.BufferedIterator

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

Attributes
protected
Definition Classes
IterableSplitter

def clone(): AnyRef

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

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

returns

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

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

не специфицировано SLS как член AnyRef

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

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

pf

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

returns

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

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

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

Примечание

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

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

Definition Classes
AugmentedIterableIterator

def collectFirst[B](pf: PartialFunction[Int, 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 >: Int, 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 >: Int](dest: Buffer[B]): Unit

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

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

dest

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

Definition Classes
TraversableOnce

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

Definition Classes
AugmentedSeqIterator

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

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

B

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

that

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

p

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

returns

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

Definition Classes
Iterator

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

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

p

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

returns

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

Definition Classes
AugmentedIterableIterator → TraversableOnce → GenTraversableOnce

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

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

n

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

возвращает

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

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

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

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

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

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

p

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

возвращает

итератор, содержащий оставшиеся элементы

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

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

def dup: ParRangeIterator

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

Классы-определения
ParRangeIterator → SeqSplitter → IterableSplitter

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

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

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

возвращает

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

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

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

,

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

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

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

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

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

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

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

def ensuring(cond: Boolean): ParRangeIterator

Неявный
Этот член добавлен неявным преобразованием из ParRangeIterator в Ensuring[ParRangeIterator] выполненным методом 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).

returns

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

Definition Classes
AnyRef

def equals(arg0: Any): Boolean

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

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

returns

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

Definition Classes
AnyRef → Any

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

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

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

p

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

returns

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

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

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

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

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

p

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

returns

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

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

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

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

Definition Classes
AugmentedIterableIterator

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

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

p

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

returns

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

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

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

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

Definition Classes
AugmentedIterableIterator

def finalize(): Unit

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

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

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

не специфицирован SLS как член AnyRef

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

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

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

p

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

returns

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

Definition Classes
Iterator → TraversableOnce → GenTraversableOnce
Note

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

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

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

f

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

returns

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

Definition Classes
Iterator
Note

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

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

Definition Classes
AugmentedIterableIterator

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

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

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

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

z

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

op

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

returns

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

Definition Classes
AugmentedIterableIterator → TraversableOnce → GenTraversableOnce

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

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

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

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

B

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

z

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

op

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

returns

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

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

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

Definition Classes
TraversableOnce → GenTraversableOnce

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

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

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

p

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

returns

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

Definition Classes
Iterator → TraversableOnce → GenTraversableOnce
Note

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

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

[use case]

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

f

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

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

def formatted(fmtstr: String): String

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

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

final def getClass(): Class[_]

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

returns

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

Definition Classes
AnyRef → Any
Annotations
@native()

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

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

final def hasNext: Boolean

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

returns

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

Definition Classes
ParRangeIterator → Iterator
Note

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

def hashCode(): Int

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

returns

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

Definition Classes
AnyRef → Any
Annotations
@native()

def indexFlag: Int

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

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

returns

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

Definition Classes
DelegatedSignalling → Signalling

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

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

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

elem

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

from

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

returns

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

Definition Classes
Iterator
Note

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

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

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

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

elem

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

returns

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

Definition Classes
Iterator
Note

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

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

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

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

returns

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

Definition Classes
AugmentedSeqIterator → Iterator
Note

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

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

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

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

p

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

from

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

returns

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

Definition Classes
Iterator
Note

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

def isAborted: Boolean

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

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

returns

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

Definition Classes
DelegatedSignalling → Signalling

def isEmpty: Boolean

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

returns

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

Definition Classes
Iterator → TraversableOnce → GenTraversableOnce
Note

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

final def isInstanceOf[T0]: Boolean

Проверяет, является ли динамический тип объекта-получателя T0.

Обратите внимание, что результат проверки происходит с учётом стирания типов в Scala. Таким образом, выражение 1.isInstanceOf[String] вернёт false, а выражение List(1).isInstanceOf[List[String]] вернёт true. В последнем примере, потому что аргумент типа стёрся во время компиляции, проверить, содержат ли элементы списка указанный тип невозможно.

returns

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

Definition Classes
Any

def isRemainingCheap: Boolean

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

Definition Classes
RemainsIterator

def isTraversableAgain: Boolean

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

returns

false

Definition Classes
Iterator → GenTraversableOnce
Note

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

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

Definition Classes
AugmentedSeqIterator

def length: Int

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

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

Definition Classes
Iterator
Note

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

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

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

f

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

returns

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

Definition Classes
SeqSplitter → IterableSplitter → Iterator
Note

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

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

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

final def next(): Int

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

returns

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

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

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

def nonEmpty: Boolean

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

returns

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

Definition Classes
TraversableOnce → GenTraversableOnce

final def notify(): Unit

Разбудит один поток, ожидающий монитора объекта-получателя.

Definition Classes
AnyRef
Аннотации
@native()
Примечание

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

final def notifyAll(): Unit

Разбудит все потоки, ожидающие монитора объекта-получателя.

Definition Classes
AnyRef
Аннотации
@native()
Примечание

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

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

[use case]

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

len

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

elem

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

returns

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

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

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

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

p

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

returns

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

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

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

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

Definition Classes
AugmentedIterableIterator

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

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

from

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

patchElems

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

replaced

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

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

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

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

Definition Classes
SeqSplitter

def prefixLength(pred: (Int) ⇒ 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*): scala.Seq[SeqSplitter[Int]]

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

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

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

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

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

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

ps.split(50, 40)

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

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

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

sizes

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

возвращает

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

Definition Classes
ParRangeIterator → SeqSplitter → PreciseSplitter

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

Definition Classes
SeqSplitter

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

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

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

op

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

возвращает

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

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

UnsupportedOperationException, если этот итерабельной или итератор пустой.

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

Definition Classes
AugmentedIterableIterator

def reduceLeft[B >: Int](op: (B, Int) ⇒ B): B

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

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

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

B

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

op

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

returns

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

op( op( ... op(x_1, x_2) ..., x_{n-1}), x_n)

где x1, ..., xn — элементы этого обхода или итератора.

Определяющие классы
TraversableOnce
Выбрасываемые исключения

UnsupportedOperationException если этот обход или итератор пуст.

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

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

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

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

B

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

op

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

returns

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

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

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

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

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

A1

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

op

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

returns

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

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

def reduceRight[B >: Int](op: (Int, B) ⇒ B): B

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

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

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

B

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

op

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

returns

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

op(x_1, op(x_2, ..., op(x_{n-1}, x_n)...))

где x1, ..., xn — элементы этого обхода или итератора.

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

UnsupportedOperationException если этот обход или итератор пуст.

def reduceRightOption[B >: Int](op: (Int, B) ⇒ B): Option[B]

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

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

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

B

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

op

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

returns

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

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

final def remaining: Int

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

returns

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

Определяющие классы
ParRangeIterator → SeqSplitter → AugmentedSeqIterator → IterableSplitter → RemainsIterator

def reverse: SeqSplitter[Int]

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

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

Definition Classes
AugmentedSeqIterator

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

Definition Classes
AugmentedSeqIterator

def reversed: List[Int]

Attributes
protected[this]
Definition Classes
TraversableOnce

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

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

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

that

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

returns

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

Definition Classes
Iterator
Note

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

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

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

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

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

B

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

z

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

op

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

returns

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

Definition Classes
Iterator
Note

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

def scanRight[B](z: B)(op: (Int, 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 >: Int, A >: U](z: U, op: (U, U) ⇒ U, array: Array[A], from: Int): Unit

Definition Classes
AugmentedIterableIterator

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

Definition Classes
AugmentedIterableIterator

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

Definition Classes
AugmentedIterableIterator

def seq: Iterator[Int]

A version of this collection with all of the operations implemented sequentially (i.e., in a single-threaded manner).

This method returns a reference to this collection. In parallel collections, it is redefined to return a sequential implementation of this collection. In both cases, it has O(1) complexity.

returns

a sequential view of the collection.

Definition Classes
Iterator → TraversableOnce → GenTraversableOnce

def setIndexFlag(f: Int): Unit

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

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

f

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

Definition Classes
DelegatedSignalling → Signalling

def setIndexFlagIfGreater(f: Int): Unit

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

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

f

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

Definition Classes
DelegatedSignalling → Signalling

def setIndexFlagIfLesser(f: Int): Unit

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

Флаг индекса хранит целое число, имеющее определённый смысл для конкретной операции. Например, операция takeWhile устанавливает флаг индекса в позицию элемента, где предикат возвращает false. Другие рабочие элементы могут сравнивать этот индекс с индексами, на которых они работают, и возвращаться, если этот индекс меньше их индекса. Примерами операций, использующих это, являются 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[Int]

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

returns

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

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

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

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

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

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

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

Атрибуты
protected
Классы определений
Iterator

def sliding[B >: Int](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]s размера size, за исключением последнего элемента (который может быть единственным элементом), который будет усечён, если оставшихся элементов меньше, чем size для группирования. Это поведение можно настроить.

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

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

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

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

p

предикат теста

returns

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

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

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

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

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

def split: scala.Seq[SeqSplitter[Int]]

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

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

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

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

returns

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

Классы определений
ParRangeIterator → SeqSplitter → PreciseSplitter → IterableSplitter → Splitter

def splitAt2combiners[U >: Int, 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[Int]]

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[Int]

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

n

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

возвращает

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

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

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

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

Definition Classes
AugmentedIterableIterator

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

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

p

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

возвращает

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

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

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

def takeWhile2combiner[U >: Int, This](p: (Int) ⇒ 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 >: Int]: Buffer[B]

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

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

returns

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

Definition Classes
TraversableOnce → GenTraversableOnce

def toIndexedSeq: immutable.IndexedSeq[Int]

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

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

returns

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

Definition Classes
TraversableOnce → GenTraversableOnce

def toIterable: Iterable[Int]

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

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

returns

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

Definition Classes
TraversableOnce → GenTraversableOnce

def toIterator: Iterator[Int]

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

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

returns

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

Definition Classes
Iterator → GenTraversableOnce

def toList: List[Int]

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

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

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]

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

def toSeq: Seq[Int]

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

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

возвращает

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

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

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

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

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

возвращает

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

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

def toStream: immutable.Stream[Int]

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

возвращает

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

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

def toString(): String

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

возвращает

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

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

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

def toTraversable: Traversable[Int]

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

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

возвращает

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

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

def toVector: Vector[Int]

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

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

возвращает

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

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

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

Определяющие классы
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: (Int) ⇒ Boolean): Iterator[Int]

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

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

p

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

возвращает

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

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

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

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

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

that

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

returns

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

Definition Classes
Iterator
Note

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

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

Definition Classes
AugmentedIterableIterator

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

[use case]

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

that

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

thisElem

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

thatElem

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

returns

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

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

def zipAll2combiner[U >: Int, 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 >: Int, 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[(Int, Int)]

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

returns

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

Definition Classes
Iterator
Note

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

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

Implicit
Этот член добавлен неявным преобразованием из ParRangeIterator в ArrowAssoc[ParRangeIterator] с помощью метода ArrowAssoc в scala.Predef.
Definition Classes
ArrowAssoc

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

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

Implicit
Этот член добавлен неявным преобразованием из ParRangeIterator в MonadOps[Int] с помощью метода MonadOps в scala.collection.TraversableOnce.
Затенение
Этот неявно унаследованный член затенён одним или несколькими членами в этом классе.
Для доступа к этому члену можно использовать описание типа:
(parRangeIterator: MonadOps[Int]).filter(p)
Definition Classes
MonadOps

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

Implicit
Этот член добавлен неявным преобразованием из ParRangeIterator в MonadOps[Int] с помощью метода MonadOps в scala.collection.TraversableOnce.
Затенение
Этот неявно унаследованный член затенён одним или несколькими членами в этом классе.
Для доступа к этому члену можно использовать описание типа:
(parRangeIterator: MonadOps[Int]).flatMap(f)
Definition Classes
MonadOps

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

Implicit
Этот член добавлен неявным преобразованием из ParRangeIterator в MonadOps[Int] с помощью метода MonadOps в scala.collection.TraversableOnce.
Затенение
Этот неявно унаследованный член затенён одним или несколькими членами в этом классе.
Для доступа к этому члену можно использовать описание типа:
(parRangeIterator: MonadOps[Int]).map(f)
Definition Classes
MonadOps

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

Implicit
Этот член добавлен неявным преобразованием из ParRangeIterator в MonadOps[Int] с помощью метода MonadOps в scala.collection.TraversableOnce.
Затенение
Этот неявно унаследованный член затенён одним или несколькими членами в этом классе.
Для доступа к этому члену можно использовать описание типа:
(parRangeIterator: MonadOps[Int]).withFilter(p)
Definition Classes
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/ParRange$ParRangeIterator.html

Spec-Zone.ru

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