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

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

Источник: RemainsIterator.scala

Линейные супертипы

Известные подклассы

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

новый Appended(that: PI)

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

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

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

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

[use case]

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

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

Definition Classes: Iterator

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

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

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

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

Примечание: /: - альтернативная синтаксическая запись для foldLeft; z /: xs эквивалентно xs foldLeft z.

Примеры:

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

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

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

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

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

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

B

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

z

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

op

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

returns

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

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

где x₁, ..., x_n - элементы этого итерируемого или итератора.

Definition Classes: TraversableOnce → GenTraversableOnce

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

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

Примечание: :\ - альтернативная синтаксическая запись для foldRight; xs :\ z эквивалентно xs foldRight z.

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

Примеры:

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

где x₁, ..., x_n - элементы этого итерируемого или итератора.

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, U) ⇒ B, combop: (B, B) ⇒ B): B

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

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

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

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

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

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

Definition Classes: TraversableOnce → GenTraversableOnce

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

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

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

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

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

Definition Classes: Iterator
Аннотации: @migration
Миграция: (Изменено в версии 2.8.0) collect изменилось. Предыдущее поведение может быть воспроизведено с помощью toSeq.
Примечание: Переиспользование: После вызова этого метода следует отказаться от итератора, на котором он был вызван, и использовать только возвращённый итератор. Использование старого итератора не определено, может измениться и может привести к изменениям в новом итераторе также.

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

Definition Classes: AugmentedIterableIterator

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

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

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

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

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

Definition Classes: TraversableOnce

def contains(elem: Any): Boolean

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

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

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

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

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

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

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

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

Definition Classes: TraversableOnce

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

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

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

Definition Classes: Iterator

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

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

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

Definition Classes: AugmentedIterableIterator → TraversableOnce → GenTraversableOnce

var curr: IterableSplitter[U]

Attributes: protected

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

Операция drop реализована как простое жадное потребление.

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

Definition Classes: IterableSplitter → Iterator

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

Definition Classes: AugmentedIterableIterator

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

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

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

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

def dup: IterableSplitter[U]

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

Definition Classes: Appended → IterableSplitter

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

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

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

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

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

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

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

def ensuring(cond: (Appended[U, PI]) ⇒ Boolean): Appended[U, PI]

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

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

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

def ensuring(cond: Boolean): Appended[U, PI]

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

final def eq(arg0: AnyRef): Boolean

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

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

x

y

AnyRef

x.eq(y)

true

false

x

AnyRef

x.eq(null)

null.eq(x)

false

null.eq(null)

true

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

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

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

def equals(arg0: Any): Boolean

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

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

возвращает: true, если принимаемый объект эквивалентен аргументу; false в противном случае.

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

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

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

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

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

Определяющие классы: Iterator → TraversableOnce → GenTraversableOnce
Примечание: Переиспользование: После вызова этого метода следует отбросить вызвавший его итератор. Использование его неопределенно и может измениться.

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

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

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

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

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

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

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

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

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

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

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

Definition Classes: AugmentedIterableIterator

def finalize(): Unit

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

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

Attributes: protected[lang]
Definition Classes: AnyRef
Annotations: @throws( classOf[java.lang.Throwable] )
Note: не определён SLS в качестве члена AnyRef

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

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

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

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

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

def firstNonEmpty: Boolean

Attributes: protected

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

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

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

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

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

Definition Classes: AugmentedIterableIterator

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

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

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

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

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

Definition Classes: AugmentedIterableIterator → TraversableOnce → GenTraversableOnce

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

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

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

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

B

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

z

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

op

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

returns

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

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

где x₁, ..., x_n — элементы этого итератора или перебираемой последовательности. Возвращает z, если этот итератор или перебираемая последовательность пуста.

Definition Classes: TraversableOnce → GenTraversableOnce

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

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

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

B

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

z

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

op

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

returns

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

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

Definition Classes: TraversableOnce → GenTraversableOnce

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

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

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

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

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

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

[use case]

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

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

Definition Classes: Iterator → TraversableOnce → GenTraversableOnce

def formatted(fmtstr: String): String

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

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

final def getClass(): Class[_]

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

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

Definition Classes: AnyRef → Any
Annotations: @native()

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

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

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

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

