Класс scala.collection.parallel.ParSeqLike.Elements
абстрактный класс Elements extends SeqSplitter[T] with scala.BufferedIterator[T]
Типовые члены
класс GroupedIterator[B >: A] extends AbstractIterator[Seq[B]] with Iterator[Seq[B]]
Гибкий итератор для преобразования Iterator[A] в Iterator[Seq[A]], с настраиваемым размером последовательности, шагом и стратегией обработки элементов, которые не подходят равномерно.
Типичные использования достигаются методами grouped и sliding.
- Определения классов
- Iterator
класс Appended[U >: T, PI <: SeqSplitter[U]] extends SeqSplitter.Appended[U, PI] with SeqSplitter[U]
- Определения классов
- SeqSplitter
класс Mapped[S] extends SeqSplitter.Mapped[S] with SeqSplitter[S]
- Определения классов
- SeqSplitter
класс Patched[U >: T] extends SeqSplitter[U]
- Определения классов
- SeqSplitter
класс Taken extends SeqSplitter.Taken with SeqSplitter[T]
- Определения классов
- SeqSplitter
класс Zipped[S] extends SeqSplitter.Zipped[S] with SeqSplitter[(T, S)]
- Определения классов
- SeqSplitter
класс ZippedAll[U >: T, S] extends SeqSplitter.ZippedAll[U, S] with SeqSplitter[(U, S)]
- Определения классов
- SeqSplitter
Члены-значения
final def !=(arg0: Any): Boolean
Проверка двух объектов на неравенство.
- возвращает
true, если !(this == that), иначе false.
- Definition Classes
- AnyRef → Any
final def ##(): Int
Эквивалентно x.hashCode, за исключением упакованных числовых типов и null. Для числовых типов возвращает хэш-значение, согласованное с равенством значений: если два экземпляра типа значения сравниваются как true, то ## вернёт одинаковое хэш-значение для каждого из них. Для null возвращает хэш-код, где null.hashCode вызывает NullPointerException.
- возвращает
хэш-значение, согласованное с ==
- Definition Classes
- AnyRef → Any
def +(other: String): String
- Неявный
- Этот член добавлен неявным преобразованием из Elements в any2stringadd[Elements] посредством метода any2stringadd в scala.Predef.
- Definition Classes
- any2stringadd
def ++(that: ⇒ Iterator[T]): Iterator[T]
Конкатенация данного итератора с другим.
- that
другой итератор
- возвращает
новый итератор, который сначала выводит значения, генерируемые этим итератором, а затем значения, генерируемые итератором
that.
- Definition Classes
- Iterator
def ->[B](y: B): (Elements, B)
- Неявный
- Этот член добавлен неявным преобразованием из Elements в ArrowAssoc[Elements] посредством метода ArrowAssoc в scala.Predef.
- Definition Classes
- ArrowAssoc
- Аннотации
- @inline()
def /:[B](z: B)(op: (B, T) ⇒ 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
бинарный оператор.
- возвращает
-
результат вставки
opмежду последовательными элементами данного перечислимого или итератора слева направо с начальным значениемzслева:op(...op(op(z, x_1), x_2), ..., x_n)
где
x1, ..., xn— это элементы данного перечислимого или итератора.
- Definition Classes
- TraversableOnce → GenTraversableOnce
def :\[B](z: B)(op: (T, B) ⇒ B): B
Применение бинарного оператора ко всем элементам данного перечислимого или итератора и начальному значению справа налево.
Примечание: :\ — это альтернативная синтаксическая конструкция для foldRight; xs :\ z эквивалентно xs foldRight z.
Примечание: не будет завершаться для бесконечных коллекций.
Примечание: может возвращать разные результаты при разных запусках, если тип коллекции не упорядочен или оператор не ассоциативен и не коммутативен.
Примеры:
Обратите внимание, что функция свертки, используемая для вычисления b, эквивалентна функции свертки, используемой для вычисления c.
scala> val a = List(1,2,3,4) a: List[Int] = List(1, 2, 3, 4) scala> val b = (a :\ 5)(_+_) b: Int = 15 scala> val c = (a :\ 5)((x,y) => x + y) c: Int = 15
- B
тип результата бинарного оператора.
- z
начальное значение
- op
бинарный оператор
- возвращает
-
результат вставки
opмежду последовательными элементами данного перечислимого или итератора справа налево с начальным значениемzсправа:op(x_1, op(x_2, ... op(x_n, z)...))
где
x1, ..., xn— это элементы данного перечислимого или итератора.
- Definition Classes
- TraversableOnce → GenTraversableOnce
final def ==(arg0: Any): Boolean
Выражение x == that эквивалентно if (x eq null) that eq null else x.equals(that).
- возвращает
true, если объект-получатель эквивалентен аргументу;falseв противном случае.
- Definition Classes
- AnyRef → Any
def abort(): Unit
Отправляет сигнал прерывания другим рабочим процессам.
Флаг прерывания, установленный в значение true, означает, что рабочий процесс может прерваться и произвести любой результат, поскольку его результат не повлияет на окончательный результат вычисления. Примерами операций, использующих это, являются методы find, forall и exists.
- Definition Classes
- DelegatedSignalling → Signalling
def addString(b: StringBuilder): StringBuilder
Добавляет все элементы этого итерируемого объекта или итератора в строковый буфер. Записываемый текст состоит из строковых представлений (относительно метода toString) всех элементов этого итерируемого объекта или итератора без разделительной строки.
Пример:
scala> val a = List(1,2,3,4) a: List[Int] = List(1, 2, 3, 4) scala> val b = new StringBuilder() b: StringBuilder = scala> val h = a.addString(b) h: StringBuilder = 1234
- b
строковый буфер, в который добавляются элементы.
- returns
строковый буфер
b, в который были добавлены элементы.
- Definition Classes
- TraversableOnce
def addString(b: StringBuilder, sep: String): StringBuilder
Добавляет все элементы этого итерируемого объекта или итератора в строковый буфер с использованием разделительной строки. Записываемый текст состоит из строковых представлений (относительно метода toString) всех элементов этого итерируемого объекта или итератора, разделенных строкой sep.
Пример:
scala> val a = List(1,2,3,4) a: List[Int] = List(1, 2, 3, 4) scala> val b = new StringBuilder() b: StringBuilder = scala> a.addString(b, ", ") res0: StringBuilder = 1, 2, 3, 4
- b
строковый буфер, в который добавляются элементы.
- sep
разделительная строка.
- returns
строковый буфер
b, в который были добавлены элементы.
- Definition Classes
- TraversableOnce
def addString(b: StringBuilder, start: String, sep: String, end: String): StringBuilder
Добавляет все элементы этого итерируемого объекта или итератора в строковый буфер с использованием начальной, конечной и разделительных строк. Записываемый текст начинается со строки start и заканчивается строкой end. Внутри строковые представления (относительно метода toString) всех элементов этого итерируемого объекта или итератора разделены строкой sep.
Пример:
scala> val a = List(1,2,3,4)
a: List[Int] = List(1, 2, 3, 4)
scala> val b = new StringBuilder()
b: StringBuilder =
scala> a.addString(b , "List(" , ", " , ")")
res5: StringBuilder = List(1, 2, 3, 4)
- b
строковый буфер, в который добавляются элементы.
- start
начальная строка.
- sep
разделительная строка.
- end
конечная строка.
- returns
строковый буфер
b, в который были добавлены элементы.
- Definition Classes
- TraversableOnce
def aggregate[B](z: ⇒ B)(seqop: (B, T) ⇒ B, combop: (B, B) ⇒ B): B
Агрегирует результаты применения оператора к последующим элементам.
Это более общий вид fold и reduce. Он похож на foldLeft тем, что не требует, чтобы результат был супертипом типа элемента. Кроме того, он позволяет обрабатывать параллельные коллекции частями, а затем объединять промежуточные результаты.
aggregate разбивает итерируемый объект или итератор на разделы и обрабатывает каждый раздел последовательным применением seqop, начиная с z (как foldLeft). Затем эти промежуточные результаты объединяются с помощью combop (как fold). Реализация этой операции может работать с произвольным количеством разделов коллекции (даже с 1), поэтому combop может вызываться произвольное количество раз (даже 0).
В качестве примера рассмотрим суммирование целочисленных значений списка символов. Начальное значение для суммы равно 0. Во-первых, seqop преобразует каждый входной символ в целое число и добавляет его к сумме (раздела). Затем combop просто суммирует промежуточные результаты разделов:
List('a', 'b', 'c').aggregate(0)({ (sum, ch) => sum + ch.toInt }, { (p1, p2) => p1 + p2 })
- B
тип накапливаемых результатов
- z
начальное значение для накапливаемого результата раздела - обычно это нейтральный элемент для оператора
seqop(например,Nilдля конкатенации списков или0для суммирования) и может быть вычислен более одного раза- seqop
оператор, используемый для накопления результатов в пределах раздела
- combop
ассоциативный оператор, используемый для объединения результатов из разных разделов
- Definition Classes
- TraversableOnce → GenTraversableOnce
def appendParIterable[U >: T, PI <: IterableSplitter[U]](that: PI): Elements.Appended[U, PI]
- Definition Classes
- IterableSplitter
def appendParSeq[U >: T, PI <: SeqSplitter[U]](that: PI): Appended[U, PI]
- Definition Classes
- SeqSplitter
final def asInstanceOf[T0]: T0
Преобразовать текущий объект к типу T0.
Обратите внимание, что успешность преобразования во время выполнения зависит от семантики стирания типов Scala. Поэтому выражение 1.asInstanceOf[String] бросит исключение ClassCastException во время выполнения, в то время как выражение List(1).asInstanceOf[List[String]] не бросит. В последнем примере, поскольку тип аргумента стирается во время компиляции, невозможно проверить, соответствуют ли содержимое списка требуемому типу.
- returns
текущий объект.
- Definition Classes
- Any
- Исключения
ClassCastException, если текущий объект не является экземпляром стираемого типаT0.
def buffered: Elements.this.type
Создаёт буферизованный итератор из этого итератора.
- returns
буферизованный итератор, генерирующий те же значения, что и этот итератор.
- Definition Classes
- BufferedIterator → Iterator
- Примечание
Переиспользование: После вызова этого метода, старый итератор следует удалить, используя только возвращённый. Использование старого итератора является неопределённым, может меняться и может привести к изменениям в новом итераторе.
- См. также
def buildString(closure: ((String) ⇒ Unit) ⇒ Unit): String
- Атрибуты
- protected
- Definition Classes
- IterableSplitter
def clone(): AnyRef
Создаёт копию текущего объекта.
По умолчанию реализация метода clone зависит от платформы.
- returns
копия текущего объекта.
def collect[B](pf: PartialFunction[T, B]): Iterator[B]
Создаёт итератор, преобразуя значения, полученные от этого итератора с помощью частичной функции, отбрасывая те значения, для которых частичная функция не определена.
- pf
частичная функция, которая фильтрует и преобразует итератор.
- returns
новый итератор, который возвращает каждое значение
x, полученное от этого итератора, для которогоpfопределена, и изображениеpf(x).
- Definition Classes
- Iterator
- Аннотации
- @migration
- Миграция
(Изменено в версии 2.8.0)
collectизменилось. Предыдущее поведение может быть воспроизведено с помощьюtoSeq.- Примечание
Переиспользование: После вызова этого метода, старый итератор следует удалить, используя только возвращённый. Использование старого итератора является неопределённым, может меняться и может привести к изменениям в новом итераторе.
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
Seq("a", 1, 5L).collectFirst({ case x: Int => x*10 }) = Some(10)
def contains(elem: Any): Boolean
Проверяет, содержит ли этот итератор заданное значение в качестве элемента.
Примечание: может не завершаться для бесконечных итераторов.
- elem
тестируемый элемент.
- returns
true, если этот итератор генерирует некоторое значение, равное (определяется==)elem,falseв противном случае.
- Definition Classes
- Iterator
- Примечание
Переиспользование: После вызова этого метода, старый итератор следует удалить. Использование старого итератора является неопределённым и может измениться.
def copy2builder[U >: T, Coll, Bld <: Builder[U, Coll]](b: Bld): Bld
- Definition Classes
- AugmentedIterableIterator
def copyToArray(xs: Array[A], start: Int, len: Int): Unit
Копирует выбранные значения, полученные из этого итератора, в массив. Заполняет заданный массив xs, начиная с индекса start, максимум len значениями, полученными из этого итератора. Копирование прекратится, как только будет достигнут конец текущего итератора, конец массива или len элементов были скопированы.
Примечание: не будет завершаться для бесконечных итераторов.
- xs
массив, который нужно заполнить.
- start
начальный индекс.
- len
максимальное количество копируемых элементов.
- Definition Classes
- AugmentedIterableIterator → Iterator → TraversableOnce → GenTraversableOnce
def copyToArray(xs: Array[A]): Unit
Копирует элементы этого перебираемого объекта или итератора в массив. Заполняет заданный массив xs значениями этого перебираемого объекта или итератора. Копирование прекратится, как только будет достигнут конец текущего перебираемого объекта или итератора, или конец целевого массива.
Примечание: не будет завершаться для бесконечных итераторов.
- xs
массив, который нужно заполнить.
- Definition Classes
- TraversableOnce → GenTraversableOnce
def copyToArray(xs: Array[A], start: Int): Unit
Копирует элементы этого перебираемого объекта или итератора в массив. Заполняет заданный массив xs значениями этого перебираемого объекта или итератора, начиная с индекса start. Копирование прекратится, как только будет достигнут конец текущего перебираемого объекта или итератора, или конец целевого массива.
Примечание: не будет завершаться для бесконечных итераторов.
- xs
массив, который нужно заполнить.
- start
начальный индекс.
- Definition Classes
- TraversableOnce → GenTraversableOnce
def copyToBuffer[B >: T](dest: Buffer[B]): Unit
Копирует все элементы этого перебираемого объекта или итератора в буфер.
Примечание: не будет завершаться для коллекций бесконечного размера.
- dest
Буфер, в который копируются элементы.
- Definition Classes
- TraversableOnce
def corresponds[S](corr: (T, S) ⇒ Boolean)(that: scala.Iterator[S]): Boolean
- Definition Classes
- AugmentedSeqIterator
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
- Iterator
def count(p: (T) ⇒ Boolean): Int
Считает количество элементов в перебираемом объекте или итераторе, которые удовлетворяют предикату.
- p
предикат для проверки элементов.
- returns
количество элементов, удовлетворяющих предикату
p.
- Definition Classes
- AugmentedIterableIterator → TraversableOnce → GenTraversableOnce
def drop(n: Int): IterableSplitter[T]
Удаление реализовано как простое жадное потребление.
- n
количество элементов для удаления
- возвращает
итератор, который генерирует все значения текущего итератора, за исключением первых
nзначений.
- Определяющие классы
- IterableSplitter → Iterator
def drop2combiner[U >: T, This](n: Int, cb: Combiner[U, This]): Combiner[U, This]
- Определяющие классы
- AugmentedIterableIterator
def dropWhile(p: (T) ⇒ Boolean): Iterator[T]
Пропускает самую длинную последовательность элементов этого итератора, которые удовлетворяют заданному предикату p, и возвращает итератор оставшихся элементов.
- p
предикат, используемый для пропуска элементов.
- возвращает
итератор, состоящий из оставшихся элементов
- Определяющие классы
- Iterator
- Примечание
Переиспользование: После вызова этого метода следует удалить вызываемый итератор и использовать только возвращенный итератор. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новом итераторе также.
def dup: Elements
Создает копию этого итератора.
- Определяющие классы
- Elements → SeqSplitter → IterableSplitter
def duplicate: (Iterator[T], Iterator[T])
Создает два новых итератора, которые оба итерируются по тем же элементам, что и этот итератор (в том же порядке). Дублирующие итераторы считаются равными, если они находятся на том же элементе.
Учитывая, что большинство методов итераторов сделают исходный итератор непригодным для дальнейшего использования, этот метод предоставляет надежный способ вызова нескольких таких методов на итераторе.
- возвращает
пара итераторов
- Определяющие классы
- Iterator
- Примечание
-
Реализация может выделять временное хранилище для элементов, перебираемых одним итератором, но еще не другим.
,Переиспользование: После вызова этого метода следует удалить вызываемый итератор и использовать только возвращенные итераторы. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новых итераторах также.
val end: Int
def ensuring(cond: (Elements) ⇒ Boolean, msg: ⇒ Any): Elements
- Неявный
- Этот член добавлен неявным преобразованием из Elements в Ensuring[Elements] выполняемым методом Ensuring в scala.Predef.
- Определяющие классы
- Ensuring
def ensuring(cond: (Elements) ⇒ Boolean): Elements
- Неявный
- Этот член добавлен неявным преобразованием из Elements в Ensuring[Elements] выполняемым методом Ensuring в scala.Predef.
- Определяющие классы
- Ensuring
def ensuring(cond: Boolean, msg: ⇒ Any): Elements
- Неявный
- Этот член добавлен неявным преобразованием из Elements в Ensuring[Elements] выполняемым методом Ensuring в scala.Predef.
- Определяющие классы
- Ensuring
def ensuring(cond: Boolean): Elements
- Неявный
- Этот член добавлен неявным преобразованием из Elements в Ensuring[Elements] выполняемым методом Ensuring в scala.Predef.
- Определяющие классы
- Ensuring
final def eq(arg0: AnyRef): Boolean
Проверяет, является ли аргумент (that) ссылкой на объект-получатель (this).
Метод eq реализует отношение эквивалентности на не-null экземплярах AnyRef и имеет три дополнительных свойства:
-
Он согласован: для любых не-null экземпляров
x и y типа AnyRef, многократные вызовы x.eq(y) последовательно возвращают true или последовательно возвращают false. Для любого не-null экземпляра 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.
- Определяющие классы
- Iterator → TraversableOnce → GenTraversableOnce
- Примечание
Повторное использование: после вызова этого метода итератор, на котором он был вызван, следует удалить. Использование его является неопределённым и может быть изменено.
def filter(p: (T) ⇒ Boolean): Iterator[T]
Возвращает итератор по всем элементам этого итератора, удовлетворяющим предикату p. Порядок элементов сохраняется.
- p
предикат для проверки значений.
- возвращает
итератор, который генерирует те значения из этого итератора, которые удовлетворяют предикату
p.
- Определяющие классы
- Iterator
- Примечание
Повторное использование: после вызова этого метода итератор, на котором он был вызван, следует удалить. Использовать старый итератор неопределённо, может быть изменено, и может привести к изменениям в новом итераторе тоже.
def filter2combiner[U >: T, This](pred: (T) ⇒ Boolean, cb: Combiner[U, This]): Combiner[U, This]
- Определяющие классы
- AugmentedIterableIterator
def filterNot(p: (T) ⇒ Boolean): Iterator[T]
Создаёт итератор по всем элементам этого итератора, которые не удовлетворяют предикату p.
- p
предикат для проверки значений.
- возвращает
итератор, который генерирует те значения из этого итератора, которые не удовлетворяют предикату
p.
- Определяющие классы
- Iterator
- Примечание
Повторное использование: после вызова этого метода итератор, на котором он был вызван, следует удалить. Использовать старый итератор неопределённо, может быть изменено, и может привести к изменениям в новом итераторе тоже.
def filterNot2combiner[U >: T, This](pred: (T) ⇒ Boolean, cb: Combiner[U, This]): Combiner[U, This]
- Определяющие классы
- AugmentedIterableIterator
def finalize(): Unit
Вызывается сборщиком мусора для объекта-получателя, когда к объекту больше нет ссылок.
Детали вызова метода finalize, а также взаимодействие между finalize и нелокальными возвратами и исключениями зависят от платформы.
- Атрибуты
- protected[lang]
- Определяющие классы
- AnyRef
- Аннотации
- @throws( classOf[java.lang.Throwable] )
- Примечание
не указано SLS как член AnyRef
def find(p: (T) ⇒ Boolean): Option[T]
Находит первое значение, производимое итератором, удовлетворяющее предикату, если таковое есть.
Примечание: может не завершаться для бесконечных итераторов.
- p
предикат, используемый для проверки значений.
- возвращает
значение типа Option, содержащее первое значение, производимое итератором, которое удовлетворяет предикату
p, илиNone, если таковое не существует.
- Определяющие классы
- Iterator → TraversableOnce → GenTraversableOnce
- Примечание
Переиспользование: После вызова этого метода нужно отказаться от итератора, на котором он был вызван. Его использование неопределено и может быть изменено.
def flatMap[B](f: (T) ⇒ GenTraversableOnce[B]): Iterator[B]
Создает новый итератор, применяя функцию ко всем значениям, производимым этим итератором, и конкатенируя результаты.
- f
функция, применяемая к каждому элементу.
- возвращает
итератор, полученный путём применения заданной функции, возвращающей итератор
f, к каждому значению, производимому этим итератором, и конкатенации результатов.
- Определяющие классы
- Iterator
- Примечание
Переиспользование: После вызова этого метода необходимо отказаться от итератора, на котором он был вызван, и использовать только возвращённый итератор. Использование старого итератора неопределенно, может быть изменено и может привести к изменениям в новом итераторе.
def flatmap2combiner[S, That](f: (T) ⇒ GenTraversableOnce[S], cb: Combiner[S, That]): Combiner[S, That]
- Определяющие классы
- AugmentedIterableIterator
def fold[U >: T](z: U)(op: (U, U) ⇒ U): U
Вычисляет результирующее значение по всем элементам этого итерируемого объекта, используя заданный ассоциативный бинарный оператор.
Порядок выполнения операций над элементами не определён и может быть не детерминированным.
Примечание: не завершится для бесконечных итераторов.
- z
нейтральный элемент для операции свёртки; может быть добавлен к результату произвольное количество раз, и не должен менять результат (например,
Nilдля конкатенации списков, 0 для сложения или 1 для умножения).- op
бинарный оператор, который должен быть ассоциативным.
- возвращает
результат применения оператора свёртки
opмежду всеми элементами иz, илиz, если этот итерируемый объект пуст.
- Определяющие классы
- AugmentedIterableIterator → TraversableOnce → GenTraversableOnce
def foldLeft[B](z: B)(op: (B, T) ⇒ B): B
Применяет бинарный оператор к начальному значению и всем элементам этого итерируемого объекта слева направо.
Примечание: не завершится для бесконечно больших коллекций.
Примечание: может возвращать разные результаты для разных запусков, если тип базовой коллекции не упорядочен или оператор не является ассоциативным и коммутативным.
- B
тип результата бинарного оператора.
- z
начальное значение.
- op
бинарный оператор.
- возвращает
-
результат вставки
opмежду последовательными элементами этого итерируемого объекта слева направо с начальным значениемzслева:op(...op(z, x_1), x_2, ..., x_n)
где
x1, ..., xn— элементы этого итерируемого объекта. Возвращаетz, если этот итерируемый объект пуст.
- Определяющие классы
- TraversableOnce → GenTraversableOnce
def foldRight[B](z: B)(op: (T, B) ⇒ B): B
Применяет бинарный оператор ко всем элементам этого итерируемого объекта и начальному значению, справа налево.
Примечание: не завершится для бесконечно больших коллекций.
Примечание: может возвращать разные результаты для разных запусков, если тип базовой коллекции не упорядочен или оператор не является ассоциативным и коммутативным.
- B
тип результата бинарного оператора.
- z
начальное значение.
- op
бинарный оператор.
- возвращает
-
результат вставки
opмежду последовательными элементами этого итерируемого объекта справа налево с начальным значениемzсправа:op(x_1, op(x_2, ... op(x_n, z)...))
где
x1, ..., xn— элементы этого итерируемого объекта. Возвращаетz, если этот итерируемый объект пуст.
- Определяющие классы
- TraversableOnce → GenTraversableOnce
def forall(p: (T) ⇒ Boolean): Boolean
Проверяет, выполняется ли предикат для всех значений, производимых этим итератором.
Примечание: может не завершаться для бесконечных итераторов.
- p
предикат, используемый для проверки элементов.
- возвращает
true, если заданный предикатpвыполняется для всех значений, производимых этим итератором, в противном случаеfalse.
- Классы-определения
- Iterator → TraversableOnce → GenTraversableOnce
- Примечание
Переиспользование: после вызова этого метода следует удалить итератор, на котором он был вызван. Использование его не определено и может измениться.
def foreach(f: (T) ⇒ Unit): Unit
Применяет функцию f ко всем значениям, производимым этим итератором.
- f
функция, которая применяется для своего побочного эффекта к каждому элементу. Результат функции
fигнорируется.
- Классы-определения
- Iterator → TraversableOnce → GenTraversableOnce
def formatted(fmtstr: String): String
Возвращает строку, отформатированную в соответствии с данной format строкой. Строки формата такие же, как в String.format (@см. java.lang.String.format).
- Неявный
- Этот член добавлен неявным преобразованием из Elements в StringFormat[Elements] выполненным методом StringFormat в scala.Predef.
- Классы-определения
- StringFormat
- Аннотации
- @inline()
final def getClass(): Class[_]
Возвращает представление класса времени выполнения объекта.
- возвращает
объект класса, соответствующий типу времени выполнения получателя.
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в противном случае.
def hashCode(): Int
Метод hashCode для ссылочных типов. См. hashCode в scala.Any.
- возвращает
значение хэш-кода для этого объекта.
def head: T
Возвращает следующий элемент итератора, не продвигаясь дальше него.
- Классы-определения
- Elements → BufferedIterator
def headOption: Option[T]
Возвращает опцию следующего элемента итератора, не продвигаясь дальше него.
- возвращает
следующий элемент этого итератора, если у него есть следующий элемент
None, если нет
- Классы-определения
- BufferedIterator
def indexFlag: Int
Возвращает значение флага индекса.
Флаг индекса хранит целое число, которое имеет определенный смысл, специфичный для операции. Например, операция takeWhile устанавливает флаг индекса в позицию элемента, где предикат терпит неудачу. Другие рабочие процессы могут сравнивать этот индекс с индексами, с которыми они работают, и возвращаться, если этот индекс меньше их индекса. Примеры операций, использующих это, это takeWhile, dropWhile, span и indexOf.
- returns
значение флага индекса
- Definition Classes
- DelegatedSignalling → Signalling
def indexOf[B >: T](elem: B, from: Int): Int
Возвращает индекс первого вхождения указанного объекта в этот итерируемый объект после или на некотором начальном индексе.
Примечание: может не завершаться для бесконечных итераторов.
- elem
элемент для поиска.
- from
начальный индекс
- returns
индекс
>= fromпервого вхожденияelemв значения, производимые этим итератором, или -1, если такой элемент не существует до достижения конца итератора.
- Definition Classes
- Iterator
- Note
Повторное использование: после вызова этого метода следует удалить итератор, на котором он был вызван. Использование его не определено и может быть изменено.
def indexOf[B >: T](elem: B): Int
Возвращает индекс первого вхождения указанного объекта в этот итерируемый объект.
Примечание: может не завершаться для бесконечных итераторов.
- elem
элемент для поиска.
- returns
индекс первого вхождения
elemв значения, производимые этим итератором, или -1, если такой элемент не существует до достижения конца итератора.
- Definition Classes
- Iterator
- Note
Повторное использование: после вызова этого метода следует удалить итератор, на котором он был вызван. Использование его не определено и может быть изменено.
def indexWhere(pred: (T) ⇒ Boolean): Int
Возвращает индекс первого значения, удовлетворяющего предикату, или -1.
Примечание: может не завершаться для бесконечных итераторов.
- returns
индекс первого произведенного значения, удовлетворяющего
p, или -1, если такой элемент не существует до достижения конца итератора.
- Definition Classes
- AugmentedSeqIterator → Iterator
- Note
Повторное использование: после вызова этого метода следует удалить итератор, на котором он был вызван. Использование его не определено и может быть изменено.
def indexWhere(p: (T) ⇒ Boolean, from: Int): Int
Возвращает индекс первого произведенного значения, удовлетворяющего предикату, или -1, после или на некотором начальном индексе.
Примечание: может не завершаться для бесконечных итераторов.
- p
предикат для проверки значений
- from
начальный индекс
- returns
индекс
>= fromпервого произведенного значения, удовлетворяющего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 lastIndexWhere(pred: (T) ⇒ Boolean): Int
- Definition Classes
- AugmentedSeqIterator
def length: Int
Возвращает количество элементов в этом итераторе.
Примечание: не завершится для бесконечных итераторов.
- Definition Classes
- Iterator
- Примечание
Переиспользование: После вызова этого метода нужно удалить итератор, на котором он был вызван. Использование старого итератора не определено и может быть изменено.
def map[S](f: (T) ⇒ S): Mapped[S]
Создает новый итератор, который отображает все значения, производимые этим итератором, в новые значения с использованием функции преобразования.
- f
функция преобразования
- returns
новый итератор, который преобразует каждое значение, производимое этим итератором, путём применения функции
fк нему.
- Definition Classes
- SeqSplitter → IterableSplitter → Iterator
- Примечание
Переиспользование: После вызова этого метода нужно удалить итератор, на котором он был вызван, и использовать только возвращённый итератор. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новом итераторе.
def map2combiner[S, That](f: (T) ⇒ S, cb: Combiner[S, That]): Combiner[S, That]
- Definition Classes
- AugmentedIterableIterator
def max: A
Находит наибольший элемент.
- returns
наибольший элемент этого обозримого или итератора.
- Definition Classes
- AugmentedIterableIterator → TraversableOnce → GenTraversableOnce
- Исключения
UnsupportedOperationException, если этот обозримый или итератор пустой.
def maxBy[B](f: (A) ⇒ B): A
Находит первый элемент, который даёт наибольшее значение, измеренное функцией f.
- B
Тип результата функции f.
- f
Функция измерения.
- returns
первый элемент этого обозримого или итератора с наибольшим значением, измеренным функцией f.
- Definition Classes
- TraversableOnce → GenTraversableOnce
- Исключения
UnsupportedOperationExceptionесли этот обозримый или итератор пустой.
def min: A
Находит наименьший элемент.
- returns
наименьший элемент этого обозримого или итератора
- Definition Classes
- AugmentedIterableIterator → TraversableOnce → GenTraversableOnce
- Исключения
UnsupportedOperationExceptionесли этот обозримый или итератор пустой.
def minBy[B](f: (A) ⇒ B): A
Находит первый элемент, который даёт наименьшее значение, измеренное функцией 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.
- Классы-определения
- TraversableOnce → GenTraversableOnce
List(1, 2, 3).mkString("|") = "1|2|3"
def mkString(start: String, sep: String, end: String): String
Отображает все элементы этого итерируемого объекта или итератора в строке, используя начальную, конечную и разделительные строки.
- start
начальная строка.
- sep
строка-разделитель.
- end
конечная строка.
- returns
строковое представление этого итерируемого объекта или итератора. Результирующая строка начинается со строки
startи заканчивается строкойend. Внутри строковые представления (относительно методаtoString) всех элементов этого итерируемого объекта или итератора разделены строкойsep.
- Классы-определения
- TraversableOnce → GenTraversableOnce
List(1, 2, 3).mkString("(", "; ", ")") = "(1; 2; 3)"
final def ne(arg0: AnyRef): Boolean
Эквивалентно !(this eq that).
- returns
true, если аргумент не является ссылкой на объект-получатель;falseв противном случае.
- Классы-определения
- AnyRef
def next(): T
Возвращает следующий элемент этого итератора.
- returns
следующий элемент этого итератора, если
hasNextявляетсяtrue; в противном случае, поведение не определено.
def nonEmpty: Boolean
Проверяет, не является ли итерируемый объект или итератор пустым.
- returns
true, если итерируемый объект или итератор содержит хотя бы один элемент;falseв противном случае.
- Классы-определения
- TraversableOnce → GenTraversableOnce
final def notify(): Unit
Разбуждает единственную нить, ожидающую монитора объекта-получателя.
- Классы-определения
- AnyRef
- Аннотации
- @native()
- Примечание
не указано SLS в качестве члена AnyRef
final def notifyAll(): Unit
Разбуждает все нити, ожидающие монитора объекта-получателя.
- Классы-определения
- AnyRef
- Аннотации
- @native()
- Примечание
не указано SLS в качестве члена AnyRef
def padTo(len: Int, elem: T): Iterator[T]
Добавляет значение элемента к этому итератору до достижения заданной длины.
- len
целевая длина
- elem
значение для заполнения
- returns
новый итератор, содержащий все значения этого итератора, за которым следует минимальное количество вхождений
elem, так что количество созданных значений составляет не менееlen.
- Классы-определения
- Iterator
def partition(p: (T) ⇒ Boolean): (Iterator[T], Iterator[T])
Разделяет этот итератор на два итератора в соответствии с предикатом.
- p
предикат для разделения
- returns
пара итераторов: итератор, удовлетворяющий предикату
p, и итератор, который не удовлетворяет. Относительный порядок элементов в результирующих итераторах такой же, как в исходном итераторе.
- Классы-определения
- Iterator
- Примечание
Переиспользование: после вызова этого метода следует отбросить итератор, на котором он был вызван, и использовать только возвращенные итераторы. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новых итераторах также.
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
- Примечание
Переиспользование: После вызова этого метода нужно удалить итератор, на котором он был вызван, а также переданный в качестве параметра, и использовать только возвращённый итератор. Использование старых итераторов не определено, может измениться и может привести к изменениям в новом итераторе.
def patchParSeq[U >: T](from: Int, patchElems: SeqSplitter[U], replaced: Int): Patched[U]
- Definition Classes
- SeqSplitter
def prefixLength(pred: (T) ⇒ Boolean): Int
- Definition Classes
- AugmentedSeqIterator
def product: A
Перемножает элементы этого набора.
- возвращает
произведение всех элементов в этом наборе или итераторе чисел типа
Int. ВместоInt, любой другой типTс неявнойNumeric[T]реализацией может быть использован в качестве типа элемента набора или итератора и в качестве типа результатаproduct. Примерами таких типов являются:Long,Float,Double,BigInt.
- Definition Classes
- AugmentedIterableIterator → TraversableOnce → GenTraversableOnce
def psplit(sizes: Int*): scala.Seq[SeqSplitter[T]]
Разделяет итератор на независимые части.
Этот перегруженный метод split специфичен для точных итераторов. Он возвращает последовательность итераторов, каждый из которых перебирает подмножество элементов в этом итераторе. Размеры подмножеств в разбиении равны соответствующему значению аргумента, если в этом итераторе достаточно элементов для такого разбиения.
Если элементов недостаточно, для каждого дополнительного аргумента добавляется итератор с нулевым размером. Если есть дополнительные элементы, в конце добавляется дополнительный итератор для компенсации.
Например, предположим, что у нас есть итератор ps с 100 элементами. Вызов:
ps.split(50, 25, 25, 10, 5)
вернёт последовательность из пяти итераторов, последние два из которых будут пустыми. С другой стороны, вызов:
ps.split(50, 40)
вернёт последовательность из трёх итераторов, последний из которых содержит десять элементов.
Примечание: этот метод фактически делает текущий итератор недействительным.
В отличие от случая с split, найденном в итераторах, подмножества, возвращаемые этим методом, могут быть пустыми.
- sizes
размеры, используемые для разделения этого итератора на итераторы, которые перебирают независимые подмножества
- возвращает
последовательность независимых подпоследовательностей-итераторов этого параллельного итератора
- Definition Classes
- Elements → SeqSplitter → PreciseSplitter
def psplitWithSignalling(sizes: Int*): scala.Seq[SeqSplitter[T]]
- Definition Classes
- SeqSplitter
def reduce[U >: T](op: (U, U) ⇒ U): U
Уменьшает элементы этого итерируемого объекта или итератора, используя указанный ассоциативный бинарный оператор.
Порядок выполнения операций над элементами не определен и может быть не детерминированным.
- op
Бинарный оператор, который должен быть ассоциативным.
- returns
Результат применения оператора reduce
opмежду всеми элементами, если итерируемый объект или итератор не пуст.
- Definition Classes
- AugmentedIterableIterator → TraversableOnce → GenTraversableOnce
- Exceptions thrown
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
бинарный оператор.
- returns
-
результат вставки
opмежду последовательными элементами этого итерируемого объекта или итератора слева направо:op( op( ... op(x_1, x_2) ..., x_{n-1}), x_n)где
x1, ..., xn— элементы этого итерируемого объекта или итератора.
- Definition Classes
- TraversableOnce
- Exceptions thrown
UnsupportedOperationException, если этот итерируемый объект или итератор пуст.
def reduceLeftOption[B >: T](op: (B, T) ⇒ B): Option[B]
Возможно применить бинарный оператор ко всем элементам этого итерируемого объекта или итератора слева направо.
Примечание: не будет завершаться для коллекций бесконечного размера.
Примечание: может возвращать разные результаты для разных запусков, если тип базовой коллекции не упорядочен или оператор не ассоциативен и коммутативен.
- B
тип результата бинарного оператора.
- op
бинарный оператор.
- returns
значение опции, содержащее результат
reduceLeft(op), если этот итерируемый объект или итератор не пуст,Noneв противном случае.
- Definition Classes
- TraversableOnce → GenTraversableOnce
def reduceOption[A1 >: T](op: (A1, A1) ⇒ A1): Option[A1]
Уменьшает элементы этого итерируемого объекта или итератора, если таковые имеются, используя указанный ассоциативный бинарный оператор.
Порядок выполнения операций над элементами не определен и может быть не детерминированным.
- A1
Параметр типа для бинарного оператора, надтипа для
A.- op
Бинарный оператор, который должен быть ассоциативным.
- returns
Значение опции, содержащее результат применения оператора reduce
opмежду всеми элементами, если коллекция не пуста, иNoneв противном случае.
- Definition Classes
- TraversableOnce → GenTraversableOnce
def reduceRight[B >: T](op: (T, B) ⇒ B): B
Применяет бинарный оператор ко всем элементам этого итерируемого объекта или итератора справа налево.
Примечание: не будет завершаться для коллекций бесконечного размера.
Примечание: может возвращать разные результаты для разных запусков, если тип базовой коллекции не упорядочен или оператор не ассоциативен и коммутативен.
- B
тип результата бинарного оператора.
- op
бинарный оператор.
- returns
-
результат вставки
opмежду последовательными элементами этого итерируемого объекта или итератора справа налево:op(x_1, op(x_2, ..., op(x_{n-1}, x_n)...))где
x1, ..., xn— элементы этого итерируемого объекта или итератора.
- Definition Classes
- TraversableOnce → GenTraversableOnce
- Exceptions thrown
UnsupportedOperationException, если этот итерируемый объект или итератор пуст.
def reduceRightOption[B >: T](op: (T, B) ⇒ B): Option[B]
Необязательно применяет бинарный оператор ко всем элементам этого итерируемого объекта или итератора, двигаясь справа налево.
Примечание: не будет завершаться для коллекций бесконечного размера.
Примечание: может возвращать разные результаты при разных запусках, если тип базовой коллекции не упорядочен или оператор не является ассоциативным и коммутативным.
- B
тип результата бинарного оператора.
- op
бинарный оператор.
- returns
значение опционального типа, содержащее результат
reduceRight(op), если этот итерируемый объект или итератор не пустой,Noneв противном случае.
- Definition Classes
- TraversableOnce → GenTraversableOnce
final def remaining: Int
Количество элементов, которые этому итератору ещё предстоит пройти. Этот метод не изменяет состояние итератора. В отличие от версии этого метода в супертрайте, метод remaining в ParSeqLike.this.ParIterator должен возвращать точное число оставшихся элементов в итераторе.
- returns
точное количество элементов, которые этому итератору ещё предстоит пройти
- Definition Classes
- Elements → SeqSplitter → AugmentedSeqIterator → IterableSplitter → RemainsIterator
def reverse: SeqSplitter[T]
- Definition Classes
- SeqSplitter
def reverse2combiner[U >: T, This](cb: Combiner[U, This]): Combiner[U, This]
- Definition Classes
- AugmentedSeqIterator
def reverseMap2combiner[S, That](f: (T) ⇒ S, cb: Combiner[S, That]): Combiner[S, That]
- Definition Classes
- AugmentedSeqIterator
def reversed: List[T]
- 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, T) ⇒ B): Iterator[B]
Создаёт коллекцию, содержащую кумулятивные результаты применения оператора слева направо, включая начальное значение.
Примечание: не будет завершаться для бесконечных итераторов.
Примечание: может возвращать разные результаты при разных запусках, если тип базовой коллекции не упорядочен.
- B
тип элементов в результирующей коллекции
- z
начальное значение
- op
бинарный оператор, применяемый к промежуточному результату и элементу
- returns
итератор с промежуточными результатами
- Definition Classes
- Iterator
- Примечание
Переиспользование: после вызова этого метода следует удалить итератор, на котором он был вызван, и использовать только возвращенный итератор. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новом итераторе тоже.
def scanRight[B](z: B)(op: (T, B) ⇒ B): Iterator[B]
Создаёт коллекцию, содержащую кумулятивные результаты применения оператора справа налево. Голова коллекции — последний кумулятивный результат.
Примечание: не будет завершаться для бесконечных итераторов.
Примечание: может возвращать разные результаты при разных запусках, если тип базовой коллекции не упорядочен.
- B
тип элементов в результирующей коллекции
- z
начальное значение
- op
бинарный оператор, применяемый к промежуточному результату и элементу
- returns
итератор с промежуточными результатами
- Definition Classes
- Iterator
- Примечание
Переиспользование: после вызова этого метода следует удалить итератор, на котором он был вызван, и использовать только возвращенный итератор. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новом итераторе тоже.
Iterator(1, 2, 3, 4).scanRight(0)(_ + _).toList == List(10, 9, 7, 4, 0)
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
Устанавливает значение флага индекса, если аргумент больше текущего значения. Этот метод делает это атомарно.
Флаг индекса содержит целое число, которое имеет определенный смысл, специфичный для операции. Например, операция takeWhile устанавливает флаг индекса в позицию элемента, где предикат терпит неудачу. Другие рабочие процессы могут проверять этот индекс по отношению к индексам, над которыми они работают, и возвращаться, если этот индекс меньше их индекса. Примеры операций, использующих это, - это takeWhile, dropWhile, span и indexOf.
- f
значение, которое устанавливается для флага индекса
- Definition Classes
- DelegatedSignalling → Signalling
def setIndexFlagIfLesser(f: Int): Unit
Устанавливает значение флага индекса, если аргумент меньше текущего значения. Этот метод делает это атомарно.
Флаг индекса содержит целое число, которое имеет определенный смысл, специфичный для операции. Например, операция takeWhile устанавливает флаг индекса в позицию элемента, где предикат терпит неудачу. Другие рабочие процессы могут проверять этот индекс по отношению к индексам, над которыми они работают, и возвращаться, если этот индекс меньше их индекса. Примеры операций, использующих это, - это takeWhile, dropWhile, span и indexOf.
- f
значение, которое устанавливается для флага индекса
- Definition Classes
- DelegatedSignalling → Signalling
def shouldSplitFurther[S](coll: ParIterable[S], parallelismLevel: Int): Boolean
- Definition Classes
- IterableSplitter
val signalDelegate: Signalling
Делегат, к которому перенаправляются вызовы методов.
- Definition Classes
- IterableSplitter → DelegatedSignalling
def size: Int
Размер этого итерируемого объекта или итератора.
Примечание: не завершит работу для коллекций бесконечного размера.
- returns
количество элементов в этом итерируемом объекте или итераторе.
- Definition Classes
- TraversableOnce → GenTraversableOnce
def sizeHintIfCheap: Int
Размер этой коллекции или итератора, если его можно вычислить быстро.
- returns
количество элементов в этой коллекции или итераторе, или -1, если размер нельзя определить быстро.
- Attributes
- protected[collection]
- Definition Classes
- GenTraversableOnce
def slice(from1: Int, until1: Int): SeqSplitter[T]
Создает итератор, возвращающий интервал значений, производимых этим итератором.
- returns
итератор, который продвигает этот итератор мимо первых
fromэлементов с использованиемdrop, и затем беретuntil - fromэлементов, используяtake.
- Definition Classes
- SeqSplitter → IterableSplitter → Iterator
- Note
Использование: После вызова этого метода необходимо удалить итератор, на котором он был вызван, и использовать только возвращённый итератор. Использование старого итератора неопределённо, может измениться, и может привести к изменениям в новом итераторе.
def slice2combiner[U >: T, This](from: Int, until: Int, cb: Combiner[U, This]): Combiner[U, This]
- Definition Classes
- AugmentedIterableIterator
def sliceIterator(from: Int, until: Int): Iterator[T]
Создаёт необязательно ограниченный срез, неограниченный, если until отрицательно.
- Attributes
- protected
- Definition Classes
- 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
- returns
Итератор, генерирующий
Seq[B]размеромsize, за исключением последнего элемента (который может быть единственным элементом), который будет усечён, если оставшихся элементов для группировки меньше, чемsize. Это поведение можно настроить.
- Definition Classes
- Iterator
- Note
Использование: После вызова этого метода необходимо удалить итератор, на котором он был вызван, и использовать только возвращённый итератор. Использование старого итератора неопределённо, может измениться, и может привести к изменениям в новом итераторе.
def span(p: (T) ⇒ Boolean): (Iterator[T], Iterator[T])
Разделяет этот итератор на пару префикс/суффикс в соответствии с предикатом.
- p
предикат проверки
- returns
пара итераторов, состоящая из самого длинного префикса этого, чьи элементы все удовлетворяют
p, и остальная часть итератора.
- Definition Classes
- Iterator
- Note
Использование: После вызова этого метода необходимо удалить итератор, на котором он был вызван, и использовать только возвращённые итераторы. Использование старого итератора неопределённо, может измениться, и может привести к изменениям в новых итераторах.
def span2combiners[U >: T, This](p: (T) ⇒ Boolean, before: Combiner[U, This], after: Combiner[U, This]): (Combiner[U, This], Combiner[U, This])
- Definition Classes
- AugmentedIterableIterator
def split: Seq[SeqSplitter[T]]
Разделяет итератор на последовательность непересекающихся представлений.
Возвращает последовательность итераторов, каждый из которых итерируется по некоторому подмножеству элементов в коллекции. Эти подмножества не пересекаются и должны быть примерно равны по размеру. Эти подмножества не пустые, если только итератор не пуст, в этом случае этот метод возвращает последовательность с единственным пустым итератором. Если у разделителя больше двух элементов, этот метод вернёт два или более разделителя.
Реализаторам рекомендуется сохранять это разбиение относительно небольшим — двух разделителей уже достаточно при разбиении коллекции, хотя их может быть немного больше.
Примечание: этот метод фактически делает текущий разделитель недействительным.
- returns
последовательность непересекающихся итераторов коллекции
- Definition Classes
- Elements → SeqSplitter → PreciseSplitter → 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[SeqSplitter[T]]
- Definition Classes
- SeqSplitter → IterableSplitter
def sum: A
Суммирует элементы этой коллекции.
- 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): SeqSplitter[T]
Выбирает первые n значений этого итератора.
- n
количество значений для выбора
- returns
итератор, генерирующий только первые
nзначения этого итератора, или же весь итератор, если он генерирует меньше чемnзначений.
- Definition Classes
- SeqSplitter → IterableSplitter → Iterator
- Примечание
Переиспользование: После вызова этого метода следует удалить вызываемый итератор и использовать только возвращённый итератор. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новом итераторе также.
def take2combiner[U >: T, This](n: Int, cb: Combiner[U, This]): Combiner[U, This]
- Definition Classes
- AugmentedIterableIterator
def takeWhile(p: (T) ⇒ Boolean): Iterator[T]
Выбирает самую длинную префиксную последовательность значений, производимых этим итератором, которые удовлетворяют предикату.
- p
Используемый предикат для проверки элементов.
- returns
Итератор, возвращающий значения, производимые этим итератором, до тех пор, пока этот итератор не произведёт значение, которое не удовлетворяет предикату
p.
- Definition Classes
- Iterator
- Примечание
Переиспользование: После вызова этого метода следует удалить вызываемый итератор и использовать только возвращённый итератор. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новом итераторе также.
def takeWhile2combiner[U >: T, This](p: (T) ⇒ Boolean, cb: Combiner[U, This]): (Combiner[U, This], Boolean)
- Определяющие классы
- AugmentedIterableIterator
def to[Col[_]]: Col[A]
Преобразует это перечислимое или итератор в другой, копируя все элементы.
Примечание: не завершится для бесконечных итераторов.
- Col
Тип коллекции для построения.
- возвращает
новая коллекция, содержащая все элементы этого перечислимого или итератора.
- Определяющие классы
- TraversableOnce → GenTraversableOnce
def toArray: Array[A]
Преобразует это перечислимое или итератор в массив.
Примечание: не завершится для бесконечных итераторов.
- возвращает
массив, содержащий все элементы этого перечислимого или итератора. Должна быть доступна
ClassTagдля типа элемента этого перечислимого или итератора.
- Определяющие классы
- TraversableOnce → GenTraversableOnce
def toBuffer[B >: T]: Buffer[B]
Использует содержимое этого перечислимого или итератора для создания нового изменяемого буфера.
Примечание: не завершится для бесконечных коллекций.
- возвращает
буфер, содержащий все элементы этого перечислимого или итератора.
- Определяющие классы
- TraversableOnce → GenTraversableOnce
def toIndexedSeq: immutable.IndexedSeq[T]
Преобразует это перечислимое или итератор в индексированную последовательность.
Примечание: не завершится для бесконечных коллекций.
- возвращает
индексированная последовательность, содержащая все элементы этого перечислимого или итератора.
- Определяющие классы
- TraversableOnce → GenTraversableOnce
def toIterable: Iterable[T]
Преобразует это перечислимое или итератор в итерируемую коллекцию. Обратите внимание, что выбор целевого Iterable является ленивым в этой реализации по умолчанию, поскольку это TraversableOnce может быть ленивым и невыполненным (т. е. это может быть итератор, который можно проходить только один раз).
Примечание: не завершится для бесконечных коллекций.
- возвращает
Iterable, содержащая все элементы этого перечислимого или итератора.
- Определяющие классы
- TraversableOnce → GenTraversableOnce
def toIterator: Iterator[T]
Возвращает итератор по элементам в этом перечислимом или итераторе. Вернет тот же итератор, если этот экземпляр уже является итератором.
Примечание: не завершится для бесконечных итераторов.
- возвращает
итератор, содержащий все элементы этого перечислимого или итератора.
- Определяющие классы
- Iterator → GenTraversableOnce
def toList: List[T]
Преобразует это перечислимое или итератор в список.
Примечание: не завершится для бесконечных коллекций.
- возвращает
список, содержащий все элементы этого перечислимого или итератора.
- Определяющие классы
- TraversableOnce → GenTraversableOnce
def toMap[T, U]: collection.Map[T, U]
Преобразует это перечислимое или итератор в карту. Этот метод недоступен, если элементы не являются членами Tuple2, при этом каждый ((T, U)) становится парой ключ-значение в карте. Повторяющиеся ключи будут перезаписаны более поздними ключами: если это неупорядоченная коллекция, то какой ключ находится в результирующей карте не определено.
Примечание: не завершится для бесконечных итераторов.
- возвращает
карта типа
immutable.Map[T, U], содержащая все пары ключ/значение типа(T, U)этого перечислимого или итератора.
- Определяющие классы
- TraversableOnce → GenTraversableOnce
def toParArray: ParArray[T]
- Неявный
- Этот член добавляется неявным преобразованием из Elements в CollectionsHaveToParArray[Elements, T] выполненным методом CollectionsHaveToParArray в scala.collection.parallel. Это преобразование будет выполнено только если неявное значение типа (Elements) ⇒ 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>"пуст ли итератор или нет.
def toTraversable: Traversable[T]
Преобразует это обходное выражение или итератор в неопределённое обходное выражение. Вернёт ту же коллекцию, если этот экземпляр уже является обходным выражением.
Примечание: не завершится для бесконечных итераторов.
- возвращает
обходное выражение, содержащее все элементы этого обходного выражения или итератора.
- Определяющие классы
- Iterator → TraversableOnce → GenTraversableOnce
def toVector: Vector[T]
Преобразует это обходное выражение или итератор в вектор.
Примечание: не завершится для бесконечных коллекций.
- возвращает
вектор, содержащий все элементы этого обходного выражения или итератора.
- Определяющие классы
- TraversableOnce → GenTraversableOnce
def updated2combiner[U >: T, That](index: Int, elem: U, cb: Combiner[U, That]): Combiner[U, That]
- Определяющие классы
- AugmentedSeqIterator
final def wait(): Unit
- Определяющие классы
- AnyRef
- Аннотации
- @throws( ... )
final def wait(arg0: Long, arg1: Int): Unit
- Определяющие классы
- AnyRef
- Аннотации
- @throws( ... )
final def wait(arg0: Long): Unit
def withFilter(p: (T) ⇒ Boolean): Iterator[T]
Создаёт итератор, содержащий все элементы текущего итератора, удовлетворяющие заданному предикату p. Порядок элементов сохраняется.
Примечание: withFilter эквивалентно filter для итераторов. Оно существует для того, чтобы выражения for с фильтрацией работали над итераторами.
- p
предикат для проверки значений.
- returns
итератор, который генерирует значения текущего итератора, удовлетворяющие предикату
p.
- Definition Classes
- Iterator
- Note
Переиспользование: После вызова этого метода следует удалить итератор, на котором он был вызван, и использовать только возвращённый итератор. Использование старого итератора неопределённо, может измениться и может привести к изменениям в новом итераторе.
def zip[B](that: Iterator[B]): Iterator[(T, B)]
Создаёт итератор, объединяющий текущий итератор с другим итератором, комбинируя соответствующие значения в пары. Если один из двух итераторов длиннее другого, его оставшиеся элементы игнорируются.
- that
Итератор, предоставляющий вторую половину каждой пары результата
- returns
новый итератор, содержащий пары, состоящие из соответствующих элементов текущего итератора и
that. Количество элементов, возвращаемых новым итератором, равно минимальному из количества элементов, возвращаемых текущим итератором иthat.
- Definition Classes
- Iterator
- Note
Переиспользование: После вызова этого метода следует удалить итератор, на котором он был вызван, а также переданный в качестве параметра итератор, и использовать только возвращённый итератор. Использование старых итераторов неопределённо, может измениться и может привести к изменениям в новом итераторе.
def zip2combiner[U >: T, S, That](otherpit: RemainsIterator[S], cb: Combiner[(U, S), That]): Combiner[(U, S), That]
- Definition Classes
- AugmentedIterableIterator
def zipAll[B](that: Iterator[B], thisElem: T, thatElem: B): Iterator[(T, B)]
Создаёт итератор, объединяющий текущий итератор с другим итератором, комбинируя соответствующие элементы в пары. Если один из двух итераторов короче другого, для расширения более короткого итератора до длины более длинного используются плейсхолдеры.
- that
итератор
thatможет иметь другую длину, чем итератор self.- thisElem
элемент
thisElemиспользуется для заполнения результирующего итератора, если итератор self короче, чемthat- thatElem
элемент
thatElemиспользуется для заполнения результирующего итератора, еслиthatкороче, чем итератор self- returns
новый итератор, содержащий пары, состоящие из соответствующих значений текущего итератора и
that. Длина возвращаемого итератора равна максимальной из длин текущего итератора иthat. Если текущий итератор короче, чемthat, используются значенияthisElemдля заполнения результата. Еслиthatкороче, чем текущий итератор, используются значенияthatElemдля заполнения результата.
- Definition Classes
- Iterator
def zipAll2combiner[U >: T, S, That](that: RemainsIterator[S], thiselem: U, thatelem: S, cb: Combiner[(U, S), That]): Combiner[(U, S), That]
- Definition Classes
- AugmentedIterableIterator
def zipAllParSeq[S, U >: T, R >: S](that: SeqSplitter[S], thisElem: U, thatElem: R): ZippedAll[U, R]
- Definition Classes
- SeqSplitter → IterableSplitter
def zipParSeq[S](that: SeqSplitter[S]): Zipped[S]
- Определяющие классы
- SeqSplitter → IterableSplitter
def zipWithIndex: Iterator[(T, Int)]
Создаёт итератор, который сопоставляет каждый элемент, производимый этим итератором, с его индексом, начиная со 0.
- возвращает
новый итератор, содержащий пары, состоящие из соответствующих элементов этого итератора и их индексов.
- Определяющие классы
- Iterator
- Примечание
Переиспользование: После вызова этого метода следует удалить итератор, на котором он был вызван, и использовать только итератор, который был возвращен. Использование старого итератора не определено, может измениться и может привести к изменениям в новом итераторе.
def →[B](y: B): (Elements, B)
- Неявный
- Этот член добавлен неявным преобразованием из Elements в ArrowAssoc[Elements] выполненным методом ArrowAssoc в scala.Predef.
- Определяющие классы
- ArrowAssoc
Затенённые неявные члены-значения
def filter(p: (T) ⇒ Boolean): TraversableOnce[T]
- Неявный
- Этот член добавлен неявным преобразованием из Elements в MonadOps[T] выполненным методом MonadOps в scala.collection.TraversableOnce.
- Затенение
- Этот неявный унаследованный член затенён одним или несколькими членами в этом классе.
Для доступа к этому члену можно использовать приведение типов:(elements: MonadOps[T]).filter(p)
- Определяющие классы
- MonadOps
def flatMap[B](f: (T) ⇒ GenTraversableOnce[B]): TraversableOnce[B]
- Неявный
- Этот член добавлен неявным преобразованием из Elements в MonadOps[T] выполненным методом MonadOps в scala.collection.TraversableOnce.
- Затенение
- Этот неявный унаследованный член затенён одним или несколькими членами в этом классе.
Для доступа к этому члену можно использовать приведение типов:(elements: MonadOps[T]).flatMap(f)
- Определяющие классы
- MonadOps
def map[B](f: (T) ⇒ B): TraversableOnce[B]
- Неявный
- Этот член добавлен неявным преобразованием из Elements в MonadOps[T] выполненным методом MonadOps в scala.collection.TraversableOnce.
- Затенение
- Этот неявный унаследованный член затенён одним или несколькими членами в этом классе.
Для доступа к этому члену можно использовать приведение типов:(elements: MonadOps[T]).map(f)
- Определяющие классы
- MonadOps
def withFilter(p: (T) ⇒ Boolean): Iterator[T]
- Неявный
- Этот член добавлен неявным преобразованием из Elements в MonadOps[T] выполненным методом MonadOps в scala.collection.TraversableOnce.
- Затенение
- Этот неявный унаследованный член затенён одним или несколькими членами в этом классе.
Для доступа к этому члену можно использовать приведение типов:(elements: MonadOps[T]).withFilter(p)
- Определяющие классы
- MonadOps
© 2002-2019 EPFL, with contributions from Lightbend.
Licensed under the Apache License, Version 2.0.
https://www.scala-lang.org/api/2.12.9/scala/collection/parallel/ParSeqLike$Elements.html
Используется для итерации по элементам с использованием индексов