Spec-Zone.ru › Scala 2.12 Library

Класс scala.collection.parallel.SeqSplitter.Patched

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

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

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

новый Patched(from: Int, patch: SeqSplitter[U], replaced: Int)

Члены типов

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Члены значения

final def !=(arg0: Any): Boolean

Проверка двух объектов на неравенство.

возвращает

true если !(this == that), иначе false.

Определяющие классы
AnyRef → Any

final def ##(): Int

Эквивалентно x.hashCode за исключением упакованных числовых типов и null. Для чисел возвращается значение хэша, которое согласуется с равенством значений: если две экземпляра типа значения сравниваются как true, то ## возвращает одинаковое значение хэша для каждого из них. Для null возвращает хэш-код, где null.hashCode выбрасывает NullPointerException.

возвращает

значение хэша, согласованное с ==

Определяющие классы
AnyRef → Any

def +(other: String): String

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

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

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

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

that

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

возвращает

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

Определяющие классы
Iterator
Полная сигнатура

def ->[B](y: B): (Patched[U], B)

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

def /:[B](z: B)(op: (B, U) ⇒ B): B

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

Примечание: /: — это альтернативная синтаксическая форма foldLeft; z /: xs — это то же самое, что и xs foldLeft z.

Примеры:

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

scala> val a = List(1,2,3,4)
a: List[Int] = List(1, 2, 3, 4)

scala> val b = (5 /: a)(_+_)
b: Int = 15

scala> val c = (5 /: a)((x,y) => x + y)
c: Int = 15

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

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

B

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

z

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

op

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

возвращает

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

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

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

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

def :\[B](z: B)(op: (U, B) ⇒ B): B

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

Примечание: :\ — это альтернативная синтаксическая форма foldRight; xs :\ z — это то же самое, что и xs foldRight z.

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

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

Примеры:

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

scala> val a = List(1,2,3,4)
a: List[Int] = List(1, 2, 3, 4)

scala> val b = (a :\ 5)(_+_)
b: Int = 15

scala> val c = (a :\ 5)((x,y) => x + y)
c: Int = 15
B

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

z

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

op

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

возвращает

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

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

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

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

final def ==(arg0: Any): Boolean

Выражение x == that эквивалентно if (x eq null) that eq null else x.equals(that).

возвращает

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

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

def abort(): Unit

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

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

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

строковый буфер, в который добавляются элементы.

возвращает

строковый буфер b, в который были добавлены элементы.

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

def addString(b: StringBuilder, sep: String): StringBuilder

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

Пример:

scala> val a = List(1,2,3,4)
a: List[Int] = List(1, 2, 3, 4)

scala> val b = new StringBuilder()
b: StringBuilder =

scala> a.addString(b, ", ")
res0: StringBuilder = 1, 2, 3, 4
b

строковый буфер, в который добавляются элементы.

sep

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

возвращает

строковый буфер b, в который были добавлены элементы.

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

def addString(b: StringBuilder, start: String, sep: String, end: String): StringBuilder

Добавляет все элементы этого итерируемого объекта или итератора в строковый буфер с использованием начальной, конечной и разделительной строк. Записываемый текст начинается со строки start и заканчивается строкой end. Внутри строковые представления (согласно методу toString) всех элементов этого итерируемого объекта или итератора разделены строкой sep.

Пример:

scala> val a = List(1,2,3,4)
a: List[Int] = List(1, 2, 3, 4)

scala> val b = new StringBuilder()
b: StringBuilder =

scala> a.addString(b , "List(" , ", " , ")")
res5: StringBuilder = List(1, 2, 3, 4)
b

строковый буфер, в который добавляются элементы.

start

начальная строка.

sep

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

end

конечная строка.

возвращает

строковый буфер b, в который были добавлены элементы.

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

def aggregate[B](z: ⇒ B)(seqop: (B, U) ⇒ B, combop: (B, B) ⇒ B): B

Агрегирует результаты применения оператора к последующим элементам.

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