def hasDefiniteSize: Boolean

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

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

Definition Classes: Iterator → TraversableOnce → GenTraversableOnce
Note: Переиспользование: Итератор остаётся допустимым для дальнейшего использования, независимо от возвращаемого результата.

def hasNext: Boolean

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

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

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

def hashCode(): Int

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

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

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

def indexFlag: Int

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

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

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

Definition Classes: DelegatedSignalling → Signalling

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

def isAborted: Boolean

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

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

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

Definition Classes: DelegatedSignalling → Signalling

def isEmpty: Boolean

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

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

Definition Classes: Iterator → TraversableOnce → GenTraversableOnce
Примечание: Повторное использование: итератор остаётся валидным для дальнейшего использования независимо от возвращаемого результата.

final def isInstanceOf[T0]: Boolean

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

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

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): Mapped[S]

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

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

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

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

Definition Classes: AugmentedIterableIterator

def max: A

[use case]

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

returns: наибольший элемент этого итерируемого или итератора.

Definition Classes: AugmentedIterableIterator → TraversableOnce → GenTraversableOnce
Исключения: UnsupportedOperationException, если этот итерируемый или итератор пуст.

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

[use case]

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

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

Definition Classes: TraversableOnce → GenTraversableOnce
Исключения: UnsupportedOperationException, если этот итерируемый или итератор пуст.

def min: A

[use case]

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

returns: наименьший элемент этого итерируемого или итератора

Definition Classes: AugmentedIterableIterator → TraversableOnce → GenTraversableOnce
Исключения: UnsupportedOperationException, если этот итерируемый или итератор пуст.

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

[use case]

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

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

Definition Classes: TraversableOnce → GenTraversableOnce
Исключения: UnsupportedOperationException, если этот итерируемый объект или итератор пустой.

def mkString: String

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

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

Definition Classes: TraversableOnce → GenTraversableOnce

def mkString(sep: String): String

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

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

Definition Classes: TraversableOnce → GenTraversableOnce

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

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

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

Definition Classes: TraversableOnce → GenTraversableOnce

final def ne(arg0: AnyRef): Boolean

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

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

Definition Classes: AnyRef

def next(): U

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

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

Definition Classes: Appended → 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: U): Iterator[U]

[use case]

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

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

Definition Classes: Iterator

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

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

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

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

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

Definition Classes: AugmentedIterableIterator

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

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

from: Начальный индекс замены
patchElems: Итератор значений вставки
replaced: Количество значений в исходном итераторе, которые заменяются вставкой.

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

def product: A

[use case]

Умножает элементы этой коллекции.

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

Definition Classes: AugmentedIterableIterator → TraversableOnce → GenTraversableOnce

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

Применяет оператор к элементам этой коллекции или итератора.

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

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

Definition Classes: AugmentedIterableIterator → TraversableOnce → GenTraversableOnce
Exceptions thrown: UnsupportedOperationException, если эта коллекция или итератор пуста.

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

Definition Classes: AugmentedIterableIterator

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

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

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

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

B

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

op

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

returns

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

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

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

Definition Classes: TraversableOnce
Исключения: UnsupportedOperationException, если этот итерируемый объект или итератор пуст.

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

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

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

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

Definition Classes: TraversableOnce → GenTraversableOnce

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

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

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

A1: Параметр типа для бинарного оператора, надтипом A.
op: Бинарный оператор, который должен быть ассоциативным.
returns: Значение-опцию, содержащее результат применения оператора сводки op между всеми элементами, если коллекция не пуста, и None в противном случае.

Definition Classes: TraversableOnce → GenTraversableOnce

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

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

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

B

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

op

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

returns

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

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

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

Definition Classes: TraversableOnce → GenTraversableOnce
Исключения: UnsupportedOperationException если этот итерируемый объект или итератор пуст.

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

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

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

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

Definition Classes: TraversableOnce → GenTraversableOnce

def remaining: Int

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

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

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

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

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

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

Definition Classes: Appended → IterableSplitter → RemainsIterator

def reversed: List[U]

Attributes: protected[this]
Definition Classes: TraversableOnce

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

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

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

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

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

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

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

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

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

