Класс scala.collection.parallel.SeqSplitter.Mapped
класс Mapped[S] extends SeqSplitter.Mapped[S] с SeqSplitter[S]
- Источник
- RemainsIterator.scala
Конструкторы экземпляров
новый Mapped(f: (T) ⇒ S)
Типовые члены
класс GroupedIterator[B >: A] extends AbstractIterator[Seq[B]] с Iterator[Seq[B]]
Гибкий итератор для преобразования Iterator[A] в Iterator[Seq[A]] с настраиваемым размером последовательности, шагом и стратегией обработки элементов, которые не попадают в последовательность равномерно.
Типичные применения могут быть достигнуты с помощью методов grouped и sliding.
- Определения классов
- Iterator
класс Appended[U >: T, PI <: SeqSplitter[U]] extends SeqSplitter.Appended[U, PI] с SeqSplitter[U]
- Определения классов
- SeqSplitter
класс Mapped[S] extends SeqSplitter.Mapped[S] с SeqSplitter[S]
- Определения классов
- SeqSplitter
класс Patched[U >: T] extends SeqSplitter[U]
- Определения классов
- SeqSplitter
класс Taken extends SeqSplitter.Taken с SeqSplitter[T]
- Определения классов
- SeqSplitter
класс Zipped[S] extends SeqSplitter.Zipped[S] с SeqSplitter[(T, S)]
- Определения классов
- SeqSplitter
класс ZippedAll[U >: T, S] extends SeqSplitter.ZippedAll[U, S] с SeqSplitter[(U, S)]
- Определения классов
- SeqSplitter
Члены-значения
final def !=(arg0: Any): Boolean
Проверка двух объектов на неравенство.
- возвращает
trueесли !(this == that), иначе false.
- Определяющие классы
- AnyRef → Any
final def ##(): Int
Эквивалентно x.hashCode за исключением упакованных числовых типов и null. Для чисел возвращается значение хеша, согласованное с равенством значений: если два экземпляра типа значения сравниваются как true, то ## вернёт одинаковое значение хеша для каждого из них. Для null возвращает хэш-код, где null.hashCode вызывает NullPointerException.
- возвращает
значение хеша, согласованное с ==
- Определяющие классы
- AnyRef → Any
def +(other: String): String
- Неявный
- Этот член добавлен неявным преобразованием из Mapped[S] в any2stringadd[Mapped[S]], выполненное методом any2stringadd в scala.Predef.
- Определяющие классы
- any2stringadd
def ++(that: ⇒ Iterator[S]): Iterator[S]
Конкатенация этого итератора с другим.
- that
другой итератор
- возвращает
новый итератор, который сначала возвращает значения, генерируемые этим итератором, а затем значения, генерируемые итератором
that.
- Определяющие классы
- Iterator
def ->[B](y: B): (Mapped[S], B)
- Неявный
- Этот член добавлен неявным преобразованием из Mapped[S] в ArrowAssoc[Mapped[S]], выполненное методом ArrowAssoc в scala.Predef.
- Определяющие классы
- 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
бинарный оператор.
- возвращает
-
результат вставки
opмежду последовательными элементами этого итерируемого объекта или итератора слева направо с начальным значениемzслева:op(...op(op(z, x_1), x_2), ..., x_n)
где
x1, ..., xn- это элементы этого итерируемого объекта или итератора.
- Определяющие классы
- TraversableOnce → GenTraversableOnce
def :\[B](z: B)(op: (S, B) ⇒ B): B
Применение бинарного оператора ко всем элементам этого итерируемого объекта или итератора и начальному значению справа налево.
Примечание: :\ - это альтернативный синтаксис для foldRight; xs :\ z то же самое, что и xs foldRight z.
Примечание: не завершится для бесконечных коллекций.
Примечание: может вернуть разные результаты при разных запусках, если тип базовой коллекции не упорядочен или оператор не ассоциативен и коммутативен.
Примеры:
Обратите внимание, что функция свёртки, используемая для вычисления b, эквивалентна функции, используемой для вычисления c.
scala> val a = List(1,2,3,4) a: List[Int] = List(1, 2, 3, 4) scala> val b = (a :\ 5)(_+_) b: Int = 15 scala> val c = (a :\ 5)((x,y) => x + y) c: Int = 15
- B
тип результата бинарного оператора.
- z
начальное значение
- op
бинарный оператор
- возвращает
-
результат вставки
opмежду последовательными элементами этого итерируемого объекта или итератора справа налево с начальным значениемzсправа:op(x_1, op(x_2, ... op(x_n, z)...))
где
x1, ..., xn- это элементы этого итерируемого объекта или итератора.
- Определяющие классы
- TraversableOnce → GenTraversableOnce
final def ==(arg0: Any): Boolean
Выражение x == that эквивалентно if (x eq null) that eq null else x.equals(that).
- возвращает
trueесли объект-получатель эквивалентен аргументу;falseв противном случае.
- Определяющие классы
- AnyRef → Any
def abort(): Unit
Отправляет сигнал прерывания другим рабочим процессам.
Флаг прерывания, установленный в true, означает, что рабочий процесс может прерваться и произвести любой результат, так как его результат не повлияет на конечный результат вычисления. Примеры операций, использующих это: find, forall и exists методы.
- Определяющие классы
- DelegatedSignalling → Signalling
def addString(b: StringBuilder): StringBuilder
Добавляет все элементы этого итерируемого объекта или итератора в строковый билдер. Записанный текст состоит из строковых представлений (относительно метода toString) всех элементов этого итерируемого объекта или итератора без разделительной строки.
Пример:
scala> val a = List(1,2,3,4) a: List[Int] = List(1, 2, 3, 4) scala> val b = new StringBuilder() b: StringBuilder = scala> val h = a.addString(b) h: StringBuilder = 1234
- b
строковый билдер, в который добавляются элементы.
- возвращает
строковый билдер
bв который были добавлены элементы.
- Определяющие классы
- TraversableOnce
def addString(b: StringBuilder, sep: String): StringBuilder
Добавляет все элементы этого итерируемого объекта или итератора в строковый билдер с использованием разделительной строки. Записанный текст состоит из строковых представлений (относительно метода toString) всех элементов этого итерируемого объекта или итератора, разделенных строкой sep.
Пример:
scala> val a = List(1,2,3,4) a: List[Int] = List(1, 2, 3, 4) scala> val b = new StringBuilder() b: StringBuilder = scala> a.addString(b, ", ") res0: StringBuilder = 1, 2, 3, 4
- b
строковый билдер, в который добавляются элементы.
- sep
разделительная строка.
- возвращает
строковый билдер
bв который были добавлены элементы.
- Определяющие классы
- TraversableOnce
def addString(b: StringBuilder, start: String, sep: String, end: String): StringBuilder
Добавляет все элементы этого итерируемого объекта или итератора в строковый билдер с использованием начальной, конечной и разделительных строк. Записанный текст начинается со строки start и заканчивается строкой end. Между ними строковые представления (относительно метода toString) всех элементов этого итерируемого объекта или итератора разделены строкой sep.
Пример:
scala> val a = List(1,2,3,4)
a: List[Int] = List(1, 2, 3, 4)
scala> val b = new StringBuilder()
b: StringBuilder =
scala> a.addString(b , "List(" , ", " , ")")
res5: StringBuilder = List(1, 2, 3, 4)
- b
строковый билдер, в который добавляются элементы.
- start
начальная строка.
- sep
разделительная строка.
- end
конечная строка.
- возвращает
строковый билдер
bв который были добавлены элементы.
- Определяющие классы
- TraversableOnce
def aggregate[B](z: ⇒ B)(seqop: (B, 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
ассоциативный оператор, используемый для объединения результатов из разных разделов
- Определяющие классы
- TraversableOnce → GenTraversableOnce
def appendParIterable[U >: S, PI <: IterableSplitter[U]](that: PI): Mapped.Appended[U, PI]
- Определяющие классы
- IterableSplitter
def appendParSeq[U >: S, 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: BufferedIterator[S]
Создаёт буферизованный итератор из текущего итератора.
- returns
буферизованный итератор, возвращающий те же значения, что и текущий итератор.
- Definition Classes
- Iterator
- Примечание
Переиспользование: После вызова этого метода, следует удалить исходный итератор, и использовать только возвращённый. Использование старого итератора не определено, может измениться и может привести к изменениям в новом итераторе.
- См. также
def buildString(closure: ((String) ⇒ Unit) ⇒ Unit): String
- Атрибуты
- protected
- Definition Classes
- IterableSplitter
def clone(): AnyRef
Создаёт копию объекта.
По умолчанию реализация метода clone зависит от платформы.
- returns
копию объекта.
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
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
- Note
Повторное использование: после вызова этого метода нужно удалить итератор, на котором он был вызван. Использование его не определено и может измениться.
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
Копирует выбранные значения, сгенерированные этим итератором, в массив. Заполняет заданный массив 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 >: S](dest: Buffer[B]): Unit
Копирует все элементы этого обозримого или итератора в буфер.
Примечание: не завершится для коллекций бесконечного размера.
- dest
Буфер, в который копируются элементы.
- Definition Classes
- TraversableOnce
def corresponds[S](corr: (S, S) ⇒ Boolean)(that: scala.Iterator[S]): Boolean
- Definition Classes
- AugmentedSeqIterator
def corresponds[B](that: GenTraversableOnce[B])(p: (S, B) ⇒ Boolean): Boolean
Проверяет, соответствуют ли все элементы этого итератора соответствующим элементам другой коллекции, удовлетворяя предикату теста.
- B
тип элементов
that- that
другая коллекция
- p
предикат проверки, который связывает элементы из обеих коллекций
- returns
trueесли обе коллекции имеют одинаковую длину иp(x, y)являетсяtrueдля всех соответствующих элементовxэтого итератора иythat, в противном случаеfalse
- Definition Classes
- Iterator
def count(p: (S) ⇒ Boolean): Int
Подсчитывает количество элементов в итерируемом объекте или итераторе, удовлетворяющих предикату.
- p
предикат, используемый для проверки элементов.
- returns
количество элементов, удовлетворяющих предикату
p.
- Definition Classes
- AugmentedIterableIterator → TraversableOnce → GenTraversableOnce
def drop(n: Int): IterableSplitter[S]
Удаление, реализованное как простое жадное потребление.
- n
количество элементов для удаления
- returns
итератор, который генерирует все значения текущего итератора, но пропускает первые
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: SeqSplitter[S]
Создаёт копию этого итератора.
- Definition Classes
- Mapped → SeqSplitter → 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.
- Классы определения
- Ensuring
def ensuring(cond: Boolean): Mapped[S]
- Неявный
- Этот член добавлен неявным преобразованием из Mapped[S] в Ensuring[Mapped[S]] с помощью метода Ensuring в scala.Predef.
- Классы определения
- Ensuring
final def eq(arg0: AnyRef): Boolean
Проверяет, является ли аргумент (that) ссылкой на объект-получатель (this).
Метод eq реализует отношение эквивалентности на непустых экземплярах AnyRef, и обладает тремя дополнительными свойствами:
-
Он согласован: для любых непустых экземпляров
x и y типа AnyRef, многократные вызовы x.eq(y) последовательно возвращают true или последовательно возвращают false. Для любого непустого экземпляра x типа AnyRef, x.eq(null) и null.eq(x) возвращают false.
null.eq(null) возвращает true. При переопределении методов equals или hashCode важно обеспечить соответствие их поведения равенству ссылок. Поэтому, если два объекта являются ссылками друг на друга (o1 eq o2), они должны быть равны друг другу (o1 == o2) и должны иметь одинаковое хэширование (o1.hashCode == o2.hashCode).
- returns
trueесли аргумент является ссылкой на объект-получатель;falseв противном случае.
- Классы определения
- AnyRef
def equals(arg0: Any): Boolean
Метод равенства для ссылочных типов. Реализация по умолчанию делегирует вызов eq.
Смотрите также equals в scala.Any.
- returns
trueесли объект-получатель эквивалентен аргументу;falseв противном случае.
- Классы определения
- AnyRef → Any
def exists(p: (S) ⇒ Boolean): Boolean
Проверяет, выполняется ли предикат для некоторых значений, сгенерированных этим итератором.
Примечание: может не завершиться для бесконечных итераторов.
- p
предикат, используемый для проверки элементов.
- returns
trueесли заданный предикатpвыполняется для некоторых значений, генерируемых этим итератором, в противном случаеfalse.
- Классы определения
- Iterator → TraversableOnce → GenTraversableOnce
- Примечание
Переиспользование: После вызова этого метода итератор, на котором он был вызван, следует отбросить. Его дальнейшее использование неопределено и может быть изменено.
def filter(p: (S) ⇒ Boolean): Iterator[S]
Возвращает итератор по всем элементам этого итератора, удовлетворяющим предикату p. Порядок элементов сохраняется.
- p
предикат, используемый для проверки значений.
- returns
итератор, который генерирует те значения этого итератора, которые удовлетворяют предикату
p.
- Классы определения
- Iterator
- Примечание
Переиспользование: После вызова этого метода итератор, на котором он был вызван, следует отбросить и использовать только возвращенный итератор. Использование старого итератора неопределено, может быть изменено и может привести к изменениям в новом итераторе.
def filter2combiner[U >: S, This](pred: (S) ⇒ Boolean, cb: Combiner[U, This]): Combiner[U, This]
- Классы определения
- AugmentedIterableIterator
def filterNot(p: (S) ⇒ Boolean): Iterator[S]
Создаёт итератор по всем элементам этого итератора, которые не удовлетворяют предикату p.
- p
предикат, используемый для проверки значений.
- returns
итератор, который генерирует те значения этого итератора, которые не удовлетворяют предикату
p.
- Классы определения
- Iterator
- Примечание
Переиспользование: После вызова этого метода итератор, на котором он был вызван, следует отбросить и использовать только возвращенный итератор. Использование старого итератора неопределено, может быть изменено и может привести к изменениям в новом итераторе.
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] )
- Примечание
не определён SLS как член AnyRef
def find(p: (S) ⇒ Boolean): Option[S]
Находит первое значение, производимое итератором, удовлетворяющее предикату, если таковое имеется.
Примечание: может не завершиться для бесконечных итераторов.
- p
предикат, используемый для проверки значений.
- возвращает
значение option, содержащее первое значение, производимое итератором, которое удовлетворяет предикату
p, илиNoneв противном случае.
- Definition Classes
- Iterator → TraversableOnce → GenTraversableOnce
- Примечание
Переиспользование: после вызова этого метода нужно удалить итератор, на котором он был вызван. Использование его неопределено и может быть изменено.
def flatMap[B](f: (S) ⇒ GenTraversableOnce[B]): Iterator[B]
Создаёт новый итератор, применяя функцию ко всем значениям, производимым этим итератором, и конкатенируя результаты.
- f
функция, применяемая к каждому элементу.
- возвращает
итератор, полученный путём применения заданной функции-итератора
fк каждому значению, производимому этим итератором, и конкатенации результатов.
- Definition Classes
- Iterator
- Примечание
Переиспользование: после вызова этого метода следует удалить вызываемый итератор и использовать только возвращённый. Использование старого итератора неопределено, может быть изменено и может привести к изменениям в новом итераторе.
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
бинарный оператор, который должен быть ассоциативным.
- возвращает
результат применения оператора fold
opмежду всеми элементами иz, илиzесли этот коллектор или итератор пуст.
- Definition Classes
- AugmentedIterableIterator → TraversableOnce → GenTraversableOnce
def foldLeft[B](z: B)(op: (B, S) ⇒ B): B
Применяет бинарный оператор к начальному значению и всем элементам этого коллектора или итератора, слева направо.
Примечание: не завершится для бесконечных коллекций.
Примечание: может возвращать разные результаты для разных запусков, если тип базового коллектора не упорядочен или оператор не ассоциативен и не коммутативен.
- B
тип результата бинарного оператора.
- z
начальное значение.
- op
бинарный оператор.
- возвращает
-
результат вставки
opмежду последовательными элементами этого коллектора или итератора, слева направо с начальным значениемzслева:op(...op(z, x_1), x_2, ..., x_n)
где
x1, ..., xn- это элементы этого коллектора или итератора. Возвращает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)...))
где
x1, ..., xn— элементы этого итерируемого объекта или итератора. Возвращает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
Применяет функцию f ко всем значениям, производимым этим итератором.
- f
функция, которая применяется для своего побочного эффекта к каждому элементу. Результат функции
fигнорируется.
- Definition Classes
- Iterator → TraversableOnce → GenTraversableOnce
def formatted(fmtstr: String): String
Возвращает строку, отформатированную в соответствии с заданной строкой format. Форматные строки такие же, как у String.format (@см. java.lang.String.format).
- Неявный
- Этот член добавляется неявным преобразованием из Mapped[S] в StringFormat[Mapped[S]] выполненным методом StringFormat в scala.Predef.
- Definition Classes
- StringFormat
- Annotations
- @inline()
final def getClass(): Class[_]
Возвращает представление класса объекта во время выполнения.
- returns
объект класса, соответствующий типу получателя во время выполнения.
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
- Definition Classes
- Iterator
- Note
Повторное использование: после вызова этого метода нужно удалить вызываемый итератор и использовать только возвращенный итератор. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новом итераторе.
def hasDefiniteSize: Boolean
Проверяет, имеет ли этот итератор известный размер.
- returns
trueдля пустых итераторов,falseв противном случае.
- Definition Classes
- Iterator → TraversableOnce → GenTraversableOnce
- Note
Повторное использование: итератор остается допустимым для дальнейшего использования независимо от возвращаемого результата.
def hasNext: Boolean
Проверяет, может ли этот итератор предоставить еще один элемент.
- returns
true, если последующий вызовnextвернет элемент,falseв противном случае.
def hashCode(): Int
Метод hashCode для ссылочных типов. См. hashCode в scala.Any.
- возвращает
значение хэш-кода для этого объекта.
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(pred: (S) ⇒ Boolean): Int
Возвращает индекс первого значения, удовлетворяющего предикату, или -1.
Примечание: может не завершаться для бесконечных итераторов.
- возвращает
индекс первого произведённого значения, удовлетворяющего
p, или -1, если такого элемента не существует до достижения конца итератора.
- Определяющие классы
- AugmentedSeqIterator → Iterator
- Примечание
Повторное использование: после вызова этого метода следует удалить итератор, на котором он был вызван. Использование его не определено и может измениться.
def indexWhere(p: (S) ⇒ Boolean, from: Int): Int
Возвращает индекс первого произведённого значения, удовлетворяющего предикату, или -1 после или на указанном начальном индексе.
Примечание: может не завершаться для бесконечных итераторов.
- p
предикат для проверки значений
- from
начальный индекс
- возвращает
индекс
>= fromпервого произведённого значения, удовлетворяющегоp, или -1, если такого элемента не существует до достижения конца итератора.
- Определяющие классы
- Iterator
- Примечание
Повторное использование: после вызова этого метода следует удалить итератор, на котором он был вызван. Использование его не определено и может измениться.
def isAborted: Boolean
Проверяет, была ли выдана команда прерывания.
Флаг прерывания, установленный в true, означает, что рабочий процесс может прерваться и произвести любой результат, так как его результат не повлияет на окончательный результат вычисления. Примеры операций, использующих это, — методы find, forall и exists.
- возвращает
состояние прерывания
- Определяющие классы
- DelegatedSignalling → Signalling
def isEmpty: Boolean
Проверяет, пуст ли этот итератор.
- возвращает
trueесли hasNext равно false,falseв противном случае.
- Определяющие классы
- Iterator → TraversableOnce → GenTraversableOnce
- Примечание
Повторное использование: итератор остаётся действительным для дальнейшего использования независимо от возвращаемого результата.
final def isInstanceOf[T0]: Boolean
Проверяет, является ли динамический тип объекта-получателя T0.
Обратите внимание, что результат проверки учитывает стирание типов в Scala. Поэтому выражение 1.isInstanceOf[String] вернёт false, а выражение List(1).isInstanceOf[List[String]] вернёт true. В последнем примере, поскольку тип аргумента стирается во время компиляции, невозможно проверить, относятся ли содержимое списка к указанному типу.
- возвращает
trueесли объект-получатель является экземпляром стирания типаT0;falseв противном случае.
- Определяющие классы
- Any
def isRemainingCheap: Boolean
Для большинства коллекций это недорогая операция. Исключение может переопределить этот метод.
- Определяющие классы
- RemainsIterator
def isTraversableAgain: Boolean
Проверяет, можно ли повторно пройти по этому итератору.
- returns
false
- Definition Classes
- Iterator → GenTraversableOnce
- Примечание
Переиспользование: итератор остается валидным для дальнейшего использования, независимо от возвращаемого результата.
def lastIndexWhere(pred: (S) ⇒ Boolean): Int
- Definition Classes
- AugmentedSeqIterator
def length: Int
Возвращает количество элементов в этом итераторе.
Примечание: не будет завершаться для бесконечных итераторов.
- Definition Classes
- Iterator
- Примечание
Переиспользование: после вызова этого метода нужно избавиться от итератора, на котором он был вызван. Использование старого итератора не определено и может измениться.
def map[S](f: (S) ⇒ S): Mapped[S]
Создает новый итератор, который отображает все произведенные значения этого итератора в новые значения с использованием функции преобразования.
- f
функция преобразования
- returns
новый итератор, который преобразует каждое значение, произведенное этим итератором, применяя функцию
fк нему.
- Definition Classes
- SeqSplitter → IterableSplitter → Iterator
- Примечание
Переиспользование: после вызова этого метода следует удалить итератор, на котором он был вызван, и использовать только возвращенный итератор. Использование старого итератора не определено, может измениться и может привести к изменениям в новом итераторе тоже.
def map2combiner[S, That](f: (S) ⇒ 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.
- Definition Classes
- TraversableOnce → GenTraversableOnce
List(1, 2, 3).mkString("|") = "1|2|3"
def mkString(start: String, sep: String, end: String): String
Отображает все элементы этого итерируемого объекта или итератора в строке, используя начальную, конечную и разделительные строки.
- start
начальная строка.
- sep
разделительная строка.
- end
конечная строка.
- returns
строковое представление этого итерируемого объекта или итератора. Результирующая строка начинается со строки
startи заканчивается строкойend. Внутри строковые представления (относительно методаtoString) всех элементов этого итерируемого объекта или итератора разделены строкойsep.
- Definition Classes
- TraversableOnce → GenTraversableOnce
List(1, 2, 3).mkString("(", "; ", ")") = "(1; 2; 3)"
final def ne(arg0: AnyRef): Boolean
Эквивалентно !(this eq that).
- returns
trueесли аргумент не является ссылкой на объект-получатель;falseв противном случае.
- Definition Classes
- AnyRef
def next(): S
Возвращает следующий элемент этого итератора.
- returns
следующий элемент этого итератора, если
hasNextявляетсяtrue, в противном случае поведение не определено.
def nonEmpty: Boolean
Проверяет, не является ли итерируемый объект или итератор пустым.
- returns
trueесли итерируемый объект или итератор содержит хотя бы один элемент,falseв противном случае.
- Definition Classes
- TraversableOnce → GenTraversableOnce
final def notify(): Unit
Разбуждает один поток, ожидающий монитора объекта-получателя.
- Definition Classes
- AnyRef
- Annotations
- @native()
- Примечание
не определен в SLS как член AnyRef
final def notifyAll(): Unit
Разбуждает все потоки, ожидающие монитора объекта-получателя.
- Definition Classes
- AnyRef
- Annotations
- @native()
- Примечание
не определен в SLS как член AnyRef
def padTo(len: Int, elem: S): Iterator[S]
Добавляет значение элемента к этому итератору до тех пор, пока не будет достигнута заданная целевая длина.
- len
целевая длина
- elem
значение для заполнения
- returns
новый итератор, состоящий из всех значений этого итератора, за которыми следует минимальное количество повторений
elem, так что количество произведенных значений составляет не менееlen.
- Definition Classes
- Iterator
def partition(p: (S) ⇒ Boolean): (Iterator[S], Iterator[S])
Разделяет этот итератор на два итератора в соответствии с предикатом.
- p
предикат для разделения
- returns
пара итераторов: итератор, удовлетворяющий предикату
p, и итератор, не удовлетворяющий ему. Относительный порядок элементов в результирующих итераторах такой же, как и в исходном итераторе.
- Definition Classes
- Iterator
- Примечание
Переиспользование: После вызова этого метода следует удалить итератор, на котором он был вызван, и использовать только возвращенные итераторы. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новых итераторах.
def partition2combiners[U >: S, This](pred: (S) ⇒ Boolean, btrue: Combiner[U, This], bfalse: Combiner[U, This]): (Combiner[U, This], Combiner[U, This])
- Определения классов
- AugmentedIterableIterator
def patch[B >: S](from: Int, patchElems: Iterator[B], replaced: Int): Iterator[B]
Возвращает этот итератор с изменёнными значениями. Замена по отрицательным индексам эквивалентна замене с началом 0. Замена по индексам, равным или большим длины исходного итератора, добавляет замену в конец. Если заменённых значений больше, чем фактически существует, избыток игнорируется.
- from
Начальный индекс для замены
- patchElems
Итератор значений замены
- replaced
Количество значений в исходном итераторе, заменяемых заменой.
- Определения классов
- Iterator
- Примечание
Переиспользование: После вызова этого метода следует удалить итератор, на котором был вызван метод, а также переданный в качестве параметра, и использовать только возвращённый итератор. Использование старых итераторов неопределённо, может измениться, и может привести к изменениям в новом итераторе также.
def patchParSeq[U >: S](from: Int, patchElems: SeqSplitter[U], replaced: Int): Patched[U]
- Определения классов
- SeqSplitter
def prefixLength(pred: (S) ⇒ Boolean): Int
- Определения классов
- AugmentedSeqIterator
def product: A
Умножает элементы этой коллекции.
- возвращает
произведение всех элементов в этом обходчике или итераторе чисел типа
Int. ВместоInt, может быть использован любой другой типTс неявнойNumeric[T]реализацией, как тип элементов обходчика или итератора, и как тип результатаproduct. Примерами таких типов являются:Long,Float,Double,BigInt.
- Определения классов
- AugmentedIterableIterator → TraversableOnce → GenTraversableOnce
def psplit(sizes: Int*): scala.Seq[SeqSplitter[S]]
Разделяет обходчик на отдельные представления.
Этот перегруженный метод split специфичен для точных обходчиков. Возвращает последовательность обходчиков, каждый из которых итерирует по некоторому подмножеству элементов в этом обходчике. Размеры подобходчиков в разбиении равны размеру соответствующего аргумента, если в этом обходчике достаточно элементов, чтобы разбить его таким образом.
Если элементов недостаточно, добавляется обходчик с нулевыми элементами для каждого дополнительного аргумента. Если есть дополнительные элементы, добавляется дополнительный обходчик в конце для компенсации.
Например, пусть у нас есть обходчик ps с 100 элементами. Вызов:
ps.split(50, 25, 25, 10, 5)
вернёт последовательность из пяти обходчиков, последние два представления будут пустыми. С другой стороны, вызов:
ps.split(50, 40)
вернёт последовательность из трёх обходчиков, последний из которых содержит десять элементов.
Примечание: этот метод фактически делает текущий обходчик недействительным.
В отличие от split в обходчиках, представления, возвращённые этим методом, могут быть пустыми.
- sizes
размеры, используемые для разделения этого итератора параллельного обхода на итераторы, которые обходят непересекающиеся подмножества
- возвращает
последовательность итераторов непересекающихся подпоследовательностей этого параллельного итератора
- Определения классов
- Mapped → SeqSplitter → PreciseSplitter
def psplitWithSignalling(sizes: Int*): scala.Seq[SeqSplitter[S]]
- Определения классов
- SeqSplitter
def reduce[U >: S](op: (U, U) ⇒ U): U
Уменьшает элементы этого перебираемого объекта или итератора, используя указанный ассоциативный бинарный оператор.
Порядок выполнения операций над элементами не определён и может быть не детерминированным.
- op
Бинарный оператор, который должен быть ассоциативным.
- returns
Результат применения оператора reduce
opмежду всеми элементами, если перебираемый объект или итератор не пустой.
- Definition Classes
- AugmentedIterableIterator → TraversableOnce → GenTraversableOnce
- Исключения
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)где
x1, ..., xn- элементы этого перебираемого объекта или итератора.
- Definition Classes
- TraversableOnce
- Исключения
UnsupportedOperationExceptionесли этот перебираемый объект или итератор пустой.
def reduceLeftOption[B >: S](op: (B, S) ⇒ B): Option[B]
Возвращает значение, возможно применяя бинарный оператор ко всем элементам этого перебираемого объекта или итератора слева направо.
Примечание: не будет завершаться для бесконечных коллекций.
Примечание: может возвращать разные результаты для разных запусков, если тип базовой коллекции не упорядочен или оператор не ассоциативен и коммутативен.
- B
тип результата бинарного оператора.
- op
бинарный оператор.
- returns
опциональное значение, содержащее результат
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)...))где
x1, ..., xn- элементы этого перебираемого объекта или итератора.
- Definition Classes
- TraversableOnce → GenTraversableOnce
- Исключения
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
Количество элементов, которые этот итератор еще должен пройти. Этот метод не изменяет состояние итератора.
Этот метод используется для предоставления подсказок о размере билдерам и комбинаторам, а также для приблизительного определения позиций итераторов внутри структуры данных.
Примечание: Этот метод может быть реализован для возвращения верхней границы количества элементов в итераторе, а не точного количества элементов для перебора. Параллельные коллекции, которые имеют такие итераторы, называются нестрогими коллекциями-делителями.
В этом случае необходимо учитывать 2 момента:
1) классы, которые наследуют ParIterable, должны повторно реализовать методы take, drop, slice, splitAt, copyToArray и все остальные, использующие эту информацию.
2) если итератор предоставляет верхнюю границу количества элементов, то после разделения сумма значений remaining разделяемых итераторов должна быть меньше или равна этой верхней границе.
- Definition Classes
- Mapped → IterableSplitter → RemainsIterator
def reverse: SeqSplitter[S]
- Definition Classes
- SeqSplitter
def reverse2combiner[U >: S, This](cb: Combiner[U, This]): Combiner[U, This]
- Definition Classes
- AugmentedSeqIterator
def reverseMap2combiner[S, That](f: (S) ⇒ S, cb: Combiner[S, That]): Combiner[S, That]
- Definition Classes
- AugmentedSeqIterator
def reversed: List[S]
- Attributes
- protected[this]
- Definition Classes
- TraversableOnce
def sameElements(that: Iterator[_]): Boolean
Проверяет, производит ли другой итератор те же значения, что и этот.
Примечание: не будет завершаться для бесконечных итераторов.
- that
другой итератор
- returns
true, если оба итератора производят одинаковые элементы в том же порядке,falseв противном случае.
- Definition Classes
- Iterator
- Note
Переиспользование: После вызова этого метода следует удалить итератор, на котором он был вызван, а также переданный в качестве параметра. Использование старых итераторов не определено и может быть изменено.
def scanLeft[B](z: B)(op: (B, S) ⇒ B): Iterator[B]
Создаёт коллекцию, содержащую кумулятивные результаты применения оператора слева направо, включая начальное значение.
Примечание: не будет завершаться для бесконечных итераторов.
Примечание: может возвращать разные результаты для разных запусков, если тип базовой коллекции упорядочен.
- B
тип элементов в результирующей коллекции
- z
начальное значение
- op
бинарный оператор, применяемый к промежуточному результату и элементу
- returns
итератор с промежуточными результатами
- Definition Classes
- Iterator
- Note
Переиспользование: После вызова этого метода следует удалить итератор, на котором он был вызван, и использовать только итератор, который был возвращён. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новом итераторе также.
def scanRight[B](z: B)(op: (S, 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 >: 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]
Версия этой коллекции со всеми операциями, реализованными последовательно (т.е. в однопоточном режиме).
Этот метод возвращает ссылку на эту коллекцию. В параллельных коллекциях он переопределён для возвращения последовательной реализации этой коллекции. В обоих случаях его сложность составляет 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
Размер этого перечислимого или итератора.
Примечание: не завершится для коллекций бесконечного размера.
- возвращает
количество элементов в этом перечислимом или итераторе.
- Definition Classes
- TraversableOnce → GenTraversableOnce
def sizeHintIfCheap: Int
Размер этого набора или итератора, если он может быть вычислен дёшево
- возвращает
количество элементов в этом наборе или итераторе, или -1, если размер нельзя определить дёшево
- Attributes
- protected[collection]
- Definition Classes
- GenTraversableOnce
def slice(from1: Int, until1: Int): SeqSplitter[S]
Создаёт итератор, возвращающий интервал значений, производимых этим итератором.
- возвращает
итератор, который продвигает этот итератор мимо первых
fromэлементов с помощьюdrop, и затем берётuntil - fromэлементов, используяtake.
- Definition Classes
- SeqSplitter → IterableSplitter → Iterator
- Примечание
Переиспользование: после вызова этого метода следует удалить итератор, на котором он был вызван, и использовать только возвращённый итератор. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новом итераторе также.
def slice2combiner[U >: S, This](from: Int, until: Int, cb: Combiner[U, This]): Combiner[U, This]
- Definition Classes
- AugmentedIterableIterator
def sliceIterator(from: Int, until: Int): Iterator[S]
Создаёт необязательно ограниченный срез, неограниченный, если until отрицателен.
- Attributes
- protected
- Definition Classes
- 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. Это поведение можно настроить.
- Definition Classes
- Iterator
- Примечание
Переиспользование: после вызова этого метода следует удалить итератор, на котором он был вызван, и использовать только возвращённый итератор. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новом итераторе также.
def span(p: (S) ⇒ Boolean): (Iterator[S], Iterator[S])
Разделяет этот итератор на пару префикс/суффикс в соответствии с предикатом.
- p
предикат проверки
- returns
пара итераторов, состоящая из самого длинного префикса этого, элементы которого удовлетворяют
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[SeqSplitter[S]]
Разделяет итератор на последовательность непересекающихся представлений.
Возвращает последовательность итераторов разделов, каждый из которых итерирует по некоторому подмножеству элементов в коллекции. Эти подмножества не пересекаются и должны быть примерно равными по размеру. Эти подмножества не пустые, если только итератор не пустой, в этом случае этот метод возвращает последовательность с одним пустым итератором. Если у разделителя больше двух элементов, этот метод вернет два или более разделителей.
Реализаторам рекомендуется хранить это разбиение относительно небольшим - двух разделителей достаточно при разбиении коллекции, хотя может быть и несколько больше.
Примечание: этот метод фактически делает текущий разделитель недействительным.
- returns
последовательность непересекающихся итераторов коллекции
- Классы-определения
- Mapped → SeqSplitter → PreciseSplitter → Mapped → IterableSplitter → Splitter
def splitAt2combiners[U >: S, This](at: Int, before: Combiner[U, This], after: Combiner[U, This]): (Combiner[U, This], Combiner[U, This])
- Классы-определения
- AugmentedIterableIterator
def splitWithSignalling: scala.Seq[SeqSplitter[S]]
- Классы-определения
- SeqSplitter → IterableSplitter
def sum: A
Суммирует элементы этой коллекции.
- returns
сумма всех элементов в этом итерабельном объекте или итераторе чисел типа
Int. ВместоInt, может быть использован любой другой типTс неявной реализациейNumeric[T]в качестве типа элементов итерабельного объекта или итератора и как тип результатаsum. Примерами таких типов являются:Long,Float,Double,BigInt.
- Классы-определения
- AugmentedIterableIterator → TraversableOnce → GenTraversableOnce
final def synchronized[T0](arg0: ⇒ T0): T0
- Классы-определения
- AnyRef
def tag: Int
Только для чтения тег, специфичный для объекта сигнализации. Он используется для предоставления конкретным рабочим информации о части коллекции, над которой выполняется операция.
- Классы-определения
- DelegatedSignalling → Signalling
def take(n: Int): SeqSplitter[S]
Выбирает первые n значений из этого итератора.
- n
количество значений для взятия
- возвращает
итератор, производящий только первые
nзначения этого итератора, или весь итератор, если он производит меньше, чемnзначений.
- Классы-определения
- SeqSplitter → IterableSplitter → Iterator
- Примечание
Переиспользование: После вызова этого метода следует удалить вызвавший его итератор и использовать только возвращённый итератор. Использование старого итератора является неопределённым, может быть изменено и может привести к изменениям в новом итераторе тоже.
def take2combiner[U >: S, This](n: Int, cb: Combiner[U, This]): Combiner[U, This]
- Классы-определения
- AugmentedIterableIterator
def takeWhile(p: (S) ⇒ Boolean): Iterator[S]
Взятие самого длинного префикса значений, производимых этим итератором, которые удовлетворяют предикату.
- p
Предикат, используемый для проверки элементов.
- возвращает
Итератор, возвращающий значения, производимые этим итератором, до тех пор, пока этот итератор не произведёт значение, которое не удовлетворяет предикату
p.
- Классы-определения
- Iterator
- Примечание
Переиспользование: После вызова этого метода следует удалить вызвавший его итератор и использовать только возвращённый итератор. Использование старого итератора является неопределённым, может быть изменено и может привести к изменениям в новом итераторе тоже.
def takeWhile2combiner[U >: S, This](p: (S) ⇒ 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 >: S]: Buffer[B]
Использует содержимое этой последовательности или итератора для создания нового изменяемого буфера.
Примечание: не завершится для коллекций бесконечного размера.
- возвращает
буфер, содержащий все элементы этой последовательности или итератора.
- Классы-определения
- TraversableOnce → GenTraversableOnce
def toIndexedSeq: immutable.IndexedSeq[S]
Преобразует эту последовательность или итератор в индексированную последовательность.
Примечание: не завершится для коллекций бесконечного размера.
- возвращает
индексированная последовательность, содержащая все элементы этой последовательности или итератора.
- Классы-определения
- TraversableOnce → GenTraversableOnce
def toIterable: Iterable[S]
Преобразует эту последовательность или итератор в коллекцию Iterable. Примечание, что выбор целевого Iterable является ленивым в этой реализации по умолчанию, так как этот TraversableOnce может быть ленивым и невычисленным (т.е. он может быть итератором, который можно пройти только один раз).
Примечание: не завершится для коллекций бесконечного размера.
- возвращает
Iterable, содержащая все элементы этой последовательности или итератора.
- Классы-определения
- TraversableOnce → GenTraversableOnce
def toIterator: Iterator[S]
Возвращает итератор по элементам в этом перебираемом объекте или итераторе. Вернёт тот же итератор, если этот экземпляр уже является итератором.
Примечание: не завершится для бесконечных итераторов.
- возвращает
итератор, содержащий все элементы этого перебираемого объекта или итератора.
- Определяющие классы
- Iterator → GenTraversableOnce
def toList: List[S]
Преобразует этот перебираемый объект или итератор в список.
Примечание: не завершится для коллекций бесконечной длины.
- возвращает
список, содержащий все элементы этого перебираемого объекта или итератора.
- Определяющие классы
- TraversableOnce → GenTraversableOnce
def toMap[T, U]: Map[T, U]
Преобразует этот перебираемый объект или итератор в карту. Этот метод недоступен, если элементы не являются членами Tuple2, при этом каждый ((T, U)) становится парой ключ-значение в карте. Повторные ключи будут перезаписаны более поздними ключами: если это неупорядоченная коллекция, то порядок ключей в результирующей карте не определён.
Примечание: не завершится для бесконечных итераторов.
- возвращает
карта типа
immutable.Map[T, U]содержащая все пары ключ/значение типа(T, U)этого перебираемого объекта или итератора.
- Определяющие классы
- TraversableOnce → GenTraversableOnce
def toParArray: ParArray[T]
- Неявный
- Этот член добавлен неявным преобразованием из 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>"пуст или нет.
def toTraversable: Traversable[S]
Преобразует этот перебираемый объект или итератор в неопределённый объект Traversable. Вернёт ту же коллекцию, если этот экземпляр уже является Traversable.
Примечание: не завершится для бесконечных итераторов.
- возвращает
Traversable, содержащий все элементы этого перебираемого объекта или итератора.
- Определяющие классы
- Iterator → TraversableOnce → GenTraversableOnce
def toVector: Vector[S]
Преобразует этот перебираемый объект или итератор в Vector.
Примечание: не завершится для коллекций бесконечной длины.
- возвращает
вектор, содержащий все элементы этого перебираемого объекта или итератора.
- Определяющие классы
- TraversableOnce → GenTraversableOnce
def updated2combiner[U >: S, That](index: Int, elem: U, cb: Combiner[U, That]): Combiner[U, That]
- Definition Classes
- AugmentedSeqIterator
final def wait(): Unit
- Definition Classes
- AnyRef
- Annotations
- @throws( ... )
final def wait(arg0: Long, arg1: Int): Unit
- Definition Classes
- AnyRef
- Annotations
- @throws( ... )
final def wait(arg0: Long): Unit
def withFilter(p: (S) ⇒ Boolean): Iterator[S]
Создаёт итератор над всеми элементами этого итератора, удовлетворяющими предикату p. Порядок элементов сохраняется.
Примечание: withFilter эквивалентно filter для итераторов. Оно существует для того, чтобы выражения for с фильтрами работали над итераторами.
- p
предикат, используемый для проверки значений.
- returns
итератор, генерирующий те значения этого итератора, которые удовлетворяют предикату
p.
- Definition Classes
- Iterator
- Примечание
Переиспользование: после вызова этого метода, нужно удалить итератор, на котором он был вызван, и использовать только возвращённый итератор. Использование старого итератора не определено, может измениться и может привести к изменениям в новом итераторе тоже.
def zip[B](that: Iterator[B]): Iterator[(S, B)]
Создаёт итератор, образованный из этого итератора и другого итератора путём объединения соответствующих значений в пары. Если один из двух итераторов длиннее другого, его оставшиеся элементы игнорируются.
- that
Итератор, предоставляющий вторую половину каждой пары результатов
- returns
новый итератор, содержащий пары, состоящие из соответствующих элементов этого итератора и
that. Количество элементов, возвращаемых новым итератором, равно минимальному из количества элементов, возвращаемых этим итератором иthat.
- Definition Classes
- Iterator
- Примечание
Переиспользование: после вызова этого метода, нужно удалить итератор, на котором он был вызван, а также переданный в качестве параметра, и использовать только возвращённый итератор. Использование старых итераторов не определено, может измениться и может привести к изменениям в новом итераторе тоже.
def zip2combiner[U >: S, S, That](otherpit: RemainsIterator[S], cb: Combiner[(U, S), That]): Combiner[(U, S), That]
- Definition Classes
- AugmentedIterableIterator
def zipAll[B](that: Iterator[B], thisElem: S, thatElem: B): Iterator[(S, 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 >: S, S, That](that: RemainsIterator[S], thiselem: U, thatelem: S, cb: Combiner[(U, S), That]): Combiner[(U, S), That]
- Definition Classes
- AugmentedIterableIterator
def zipAllParSeq[S, U >: S, R >: S](that: SeqSplitter[S], thisElem: U, thatElem: R): ZippedAll[U, R]
- Definition Classes
- SeqSplitter → IterableSplitter
def zipParSeq[S](that: SeqSplitter[S]): Zipped[S]
- Definition Classes
- SeqSplitter → IterableSplitter
def zipWithIndex: Iterator[(S, Int)]
Создаёт итератор, который парсит каждый элемент, производимый этим итератором, со своим индексом, начиная с 0.
- returns
новый итератор, содержащий пары, состоящие из соответствующих элементов этого итератора и их индексов.
- Definition Classes
- Iterator
- Note
Переиспользование: После вызова этого метода следует удалить итератор, на котором он был вызван, и использовать только итератор, который был возвращён. Использование старого итератора не определено, может измениться и может привести к изменениям в новом итераторе тоже.
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)
- Классы определений
- MonadOps
def flatMap[B](f: (S) ⇒ GenTraversableOnce[B]): TraversableOnce[B]
- Неявный
- Этот член добавляется с помощью неявного преобразования из Mapped[S] в MonadOps[S] при выполнении метода MonadOps в scala.collection.TraversableOnce.
- Затенение
- Этот неявно унаследованный член затенён одним или несколькими членами в этом классе.
Для доступа к этому члену можно использовать описание типа:(mapped: MonadOps[S]).flatMap(f)
- Классы определений
- MonadOps
def map[B](f: (S) ⇒ B): TraversableOnce[B]
- Неявный
- Этот член добавляется с помощью неявного преобразования из Mapped[S] в MonadOps[S] при выполнении метода MonadOps в scala.collection.TraversableOnce.
- Затенение
- Этот неявно унаследованный член затенён одним или несколькими членами в этом классе.
Для доступа к этому члену можно использовать описание типа:(mapped: MonadOps[S]).map(f)
- Классы определений
- MonadOps
def withFilter(p: (S) ⇒ Boolean): Iterator[S]
- Неявный
- Этот член добавляется с помощью неявного преобразования из Mapped[S] в MonadOps[S] при выполнении метода MonadOps в scala.collection.TraversableOnce.
- Затенение
- Этот неявно унаследованный член затенён одним или несколькими членами в этом классе.
Для доступа к этому члену можно использовать описание типа:(mapped: MonadOps[S]).withFilter(p)
- Классы определений
- MonadOps
© 2002-2019 EPFL, with contributions from Lightbend.
Licensed under the Apache License, Version 2.0.
https://www.scala-lang.org/api/2.12.9/scala/collection/parallel/SeqSplitter$Mapped.html