Spec-Zone.ru › Scala 2.12 Library

Класс scala.collection.parallel.IterableSplitter.ZippedAll

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

Источник
RemainsIterator.scala
Линейные супертипы
Известные подклассы

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

новый ZippedAll(that: SeqSplitter[S], thiselem: U, thatelem: S)

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

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

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

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

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

класс Appended[U >: T, PI <: IterableSplitter[U]] extends IterableSplitter[U]

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

класс Mapped[S] extends IterableSplitter[S]

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

класс Taken extends IterableSplitter[T]

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

класс Zipped[S] extends IterableSplitter[(T, S)]

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

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

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

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

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

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

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

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

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

that

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

returns

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

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

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

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

def /:[B](z: B)(op: (B, (U, S)) ⇒ 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: ((U, S), 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, S)) ⇒ B, combop: (B, B) ⇒ B): B

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

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

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

Например, рассмотрим суммирование целых значений списка символов. Начальное значение для суммы — 0. Во-первых, seqop преобразует каждый входной символ в Int и добавляет его к сумме (раздела). Затем, 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 >: (U, S), PI <: IterableSplitter[U]](that: PI): Appended[U, PI]

Definition Classes
IterableSplitter

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, S)]

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

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[(U, S), 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), S], cb: Combiner[S, That]): Combiner[S, That]

Definition Classes
AugmentedIterableIterator

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

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

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

dest

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

Definition Classes
TraversableOnce

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

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

B

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

that

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

p

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

returns

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

Definition Classes
Iterator

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

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

p

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

returns

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

Definition Classes
AugmentedIterableIterator → TraversableOnce → GenTraversableOnce

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

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

n

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

returns

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

Definition Classes
IterableSplitter → Iterator

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

Definition Classes
AugmentedIterableIterator

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

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

p

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

returns

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

Definition Classes
Iterator
Note

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

def dup: IterableSplitter[(U, S)]

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

Definition Classes
ZippedAll → IterableSplitter

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

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

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

returns

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

Definition Classes
Iterator
Note

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

,

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

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

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

def ensuring(cond: (ZippedAll[U, S]) ⇒ Boolean): ZippedAll[U, S]

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

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

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

def ensuring(cond: Boolean): ZippedAll[U, S]

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

final def eq(arg0: AnyRef): Boolean

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

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

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

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

returns

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

Definition Classes
AnyRef

def equals(arg0: Any): Boolean

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

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

returns

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

Definition Classes
AnyRef → Any

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

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

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

p

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

returns

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

Definition Classes
Iterator → TraversableOnce → GenTraversableOnce
Note

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

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

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

p

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

returns

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

Definition Classes
Iterator
Note

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

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

Definition Classes
AugmentedIterableIterator

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

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

p

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

returns

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

Definition Classes
Iterator
Note

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

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

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

def find(p: ((U, S)) ⇒ Boolean): Option[(U, S)]

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

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

p

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

returns

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

Definition Classes
Iterator → TraversableOnce → GenTraversableOnce
Note

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

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

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

f

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

returns

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

Definition Classes
Iterator
Note

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

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

Definition Classes
AugmentedIterableIterator

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

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

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

p

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

returns

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

Definition Classes
Iterator → TraversableOnce → GenTraversableOnce
Note

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

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

[use case]

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

f

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

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

def formatted(fmtstr: String): String

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

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

final def getClass(): Class[_]

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

возвращает

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

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

