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

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

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

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

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

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

новый Mapped(f: (T) ⇒ S)

Члены типов

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

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

Типичные применения достигаются методами grouped и sliding.

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

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

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

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

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

класс Taken extends IterableSplitter[T]

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

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

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

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

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

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

final def !=(arg0: Any): Boolean

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

returns: true если !(this == that), в противном случае false.

Definition Classes: AnyRef → Any

final def ##(): Int

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

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

Definition Classes: AnyRef → Any

def +(other: String): String

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

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

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

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

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

Definition Classes: Iterator

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

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

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

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

Примечание: /: - альтернативный синтаксис для foldLeft; z /: xs - то же самое, что и xs foldLeft z.

Примеры:

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

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

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

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

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

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

B

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

z

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

op

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

returns

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

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

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

Definition Classes: TraversableOnce → GenTraversableOnce

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

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

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

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

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

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

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

Definition Classes: TraversableOnce → GenTraversableOnce

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

Definition Classes: IterableSplitter

final def asInstanceOf[T0]: T0

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

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

returns: объект-получатель.

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

def buffered: BufferedIterator[S]

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

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

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

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

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

def clone(): AnyRef

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

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

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

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

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

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

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

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

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

Definition Classes: AugmentedIterableIterator

def collectFirst[B](pf: PartialFunction[S, 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 >: S, Coll, Bld <: Builder[U, Coll]](b: Bld): Bld

Definition Classes: AugmentedIterableIterator

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

[use case]

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

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

xs: массив для заполнения.
start: начальный индекс.
len: максимальное количество копируемых элементов.

Definition Classes: AugmentedIterableIterator → Iterator → TraversableOnce → GenTraversableOnce

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

[use case]

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

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

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

Definition Classes: TraversableOnce → GenTraversableOnce

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

[use case]

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

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

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

Definition Classes: TraversableOnce → GenTraversableOnce

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

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

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

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

Definition Classes: TraversableOnce

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

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

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

Definition Classes: Iterator

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

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

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

Definition Classes: AugmentedIterableIterator → TraversableOnce → GenTraversableOnce

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

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

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

Definition Classes: IterableSplitter → Iterator

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

Definition Classes: AugmentedIterableIterator

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

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

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

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

def dup: IterableSplitter[S]

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

Definition Classes: Mapped → IterableSplitter

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

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

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

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

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

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

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

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

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

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

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

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

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

final def eq(arg0: AnyRef): Boolean

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

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

x

y

AnyRef

x.eq(y)

true

false

x

AnyRef

x.eq(null)

null.eq(x)

false

null.eq(null)

true

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

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

Definition Classes: AnyRef

def equals(arg0: Any): Boolean

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

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

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

Definition Classes: AnyRef → Any

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

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

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

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

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

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

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

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

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

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

Definition Classes: AugmentedIterableIterator

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

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

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

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

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

Definition Classes: AugmentedIterableIterator

def finalize(): Unit

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

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

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

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

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

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

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

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

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

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

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

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

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

Definition Classes: AugmentedIterableIterator

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

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

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

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

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

Definition Classes: AugmentedIterableIterator → TraversableOnce → GenTraversableOnce

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

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

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

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

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

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

[use case]

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

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

Definition Classes: Iterator → TraversableOnce → GenTraversableOnce

def formatted(fmtstr: String): String

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

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

final def getClass(): Class[_]

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

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

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

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

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

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

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

def hasDefiniteSize: Boolean

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

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

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

def hasNext: Boolean

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

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

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

def hashCode(): Int

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

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

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

def indexFlag: Int

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

def isAborted: Boolean

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

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

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

Definition Classes: DelegatedSignalling → Signalling

def isEmpty: Boolean

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

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

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

final def isInstanceOf[T0]: Boolean

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

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

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

Definition Classes: Any

def isRemainingCheap: Boolean

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

Definition Classes: RemainsIterator

def isTraversableAgain: Boolean

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

returns: false

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

def length: Int

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

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

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

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

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

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

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

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

Definition Classes: AugmentedIterableIterator

def max: A

[случай использования]

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

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

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

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

[случай использования]

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

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

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

def min: A

[случай использования]

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

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

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

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

[случай использования]

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

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

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

def mkString: String

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

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

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

def mkString(sep: String): String

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

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

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

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

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

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

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

final def ne(arg0: AnyRef): Boolean

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

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

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

def next(): S

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

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

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

[use case]

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

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

Definition Classes: Iterator

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

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

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

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

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

Definition Classes: AugmentedIterableIterator

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

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

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

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

Definition Classes: AugmentedIterableIterator → TraversableOnce → GenTraversableOnce
Exceptions thrown: UnsupportedOperationException, если этот итерируемый объект или итератор пуст.

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

Definition Classes: AugmentedIterableIterator

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

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

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

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

B

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

op

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

returns

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

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

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

Definition Classes: TraversableOnce
Exceptions thrown: UnsupportedOperationException, если этот итерируемый объект или итератор пуст.

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

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

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

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

Definition Classes: TraversableOnce → GenTraversableOnce

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

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

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

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

Definition Classes: TraversableOnce → GenTraversableOnce

def reduceRight[B >: S](op: (S, 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
Exceptions thrown: UnsupportedOperationException если этот итерируемый объект или итератор пуст.

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

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

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

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

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

Definition Classes: TraversableOnce → GenTraversableOnce

def remaining: Int

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

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

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

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

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

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

Definition Classes: Mapped → IterableSplitter → RemainsIterator

def reversed: List[S]

Attributes: protected[this]
Definition Classes: TraversableOnce

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Definition Classes: AugmentedIterableIterator

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

Definition Classes: AugmentedIterableIterator

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

Definition Classes: AugmentedIterableIterator

def seq: Iterator[S]

A version of this collection with all of the operations implemented sequentially (i.e., in a single-threaded manner).

This method returns a reference to this collection. In parallel collections, it is redefined to return a sequential implementation of this collection. In both cases, it has O(1) complexity.

returns: a sequential view of the collection.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Definition Classes: Mapped → IterableSplitter → Splitter

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

Definition Classes: AugmentedIterableIterator

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

Definition Classes: IterableSplitter

def sum: A

[use case]

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

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

Definition Classes: AugmentedIterableIterator → TraversableOnce → GenTraversableOnce

final def synchronized[T0](arg0: ⇒ T0): T0

Definition Classes: AnyRef

def tag: Int

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

Definition Classes: DelegatedSignalling → Signalling

def take(n: Int): IterableSplitter[S]

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

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

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

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

Definition Classes: AugmentedIterableIterator

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

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

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

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

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

Definition Classes: AugmentedIterableIterator

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

[use case]

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

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

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

Definition Classes: TraversableOnce → GenTraversableOnce

def toArray: Array[A]

[use case]

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

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

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

Definition Classes: TraversableOnce → GenTraversableOnce

def toBuffer[B >: S]: Buffer[B]

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

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

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

Definition Classes: TraversableOnce → GenTraversableOnce

def toIndexedSeq: immutable.IndexedSeq[S]

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

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

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

Definition Classes: TraversableOnce → GenTraversableOnce

def toIterable: Iterable[S]

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

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

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

Definition Classes: TraversableOnce → GenTraversableOnce

def toIterator: Iterator[S]

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

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

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

Definition Classes: Iterator → GenTraversableOnce

def toList: List[S]

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

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

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

Definition Classes: TraversableOnce → GenTraversableOnce

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

[use case]

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

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

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

Definition Classes: TraversableOnce → GenTraversableOnce

def toParArray: ParArray[T]

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

def toSeq: Seq[S]

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

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

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

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

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

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

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

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

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

def toStream: immutable.Stream[S]

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

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

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

def toString(): String

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

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

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

def toTraversable: Traversable[S]

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

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

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

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

def toVector: Vector[S]

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

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

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

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

final def wait(): Unit

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

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

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

final def wait(arg0: Long): Unit

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Неявный

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

Затенение

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

(mapped: MonadOps[S]).filter(p)

Definition Classes

MonadOps

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

Неявный

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

Затенение

(mapped: MonadOps[S]).flatMap(f)

Definition Classes

MonadOps

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

Неявный

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

Затенение

(mapped: MonadOps[S]).map(f)

Definition Classes

MonadOps

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

Неявный

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

Затенение

(mapped: MonadOps[S]).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$Mapped.html