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

класс Taken extends IterableSplitter[T]

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

Линейные надтипы

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

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

новый Taken(taken: Int)

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

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

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

возвращает: true если !(this == that), иначе false.

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

final def ##(): Int

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

возвращает: хэш-значение, согласованное с ==

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

def +(other: String): String

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

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

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

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

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

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

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

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

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

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

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

Примеры:

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

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

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

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

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

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

B

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

z

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

op

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

возвращает

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

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

где x₁, ..., x_n — элементы этого traversable или iterator.

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

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

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

Примечание: :\ — это альтернативная синтаксическая конструкция для 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

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

возвращает

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

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

где x₁, ..., x_n — элементы этого traversable или iterator.

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

final def ==(arg0: Any): Boolean

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

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

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

def abort(): Unit

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

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

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

def addString(b: StringBuilder): StringBuilder

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

Пример:

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

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

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

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

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

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

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

Пример:

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

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

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

b: строковый буфер, в который добавляются элементы.
sep: разделительная строка.
возвращает: строковый буфер b, в который были добавлены элементы.

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

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

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

Пример:

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

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

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

b: строковый буфер, в который добавляются элементы.
start: начальная строка.
sep: разделительная строка.
end: конечная строка.
возвращает: строковый буфер b, в который были добавлены элементы.

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

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

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

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

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

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

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

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

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

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

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

final def asInstanceOf[T0]: T0

Приводит объект-получатель к типу T0.

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

возвращает: объект-получатель.

Определяющие классы: Any
Исключения: ClassCastException, если объект-получатель не является экземпляром стирания типа T0.

def buffered: BufferedIterator[T]

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

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

Definition Classes: Iterator
Note: Переиспользование: после вызова этого метода следует удалить итератор, на котором он был вызван, и использовать только возвращённый итератор. Использование старого итератора не определено, может измениться и может привести к изменениям в новом итераторе.
See also: 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
Annotations: @throws( ... ) @native()
Note: не указано SLS как член AnyRef

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

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

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

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

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

Definition Classes: AugmentedIterableIterator

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

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

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

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

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

Definition Classes: TraversableOnce

def contains(elem: Any): Boolean

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

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

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

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

def copy2builder[U >: T, 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 → Итератор → TraversableOnce → GenTraversableOnce

def copyToArray(xs: Массив[A]): Unit

[use case]

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

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

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

Definition Classes: TraversableOnce → GenTraversableOnce

def copyToArray(xs: Массив[A], start: Int): Unit

[use case]

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

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

xs: массив для заполнения.
start: начальный индекс.

Definition Classes: TraversableOnce → GenTraversableOnce

def copyToBuffer[B >: T](dest: Буфер[B]): Unit

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

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

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

Definition Classes: TraversableOnce

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

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

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

Definition Classes: Итератор

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

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

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

Definition Classes: AugmentedIterableIterator → TraversableOnce → GenTraversableOnce

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

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

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

Definition Classes: IterableSplitter → Итератор

def drop2combiner[U >: T, This](n: Int, cb: Комбинатор[U, This]): Комбинатор[U, This]

Definition Classes: AugmentedIterableIterator

def dropWhile(p: (T) ⇒ Boolean): Итератор[T]

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

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

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

def dup: IterableSplitter[T]

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

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

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

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

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

возвращает: пара итераторов

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

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

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

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

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

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

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

def ensuring(cond: Boolean): Taken

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

final def eq(arg0: AnyRef): Boolean

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

Метод eq реализует отношение эквивалентности на не-null экземплярах 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: (T) ⇒ Boolean): Boolean

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

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

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

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

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

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

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

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

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

Definition Classes: AugmentedIterableIterator

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Definition Classes: AugmentedIterableIterator

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

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

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

B

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

z

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

op

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

returns

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

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

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

Definition Classes: TraversableOnce → GenTraversableOnce

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

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

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

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

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

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

[use case]

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

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

Definition Classes: Iterator → TraversableOnce → GenTraversableOnce

def formatted(fmtstr: String): String

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

Неявный: Этот член добавлен неявным преобразованием из Taken в StringFormat[Taken] выполненным методом StringFormat в scala.Predef.
Классы-определения: StringFormat
Аннотации: @inline()

final def getClass(): Class[_]

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

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

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

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

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

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

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

def hasDefiniteSize: Boolean

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

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

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

def hasNext: Boolean

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

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

Классы-определения: Taken → 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](elem: B, from: Int): Int

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

def isAborted: Boolean

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

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

returns: состояние отмены

Definition Classes: DelegatedSignalling → Signalling

def isEmpty: Boolean

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

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

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

final def isInstanceOf[T0]: Boolean

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

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

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

Definition Classes: Any

def isRemainingCheap: Boolean

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

Definition Classes: RemainsIterator

def isTraversableAgain: Boolean

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