def grouped[B >: (U, S)](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
Определяющие классы
Iterator
Примечание

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

def hasDefiniteSize: Boolean

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

возвращает

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

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

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

def hasNext: Boolean

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

возвращает

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

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

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

def hashCode(): Int

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

возвращает

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

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

def indexFlag: Int

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

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

возвращает

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

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

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

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

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

elem

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

from

стартовый индекс

возвращает

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

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

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

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

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

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

elem

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

returns

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

Definition Classes
Iterator
Note

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

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

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

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

p

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

from

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

returns

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

Definition Classes
Iterator
Note

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

def indexWhere(p: ((U, S)) ⇒ Boolean): Int

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

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

p

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

returns

индекс первого произведенного значения, удовлетворяющего 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 length: Int

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

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

Definition Classes
Iterator
Note

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

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

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

f

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

returns

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

Definition Classes
IterableSplitter → Iterator
Note

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

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

Definition Classes
AugmentedIterableIterator

def max: A

[use case]

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

returns

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

Definition Classes
AugmentedIterableIterator → TraversableOnce → GenTraversableOnce
Полная сигнатура
Исключения

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

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

[use case]

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

B

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

f

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

returns

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

Definition Classes
TraversableOnce → GenTraversableOnce
Полная сигнатура
Исключения

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

def min: A

[use case]

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

returns

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

Definition Classes
AugmentedIterableIterator → TraversableOnce → GenTraversableOnce
Полная сигнатура
Исключения

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

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

[use case]

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

B

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

f

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

returns

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

Definition Classes
TraversableOnce → GenTraversableOnce
Полная сигнатура
Исключения

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

def mkString: String

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

returns

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

Definition Classes
TraversableOnce → GenTraversableOnce

def mkString(sep: String): String

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

sep

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

returns

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

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

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

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

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

start

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

sep

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

end

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

returns

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

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

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

final def ne(arg0: AnyRef): Boolean

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

returns

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

Definition Classes
AnyRef

def next(): (U, S)

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

returns

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

Definition Classes
ZippedAll → Iterator
Note

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

def nonEmpty: Boolean

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

returns

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

Definition Classes
TraversableOnce → GenTraversableOnce

final def notify(): Unit

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

Definition Classes
AnyRef
Annotations
@native()
Note

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

final def notifyAll(): Unit

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

Definition Classes
AnyRef
Annotations
@native()
Note

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

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

[use case]

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

len

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

elem

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

returns

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

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

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

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

p

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

returns

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

Definition Classes
Iterator
Note

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

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

Definition Classes
AugmentedIterableIterator

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

END_OF_DOCUMENT_MARKER

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

from

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

patchElems

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

replaced

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

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

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

def product: A

[use case]

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

returns

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

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

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

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

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

op

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

returns

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

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

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

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

Definition Classes
AugmentedIterableIterator

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

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

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

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

B

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

op

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

returns

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

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

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

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

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

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

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

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

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

B

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

op

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

returns

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

Definition Classes
TraversableOnce → GenTraversableOnce

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

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

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

A1

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

op

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

returns

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

Definition Classes
TraversableOnce → GenTraversableOnce

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

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

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

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

B

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

op

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

returns

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

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

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

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

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

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

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

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

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

B

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

op

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

returns

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

Definition Classes
TraversableOnce → GenTraversableOnce

def remaining: Int

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

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

Примечание: Этот метод может быть реализован так, чтобы возвращать верхнюю границу количества элементов в итераторе, а не точное количество элементов для итерации. Параллельные коллекции, у которых есть такие итераторы, называются коллекциями non-strict-splitter.

В этом случае необходимо учитывать 2 момента:

1) классы, которые наследуют ParIterable, должны переопределять методы take, drop, slice, splitAt, copyToArray и все остальные, использующие эту информацию.

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

Definition Classes
ZippedAll → IterableSplitter → RemainsIterator

def reversed: List[(U, S)]

Атрибуты
protected[this]
Definition Classes
TraversableOnce

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

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

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

that

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

returns

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

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

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

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

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

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

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

B

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

z

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

op

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

returns

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

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

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

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

Definition Classes
AugmentedIterableIterator

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

Definition Classes
AugmentedIterableIterator

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

Definition Classes
AugmentedIterableIterator

def seq: Iterator[(U, S)]

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

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

returns

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

Definition Classes
Iterator → TraversableOnce → GenTraversableOnce

def setIndexFlag(f: Int): Unit

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

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

f

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

Definition Classes
DelegatedSignalling → Signalling

def setIndexFlagIfGreater(f: Int): Unit

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

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

f

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

Definition Classes
DelegatedSignalling → Signalling

def setIndexFlagIfLesser(f: Int): Unit

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

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

f

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

Definition Classes
DelegatedSignalling → Signalling

def shouldSplitFurther[S](coll: 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): IterableSplitter[(U, S)]

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

returns

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

Definition Classes
IterableSplitter → Iterator
Note

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

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

Definition Classes
AugmentedIterableIterator

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

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

Attributes
protected
Definition Classes
Iterator

def sliding[B >: (U, S)](size: Int, step: Int = 1): GroupedIterator[B]

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

По умолчанию GroupedIterator можно настроить на добавление частичного результата до размера size или подавление частичного результата.

Примеры использования:

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

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

Definition Classes
Iterator
Note

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

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

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

p

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

returns

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

Definition Classes
Iterator
Note

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

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

Definition Classes
AugmentedIterableIterator