aggregate разбивает итерируемый объект или итератор на разделы и обрабатывает каждый раздел последовательным применением seqop, начиная с z (как в foldLeft). Затем эти промежуточные результаты комбинируются с помощью combop (как в fold). Реализация этой операции может работать с произвольным количеством разделов коллекции (даже с 1), поэтому combop может быть вызвана произвольное количество раз (даже 0).

В качестве примера рассмотрим суммирование целочисленных значений списка символов. Начальное значение для суммы равно 0. Сначала seqop преобразует каждый символ входных данных в целое число и добавляет его к сумме (раздела). Затем combop просто суммирует промежуточные результаты разделов:

List('a', 'b', 'c').aggregate(0)({ (sum, ch) => sum + ch.toInt }, { (p1, p2) => p1 + p2 })
B

тип накапливаемых результатов

z

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

seqop

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

combop

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

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

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

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

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

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

returns

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

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

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

См. также

scala.collection.BufferedIterator

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

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

def clone(): AnyRef

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

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

returns

копию объекта-получателя.

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

не определено SLS в качестве члена AnyRef

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

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

pf

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

returns

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

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

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

Примечание

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

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

Definition Classes
AugmentedIterableIterator

def collectFirst[B](pf: PartialFunction[U, 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

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

возвращает

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

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

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

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

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

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

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

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

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

xs

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

start

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

len

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

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

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

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

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

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

xs

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

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

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

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

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

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

xs

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

start

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

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

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

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

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

dest

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

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

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

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

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

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

B

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

that

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

p

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

возвращает

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

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

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

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

p

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

returns

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

Definition Classes
AugmentedIterableIterator → TraversableOnce → GenTraversableOnce

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

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

n

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

returns

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

Definition Classes
IterableSplitter → Iterator

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

Definition Classes
AugmentedIterableIterator

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

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

p

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

returns

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

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

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

def dup: Patched[U]

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

Definition Classes
Patched → SeqSplitter → IterableSplitter

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

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

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

returns

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

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

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

,

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

def ensuring(cond: (Patched[U]) ⇒ Boolean, msg: ⇒ Any): Patched[U]

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

def ensuring(cond: (Patched[U]) ⇒ Boolean): Patched[U]

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

def ensuring(cond: Boolean, msg: ⇒ Any): Patched[U]

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

def ensuring(cond: Boolean): Patched[U]

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

final def eq(arg0: AnyRef): Boolean

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

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

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

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

возвращает

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

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

def equals(arg0: Any): Boolean

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

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

возвращает

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

Определяющие классы
AnyRef → Any

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

Проверяет, удовлетворяет ли какое-либо значение, произведенное этим итератором, заданному предикату.

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

p

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

возвращает

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

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

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

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

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

p

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

возвращает

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

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

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

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

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

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

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

p

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

возвращает

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

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

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

def filterNot2combiner[U >: U, This](pred: (U) ⇒ 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: (U) ⇒ Boolean): Option[U]

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

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

p

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

returns

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

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

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

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

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

f

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

returns

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

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

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

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

Definition Classes
AugmentedIterableIterator

def fold[U >: U](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, U) ⇒ 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: (U, 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: (U) ⇒ Boolean): Boolean

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

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

p

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

returns

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

Definition Classes
Iterator → TraversableOnce → GenTraversableOnce
Note

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

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

[use case]

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

f

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

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

def formatted(fmtstr: String): String

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

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

final def getClass(): Class[_]

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

returns

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

Definition Classes
AnyRef → Any
Annotations
@native()

def grouped[B >: U](size: Int): GroupedIterator[B]

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

// Returns List(List(1, 2, 3), List(4, 5, 6), List(7)))
(1 to 7).iterator grouped 3 toList
// Returns List(List(1, 2, 3), List(4, 5, 6))
(1 to 7).iterator grouped 3 withPartial false toList
// Returns List(List(1, 2, 3), List(4, 5, 6), List(7, 20, 25)
// Illustrating that withPadding's argument is by-name.
val it2 = Iterator.iterate(20)(_ + 5)
(1 to 7).iterator grouped 3 withPadding it2.next toList
Definition Classes
Iterator
Note

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

def hasDefiniteSize: Boolean

Проверяет, имеет ли этот итератор известный размер.

returns

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

Definition Classes
Iterator → TraversableOnce → GenTraversableOnce
Note

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

def hasNext: Boolean

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

returns

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

Definition Classes
Patched → 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 >: U](elem: B, from: Int): Int

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

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

elem

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

from

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

returns

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

Definition Classes
Iterator
Note

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

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

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

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

elem

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

returns

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

Definition Classes
Iterator
Note

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

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

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

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

returns

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

Definition Classes
AugmentedSeqIterator → Iterator
Note

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

def indexWhere(p: (U) ⇒ 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
Примечание

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

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

Definition Classes
AugmentedSeqIterator

def length: Int

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

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

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

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

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

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

f

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

returns

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

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

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

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

Definition Classes
AugmentedIterableIterator

def max: A

[use case]

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

returns

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

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

UnsupportedOperationException, если этот обходной объект или итератор пуст.

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

[use case]

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

B

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

f

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

returns

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

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

UnsupportedOperationException, если этот обходной объект или итератор пуст.

def min: A

[use case]

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

returns

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

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

UnsupportedOperationException, если этот обходной объект или итератор пуст.

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

[use case]

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

B

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

f

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

returns

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

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

UnsupportedOperationException, если этот обходной объект или итератор пуст.

def mkString: String

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

возвращает

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

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

def mkString(sep: String): String

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

sep

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

возвращает

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

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

    List(1, 2, 3).mkString("|") = "1|2|3"

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

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

start

начальная строка.

sep

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

end

конечная строка.

возвращает

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

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

    List(1, 2, 3).mkString("(", "; ", ")") = "(1; 2; 3)"

final def ne(arg0: AnyRef): Boolean

Эквивалентно !(this eq that).

возвращает

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

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

def next(): U

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

возвращает

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

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

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

def nonEmpty: Boolean

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

возвращает

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

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

final def notify(): Unit

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

Классы-определения
AnyRef
Аннотации
@native()
Примечание

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

final def notifyAll(): Unit

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

Классы-определения
AnyRef
Аннотации
@native()
Примечание

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

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

[use case]

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

len

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

elem

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

возвращает

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

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

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

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

p

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

возвращает

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

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

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

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

Definition Classes
AugmentedIterableIterator

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

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

from

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

patchElems

Итератор значений для изменения

replaced

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

Definition Classes
Iterator
Note

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

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

Definition Classes
SeqSplitter

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

Definition Classes
AugmentedSeqIterator

def product: A

[use case]

Произведение элементов этой коллекции.

returns

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

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

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

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

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

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

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

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

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

ps.split(50, 40)

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

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

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

sizes

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

returns

последовательность независимых итераторов подпоследовательностей этого параллельного итератора

Definition Classes
Patched → SeqSplitter → PreciseSplitter

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

Definition Classes
SeqSplitter

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

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

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

op

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

returns

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

Definition Classes
AugmentedIterableIterator → TraversableOnce → GenTraversableOnce
Exceptions thrown

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

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

Definition Classes
AugmentedIterableIterator

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

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

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

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

B

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

op

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

returns

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

Definition Classes
TraversableOnce → GenTraversableOnce

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

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

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

A1

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

op

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

returns

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

Definition Classes
TraversableOnce → GenTraversableOnce

def reduceRight[B >: U](op: (U, 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
Exceptions thrown

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

def reduceRightOption[B >: U](op: (U, 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
Patched → SeqSplitter → AugmentedSeqIterator → IterableSplitter → RemainsIterator

def reverse: SeqSplitter[U]

Definition Classes
SeqSplitter

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

Definition Classes
AugmentedSeqIterator

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

Definition Classes
AugmentedSeqIterator

def reversed: List[U]

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, U) ⇒ B): Iterator[B]

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

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

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

B

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

z

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

op

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

returns

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

Definition Classes
Iterator
Note

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

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

Definition Classes
AugmentedIterableIterator

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

Definition Classes
AugmentedIterableIterator

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

Definition Classes
AugmentedIterableIterator

def seq: Iterator[U]

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

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

возвращает

последовательный вид коллекции.

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: ParIterable[S], parallelismLevel: Int): Boolean

Definition Classes
IterableSplitter

val signalDelegate: Signalling

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

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

def size: Int

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

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

возвращает

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

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

def sizeHintIfCheap: Int

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

возвращает

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

Атрибуты
protected[collection]
Классы-определения
GenTraversableOnce

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

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

возвращает

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

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

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

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

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

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

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

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

def sliding[B >: U](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
возвращает

Итератор, производящий Seq[B] размером size, за исключением последнего элемента (который может быть единственным элементом), который будет усечён, если оставшихся элементов для группировки меньше size. Это поведение можно настроить.

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

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

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

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

p

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

возвращает

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

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

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

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

Definition Classes
AugmentedIterableIterator

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

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

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

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

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

returns

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

Definition Classes
Patched → SeqSplitter → PreciseSplitter → IterableSplitter → Splitter

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

Definition Classes
SeqSplitter → IterableSplitter

def sum: A

[use case]

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

returns

сумма всех элементов в этом перебираемом или итераторе чисел типа 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[U]

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

n

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

returns

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

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

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

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

Definition Classes
AugmentedIterableIterator

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

Берёт самое длинное префиксное значение, производимое этим итератором, которое удовлетворяет предикату.

p

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

returns

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

Definition Classes
Iterator
Note

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

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

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

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

returns

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

Definition Classes
TraversableOnce → GenTraversableOnce

def toIndexedSeq: immutable.IndexedSeq[U]

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

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

returns

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

Definition Classes
TraversableOnce → GenTraversableOnce

def toIterable: Iterable[U]

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

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

returns

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

Definition Classes
TraversableOnce → GenTraversableOnce

def toIterator: Iterator[U]

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

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

returns

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

Definition Classes
Iterator → GenTraversableOnce

def toList: List[U]

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

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

returns

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

Definition Classes
TraversableOnce → GenTraversableOnce

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

[use case]

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

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

returns

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

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

def toParArray: ParArray[T]

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

def toSeq: Seq[U]

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

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

returns

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

Definition Classes
TraversableOnce → GenTraversableOnce

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

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

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

returns

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

Definition Classes
TraversableOnce → GenTraversableOnce

def toStream: immutable.Stream[U]

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

returns

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

Definition Classes
Iterator → GenTraversableOnce

def toString(): String

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

returns

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

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

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

def toTraversable: Traversable[U]

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

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

returns

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

Definition Classes
Iterator → TraversableOnce → GenTraversableOnce

def toVector: Vector[U]

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

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

returns

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

Definition Classes
TraversableOnce → GenTraversableOnce

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

Definition Classes
AugmentedSeqIterator

final def wait(): Unit

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

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

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

final def wait(arg0: Long): Unit

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

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

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

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

p

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

возвращает

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

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

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

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

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

that

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

возвращает

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

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

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

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

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

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

[use case]

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

that

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

thisElem

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

thatElem

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

возвращает

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

Определяющие классы
Iterator
Полная сигнатура

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

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

returns

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

Definition Classes
Iterator
Note

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

def →[B](y: B): (Patched[U], B)

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

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

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

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

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

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

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

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

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

Неявный
Этот член добавлен неявным преобразованием из Patched[U] в MonadOps[U], выполненным методом MonadOps в scala.collection.TraversableOnce.
Затенение
Этот неявный унаследованный член затенён одним или несколькими членами в этом классе.
Для доступа к этому члену можно использовать приведение типа:
(patched: MonadOps[U]).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/SeqSplitter$Patched.html

Spec-Zone.ru

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