Spec-Zone.ru › Scala 2.12 Library

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

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

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

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

новый Zipped(that: SeqSplitter[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

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

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

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

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

that

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

returns

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

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

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

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

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

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

returns

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

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

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

Definition Classes
TraversableOnce → GenTraversableOnce

final def ==(arg0: Any): Boolean

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

returns

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

Definition Classes
AnyRef → Any

def abort(): Unit

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

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

Definition Classes
DelegatedSignalling → Signalling

def addString(b: StringBuilder): StringBuilder

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

Пример:

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

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

scala> val h = a.addString(b)
h: StringBuilder = 1234
b

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

returns

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

Definition Classes
TraversableOnce

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

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

Пример:

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

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

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

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

sep

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

returns

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

Definition Classes
TraversableOnce

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

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

Пример:

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

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

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

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

start

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

sep

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

end

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

returns

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

Definition Classes
TraversableOnce

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

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

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

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

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

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

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

z

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

seqop

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

combop

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

Definition Classes
TraversableOnce → GenTraversableOnce

def appendParIterable[U >: (T, 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]] не выбросит. В последнем примере, так как аргумент типа стирается во время компиляции, невозможно проверить, соответствуют ли содержимое списка запрошенному типу.

возвращает

объект-приёмник.

Классы-определения
Any
Исключения

ClassCastException, если объект-приёмник не является экземпляром стираемого типа T0.

def buffered: BufferedIterator[(T, S)]

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

возвращает

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

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

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

См. также

scala.collection.BufferedIterator

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

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

def clone(): AnyRef

Создаёт копию объекта-приёмника.

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

возвращает

копию объекта-приёмника.

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

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

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

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

pf

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

возвращает

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

Классы-определения
Iterator
Аннотации
@migration
Миграция

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

Примечание

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

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

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

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

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

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

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

pf

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

возвращает

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

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

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

def contains(elem: Any): Boolean

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

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

elem

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

возвращает

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

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

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

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

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

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

dest

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

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

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

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

B

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

that

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

p

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

возвращает

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

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

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

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

p

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

возвращает

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

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

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

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

n

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

returns

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

Definition Classes
IterableSplitter → Iterator

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

Definition Classes
AugmentedIterableIterator

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

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

p

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

returns

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

Definition Classes
Iterator
Note

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

def dup: IterableSplitter[(T, S)]

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

Definition Classes
Zipped → IterableSplitter

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

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

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

returns

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

Definition Classes
Iterator
Note

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

,

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

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

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

def ensuring(cond: (Zipped[S]) ⇒ Boolean): Zipped[S]

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

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

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

def ensuring(cond: Boolean): Zipped[S]

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

возвращает

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

Definition Classes
AnyRef

def equals(arg0: Any): Boolean

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

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

возвращает

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

Definition Classes
AnyRef → Any

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

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

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

p

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

возвращает

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

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

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

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

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

p

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

возвращает

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

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

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

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

Definition Classes
AugmentedIterableIterator

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

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

p

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

возвращает

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

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

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

def filterNot2combiner[U >: (T, S), This](pred: ((T, 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] )
Примечание

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

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

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

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

p

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

возвращает

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

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

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

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

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

f

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

возвращает

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

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

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

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

Definition Classes
AugmentedIterableIterator

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

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

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

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

z

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

op

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

возвращает

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

Definition Classes
AugmentedIterableIterator → TraversableOnce → GenTraversableOnce

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

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

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

p

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

returns

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

Definition Classes
Iterator → TraversableOnce → GenTraversableOnce
Note

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

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

[use case]

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

f

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

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

def formatted(fmtstr: String): String

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

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

final def getClass(): Class[_]

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

returns

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

Definition Classes
AnyRef → Any
Annotations
@native()

def grouped[B >: (T, 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
Definition Classes
Iterator
Note

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

def hasDefiniteSize: Boolean

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

возвращает

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

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

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

def hasNext: Boolean

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

возвращает

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

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

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

def hashCode(): Int

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

возвращает

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

Классы определений
AnyRef → Any
Аннотации
@native()

def indexFlag: Int

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

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

возвращает

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

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

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

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

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

elem

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

from

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

возвращает

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

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

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

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

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

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

elem

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

возвращает

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

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

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

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

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

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

p

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

from

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

возвращает

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

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

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

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

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

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

p

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

возвращает

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

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

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

def isAborted: Boolean

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

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

возвращает

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

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

def isEmpty: Boolean

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

returns

true если hasNext ложно, 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: ((T, S)) ⇒ S): Mapped[S]

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

f

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

returns

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

Definition Classes
IterableSplitter → Iterator
Note

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

def map2combiner[S, That](f: ((T, 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(): (T, S)

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

returns

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

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

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

def nonEmpty: Boolean

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

returns

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

Definition Classes
TraversableOnce → GenTraversableOnce

final def notify(): Unit

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

Definition Classes
AnyRef
Annotations
@native()
Примечание

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

final def notifyAll(): Unit

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

Definition Classes
AnyRef
Annotations
@native()
Примечание

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

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

[use case]

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

len

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

elem

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

returns

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

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

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

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

p

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

returns

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

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

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

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

Definition Classes
AugmentedIterableIterator

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

Возвращает этот итератор с изменёнными значениями. Замена по отрицательным индексам такая же, как замена, начинающаяся с 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 >: (T, S)](op: (U, U) ⇒ U): U

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

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

op

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

returns

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

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

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

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

Definition Classes
AugmentedIterableIterator

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

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

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

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

B

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

op

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

returns

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

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

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

Definition Classes
TraversableOnce
Exceptions thrown

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

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

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

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

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

B

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

op

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

returns

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

Definition Classes
TraversableOnce → GenTraversableOnce

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

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

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

A1

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

op

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

returns

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

Definition Classes
TraversableOnce → GenTraversableOnce

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

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

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

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

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

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

B

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

op

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

returns

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

Definition Classes
TraversableOnce → GenTraversableOnce

def remaining: Int

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

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

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

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

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

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

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

def reversed: List[(T, S)]

Атрибуты
protected[this]
Определяющие классы
TraversableOnce

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

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

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

that

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

возвращает

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

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

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

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

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

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

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

B

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

z

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

op

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

возвращает

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

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

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

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

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

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

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

B

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

z

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

op

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

возвращает

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

Определяющие классы
Iterator
Пример:
    Iterator(1, 2, 3, 4).scanRight(0)(_ + _).toList == List(10, 9, 7, 4, 0)
Примечание

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

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

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

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

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

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

Definition Classes
AugmentedIterableIterator

def seq: Iterator[(T, 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[(T, S)]

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

returns

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

Definition Classes
IterableSplitter → Iterator
Note

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

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

Definition Classes
AugmentedIterableIterator

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

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

Attributes
protected
Definition Classes
Iterator

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

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

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

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

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

Definition Classes
Iterator
Note

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

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

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

p

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

returns

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

Definition Classes
Iterator
Note

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

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

Definition Classes
AugmentedIterableIterator

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

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

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

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

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

returns

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

Definition Classes
Zipped → IterableSplitter → Splitter

def splitAt2combiners[U >: (T, 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[(T, S)]]

Definition Classes
IterableSplitter

def sum: A

[use case]

Sums up the elements of this collection.

returns

the sum of all elements in this traversable or iterator of numbers of type Int. Instead of Int, any other type T with an implicit Numeric[T] implementation can be used as element type of the traversable or iterator and as result type of sum. Examples of such types are: 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[(T, S)]

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

n

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

returns

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

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

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

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

Definition Classes
AugmentedIterableIterator

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

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

p

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

returns

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

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

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

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

Definition Classes
AugmentedIterableIterator

val that: SeqSplitter[S]

Атрибуты
protected

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

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

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

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

Col

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

возвращает

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

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

def toArray: Array[A]

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

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

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

возвращает

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

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

def toBuffer[B >: (T, S)]: Buffer[B]

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

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

возвращает

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

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

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

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

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

возвращает

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

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

def toIterable: Iterable[(T, S)]

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

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

возвращает

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

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

def toIterator: Iterator[(T, S)]

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

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

возвращает

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

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

def toList: List[(T, S)]

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

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

возвращает

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

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

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

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

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

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

возвращает

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

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

def toParArray: ParArray[T]

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

def toSeq: Seq[(T, S)]

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

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

возвращает

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

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

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

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

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

возвращает

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

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

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

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

возвращает

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

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

def toString(): String

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

возвращает

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

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

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

def toTraversable: Traversable[(T, S)]

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

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

возвращает

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

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

def toVector: Vector[(T, S)]

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

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

возвращает

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

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

final def wait(): Unit

Классы определений
AnyRef
Аннотации
@throws( ... )

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

Классы определений
AnyRef
Аннотации
@throws( ... )

final def wait(arg0: Long): Unit

Классы определений
AnyRef
Аннотации
@throws( ... ) @native()

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

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

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

p

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

returns

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

Definition Classes
Iterator
Note

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

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

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

that

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

returns

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

Definition Classes
Iterator
Note

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

def zip2combiner[U >: (T, 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: (T, S), thatElem: B): Iterator[((T, S), B)]

[use case]

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

that

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

thisElem

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

thatElem

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

returns

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

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

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

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

returns

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

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

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

def →[B](y: B): (Zipped[S], B)

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

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

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

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

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

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

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

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

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

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

Spec-Zone.ru

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