def split: scala.Seq[IterableSplitter[(U, S)]]

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

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

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

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

returns

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

Definition Classes
ZippedAll → IterableSplitter → Splitter

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

Definition Classes
AugmentedIterableIterator

def splitWithSignalling: scala.Seq[IterableSplitter[(U, S)]]

Definition Classes
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): IterableSplitter[(U, S)]

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

n

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

returns

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

Definition Classes
IterableSplitter → Iterator
Note

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

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

Definition Classes
AugmentedIterableIterator

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

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

p

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

returns

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

Definition Classes
Iterator
Note

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

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

Definition Classes
AugmentedIterableIterator

val that: SeqSplitter[S]

Attributes
protected

val thatelem: S

Attributes
protected

val thiselem: U

Attributes
protected

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, S)]: Buffer[B]

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

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

returns

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

Definition Classes
TraversableOnce → GenTraversableOnce

def toIndexedSeq: immutable.IndexedSeq[(U, S)]

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

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

returns

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

Definition Classes
TraversableOnce → GenTraversableOnce

def toIterable: Iterable[(U, S)]

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

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

returns

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

Definition Classes
TraversableOnce → GenTraversableOnce

def toIterator: Iterator[(U, S)]

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

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

returns

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

Definition Classes
Iterator → GenTraversableOnce

def toList: List[(U, S)]

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

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

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]

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

def toSeq: Seq[(U, S)]

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

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

returns

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

Definition Classes
TraversableOnce → GenTraversableOnce

def toSet[B >: (U, S)]: immutable.Set[B]

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

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

returns

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

Definition Classes
TraversableOnce → GenTraversableOnce

def toStream: immutable.Stream[(U, S)]

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

returns

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

Definition Classes
Iterator → GenTraversableOnce

def toString(): String

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

returns

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

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

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

def toTraversable: Traversable[(U, S)]

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

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

returns

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

Definition Classes
Iterator → TraversableOnce → GenTraversableOnce

def toVector: Vector[(U, S)]

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

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

returns

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

Definition Classes
TraversableOnce → GenTraversableOnce

final def wait(): Unit

Definition Classes
AnyRef
Аннотации
@throws( ... )

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

Definition Classes
AnyRef
Аннотации
@throws( ... )

final def wait(arg0: Long): Unit

Definition Classes
AnyRef
Аннотации
@throws( ... ) @native()

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

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

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

p

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

returns

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

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

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

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

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

that

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

returns

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

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

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

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

Definition Classes
AugmentedIterableIterator

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

[use case]

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

that

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

thisElem

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

thatElem

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

returns

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

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

def zipAll2combiner[U >: (U, S), 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, S), R >: S](that: SeqSplitter[S], thisElem: U, thatElem: R): ZippedAll[U, R]

Definition Classes
IterableSplitter

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

Definition Classes
IterableSplitter

def zipWithIndex: Iterator[((U, S), Int)]

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

returns

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

Definition Classes
Iterator
Note

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

def →[B](y: B): (ZippedAll[U, S], B)

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

Члены-значения неявного затенения

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

Неявный
Этот член добавлен благодаря неявной конверсии из ZippedAll[U, S] в MonadOps[(U, S)] выполняется методом MonadOps в scala.collection.TraversableOnce.
Затенение
Этот неявный унаследованный член затенен одним или несколькими членами в этом классе.
Для доступа к этому члену можно использовать приведение типа:
(zippedAll: MonadOps[(U, S)]).filter(p)
Классы определения
MonadOps

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

Неявный
Этот член добавлен благодаря неявной конверсии из ZippedAll[U, S] в MonadOps[(U, S)] выполняется методом MonadOps в scala.collection.TraversableOnce.
Затенение
Этот неявный унаследованный член затенен одним или несколькими членами в этом классе.
Для доступа к этому члену можно использовать приведение типа:
(zippedAll: MonadOps[(U, S)]).flatMap(f)
Классы определения
MonadOps

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

Неявный
Этот член добавлен благодаря неявной конверсии из ZippedAll[U, S] в MonadOps[(U, S)] выполняется методом MonadOps в scala.collection.TraversableOnce.
Затенение
Этот неявный унаследованный член затенен одним или несколькими членами в этом классе.
Для доступа к этому члену можно использовать приведение типа:
(zippedAll: MonadOps[(U, S)]).map(f)
Классы определения
MonadOps

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

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

Spec-Zone.ru

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