returns: false

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

def length: Int

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

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

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

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

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

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

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

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

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

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

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

def nonEmpty: Boolean

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

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

Definition Classes: TraversableOnce → GenTraversableOnce

final def notify(): Unit

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

Definition Classes: AnyRef
Annotations: @native()
Note: не указано SLS как член AnyRef

final def notifyAll(): Unit

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

Definition Classes: AnyRef
Annotations: @native()
Note: не указано SLS как член AnyRef

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

[use case]

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

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

Definition Classes: Iterator

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

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

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

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

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

Definition Classes: AugmentedIterableIterator

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

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

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

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

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

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

Definition Classes: AugmentedIterableIterator

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

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

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

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

B

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

op

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

возвращает

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

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

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

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

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

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

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

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

Definition Classes: TraversableOnce → GenTraversableOnce

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

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

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

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

Definition Classes: TraversableOnce → GenTraversableOnce

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

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

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

B

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

op

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

возвращает

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

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

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

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

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

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

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

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

Definition Classes: TraversableOnce → GenTraversableOnce

var remaining: Int

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

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

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

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

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

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

Definition Classes: Taken → IterableSplitter → RemainsIterator

def reversed: List[T]

Attributes: protected[this]
Definition Classes: TraversableOnce

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Definition Classes: AugmentedIterableIterator

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

Definition Classes: AugmentedIterableIterator

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

Definition Classes: AugmentedIterableIterator

def seq: Iterator[T]

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

Этот метод возвращает ссылку на эту коллекцию. В параллельных коллекциях он переопределяется для возвращения последовательной реализации этой коллекции. В обоих случаях сложность составляет 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

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

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

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

возвращает: количество элементов в этом наборе или итераторе, или -1, если размер нельзя определить недорого

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

def slice(from1: Int, until1: Int): IterableSplitter[T]

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

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

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

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

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

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

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

Атрибуты: protected
Определяющие классы: Iterator

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Definition Classes: Taken → IterableSplitter → Splitter

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

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

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

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

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

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

Definition Classes: AugmentedIterableIterator

def takeSeq[PI <: IterableSplitter[T]](sq: scala.Seq[PI])(taker: (PI, Int) ⇒ PI): Seq[PI]

Attributes: protected[this]

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

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

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

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

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

Definition Classes: AugmentedIterableIterator

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

[use case]

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

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

Col: Тип коллекции для построения.
returns: новая коллекция, содержащая все элементы этого итерационного или проходного множества.

Definition Classes: TraversableOnce → GenTraversableOnce

def toArray: Массив[A]

[use case]

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

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

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

Definition Classes: TraversableOnce → GenTraversableOnce

def toBuffer[B >: T]: Буфер[B]

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

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

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

Definition Classes: TraversableOnce → GenTraversableOnce

def toIndexedSeq: Неизменяемая.ПоследовательностьИндексов[T]

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

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

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

Definition Classes: TraversableOnce → GenTraversableOnce

def toIterable: Итерируемый[T]

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

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

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

Definition Classes: TraversableOnce → GenTraversableOnce

def toIterator: Итератор[T]

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

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

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

Definition Classes: Итератор → GenTraversableOnce

def toList: Список[T]

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

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

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

Definition Classes: TraversableOnce → GenTraversableOnce

def toMap[T, U]: Карта[T, U]

[use case]

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

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

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

Definition Classes: TraversableOnce → GenTraversableOnce

def toParArray: ParArray[T]

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

def toSeq: Seq[T]

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

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

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

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

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

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

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

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

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

def toStream: immutable.Stream[T]

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

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

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

def toString(): String

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

возвращает: "<iterator>" пустой ли итератор.

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

def toTraversable: Traversable[T]

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

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

возвращает: Перечислимое, содержащее все элементы этого перечислимого или итератора.

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

def toVector: Vector[T]

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Implicit

Этот член добавляется неявным преобразованием из Taken в MonadOps[T] посредством метода MonadOps в scala.collection.TraversableOnce.

Затенение

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

(taken: MonadOps[T]).filter(p)

Definition Classes

MonadOps

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

Implicit

Этот член добавляется неявным преобразованием из Taken в MonadOps[T] посредством метода MonadOps в scala.collection.TraversableOnce.

Затенение

(taken: MonadOps[T]).flatMap(f)

Definition Classes

MonadOps

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

Implicit

Этот член добавляется неявным преобразованием из Taken в MonadOps[T] посредством метода MonadOps в scala.collection.TraversableOnce.

Затенение

(taken: MonadOps[T]).map(f)

Definition Classes

MonadOps

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

Implicit

Этот член добавляется неявным преобразованием из Taken в MonadOps[T] посредством метода MonadOps в scala.collection.TraversableOnce.

Затенение

(taken: MonadOps[T]).withFilter(p)

Definition Classes

MonadOps

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