B: тип элементов в результирующей коллекции
z: начальное значение
op: бинарный оператор, применяемый к промежуточному результату и элементу
returns: итератор с промежуточными результатами

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

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

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

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

B: тип элементов в результирующей коллекции
z: начальное значение
op: бинарный оператор, применяемый к промежуточному результату и элементу
returns: итератор с промежуточными результатами

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

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

Definition Classes: AugmentedIterableIterator

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

Definition Classes: AugmentedIterableIterator

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

Definition Classes: AugmentedIterableIterator

def seq: Iterator[U]

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

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

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

Definition Classes: Iterator → TraversableOnce → GenTraversableOnce

def setIndexFlag(f: Int): Unit

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

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

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

Definition Classes: DelegatedSignalling → Signalling

def setIndexFlagIfGreater(f: Int): Unit

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

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

Definition Classes: DelegatedSignalling → Signalling

def setIndexFlagIfLesser(f: Int): Unit

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

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]

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

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

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

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

Definition Classes: AugmentedIterableIterator

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

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

Attributes: protected
Definition Classes: Iterator

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

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

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

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

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

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

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

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

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

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

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

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

Definition Classes: AugmentedIterableIterator

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

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

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

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

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

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

Definition Classes: Appended → IterableSplitter → Splitter

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

Definition Classes: AugmentedIterableIterator

def splitWithSignalling: scala.Seq[IterableSplitter[U]]

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]

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

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

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

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

Definition Classes: AugmentedIterableIterator

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

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

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

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

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

Definition Classes: AugmentedIterableIterator

val that: PI

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

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

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

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

Definition Classes: TraversableOnce → GenTraversableOnce

def toIndexedSeq: immutable.IndexedSeq[U]

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

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

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

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

def toIterable: Iterable[U]

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

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

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

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

def toIterator: Iterator[U]

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

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

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

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

def toList: List[U]

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

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

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

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

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

[use case]

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

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

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

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

def toParArray: ParArray[T]

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

def toSeq: Seq[U]

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

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

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

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

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

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

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

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

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

def toStream: immutable.Stream[U]

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

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

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

def toString(): String

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

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

Definition Classes: Iterator → AnyRef → Any
Note: Повторное использование: итератор остается валидным для дальнейшего использования, независимо от возвращаемого результата.

def toTraversable: Traversable[U]

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

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

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

Definition Classes: Iterator → TraversableOnce → GenTraversableOnce

def toVector: Vector[U]

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

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

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

Definition Classes: TraversableOnce → GenTraversableOnce

final def wait(): Unit

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

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

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

final def wait(arg0: Long): Unit

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

def zipAll2combiner[U >: U, S, That](that: RemainsIterator[S], thiselem: U, thatelem: S, cb: Combiner[(U, S), That]): Combiner[(U, S), That]

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

def zipAllParSeq[S, U >: U, R >: S](that: SeqSplitter[S], thisElem: U, thatElem: R): ZippedAll[U, R]

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

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

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

def zipWithIndex: Iterator[(U, Int)]

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

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

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

def →[B](y: B): (Appended[U, PI], B)

Неявный: Этот член добавляется неявным преобразованием из Appended[U, PI] в ArrowAssoc[Appended[U, PI]] выполняемым методом ArrowAssoc в scala.Predef.
Определяющие классы: ArrowAssoc

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

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

Неявный

Этот член добавлен с помощью неявного преобразования из Appended[U, PI] в MonadOps[U] с помощью метода MonadOps в scala.collection.TraversableOnce.

Затенение

Этот неявно унаследованный член затенён одним или несколькими членами в этом классе.
Для доступа к этому члену можно использовать приведение типа:

(appended: MonadOps[U]).filter(p)

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

MonadOps

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

Неявный

Затенение

(appended: MonadOps[U]).flatMap(f)

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

MonadOps

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

Неявный

Затенение

(appended: MonadOps[U]).map(f)

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

MonadOps

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

Неявный

Затенение

(appended: MonadOps[U]).withFilter(p)

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

MonadOps

© 2002-2019 EPFL, with contributions from Lightbend.
Licensed under the Apache License, Version 2.0.
https://www.scala-lang.org/api/2.12.9/scala/collection/parallel/IterableSplitter$Appended.html