Класс scala.collection.parallel.SeqSplitter.Taken
класс Taken extends SeqSplitter.Taken с SeqSplitter[T]
- Источник
- RemainsIterator.scala
Конструкторы экземпляров
новый Taken(tk: Int)
Типовые члены
класс 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
- Неявный
- Этот член добавляется неявным преобразованием из Taken в any2stringadd[Taken] с помощью метода any2stringadd в scala.Predef.
- Классы-определения
- any2stringadd
def ++(that: ⇒ Iterator[T]): Iterator[T]
Конкатенация этого итератора с другим.
- that
другой итератор
- возвращает
новый итератор, который сначала возвращает значения, генерируемые этим итератором, а затем значения, генерируемые итератором
that.
- Классы-определения
- Iterator
def ->[B](y: B): (Taken, B)
- Неявный
- Этот член добавляется неявным преобразованием из Taken в ArrowAssoc[Taken] с помощью метода ArrowAssoc в scala.Predef.
- Классы-определения
- ArrowAssoc
- Аннотации
- @inline()
def /:[B](z: B)(op: (B, T) ⇒ B): B
Применение бинарного оператора к начальному значению и всем элементам этого обходчика или итератора слева направо.
Примечание: /: — альтернативная синтаксическая конструкция для 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: (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— элементы этого обходчика или итератора.
- Классы-определения
- 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.
- 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): Taken.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: BufferedIterator[T]
Создает буферизованный итератор из этого итератора.
- returns
буферизованный итератор, генерирующий те же значения, что и этот итератор.
- Definition Classes
- Iterator
- Примечание
Переиспользование: После вызова этого метода необходимо удалить вызываемый итератор, и использовать только возвращенный итератор. Использование старого итератора является неопределенным, может меняться и может привести к изменениям в новом итераторе.
- См. также
def buildString(closure: ((String) ⇒ Unit) ⇒ Unit): String
- Attributes
- 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]
Находит первый элемент итерации или Traversable, для которого заданная частичная функция определена, и применяет её к нему.
Примечание: может не завершиться для коллекций бесконечного размера.
Примечание: может возвращать различные результаты для разных запусков, если тип коллекции не упорядочен.
- 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
условие предиката, которое связывает элементы из обеих коллекций
- возвращает
trueесли обе коллекции имеют одинаковую длину иp(x, y)являетсяtrueдля всех соответствующих элементовxэтого итератора иythat, в противном случаеfalse
- Definition Classes
- Iterator
def count(p: (T) ⇒ Boolean): Int
Подсчитывает количество элементов в обозримом объекте или итераторе, которые удовлетворяют условию предиката.
- p
предикат, используемый для проверки элементов.
- возвращает
количество элементов, удовлетворяющих условию предиката
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: SeqSplitter[T]
Создаёт копию этого итератора.
- Классы-определения
- Taken → SeqSplitter → Taken → IterableSplitter
def duplicate: (Iterator[T], Iterator[T])
Создаёт два новых итератора, которые оба итерируют по тем же элементам, что и этот итератор (в том же порядке). Дублирующие итераторы считаются равными, если они находятся на том же элементе.
Учитывая, что большинство методов для итераторов сделают исходный итератор непригодным для дальнейшего использования, этот метод предоставляет надёжный способ вызова нескольких таких методов для итератора.
- возвращает
пара итераторов
- Классы-определения
- Iterator
- Примечание
-
Реализация может выделять временное хранилище для элементов, проитерированных одним итератором, но ещё не другим.
,Использование: после вызова этого метода следует удалить итератор, на котором он был вызван, и использовать только возвращённые итераторы. Использование старого итератора не определено, может измениться и может привести к изменениям в новых итераторах тоже.
def ensuring(cond: (Taken) ⇒ Boolean, msg: ⇒ Any): Taken
- Неявный
- Этот член добавлен неявным преобразованием из Taken в Ensuring[Taken] при помощи метода Ensuring в scala.Predef.
- Классы-определения
- Ensuring
def ensuring(cond: (Taken) ⇒ Boolean): Taken
- Неявный
- Этот член добавлен неявным преобразованием из Taken в Ensuring[Taken] при помощи метода Ensuring в scala.Predef.
- Классы-определения
- Ensuring
def ensuring(cond: Boolean, msg: ⇒ Any): Taken
- Неявный
- Этот член добавлен неявным преобразованием из Taken в Ensuring[Taken] при помощи метода Ensuring в scala.Predef.
- Классы-определения
- Ensuring
def ensuring(cond: Boolean): Taken
- Неявный
- Этот член добавлен неявным преобразованием из Taken в Ensuring[Taken] при помощи метода Ensuring в scala.Predef.
- Классы-определения
- Ensuring
final def eq(arg0: AnyRef): Boolean
Проверяет, является ли аргумент (that) ссылкой на объект-получатель (this).
Метод eq реализует отношение эквивалентности на не-null экземплярах AnyRef, и обладает тремя дополнительными свойствами:
-
Он является согласованным: для любых не-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
предикат, используемый для проверки значений.
- returns
значение Option, содержащее первое значение, производимое итератором, которое удовлетворяет предикату
p, илиNone, если таковое не существует.
- Definition Classes
- Iterator → TraversableOnce → GenTraversableOnce
- Note
Повторное использование: после вызова этого метода следует удалить итератор, на котором он был вызван. Использование старого итератора не определено, может измениться и может привести к изменениям в новом итераторе.
def flatMap[B](f: (T) ⇒ GenTraversableOnce[B]): Iterator[B]
Создает новый итератор, применяя функцию ко всем значениям, производимым этим итератором, и конкатенируя результаты.
- f
функция для применения к каждому элементу.
- returns
итератор, полученный в результате применения заданной функции, возвращающей итератор
fк каждому значению, производимому этим итератором, и конкатенации результатов.
- Definition Classes
- Iterator
- Note
Повторное использование: после вызова этого метода следует удалить итератор, на котором он был вызван, и использовать только возвращенный итератор. Использование старого итератора не определено, может измениться и может привести к изменениям в новом итераторе.
def flatmap2combiner[S, That](f: (T) ⇒ GenTraversableOnce[S], cb: Combiner[S, That]): Combiner[S, That]
- Definition Classes
- AugmentedIterableIterator
def fold[U >: T](z: U)(op: (U, U) ⇒ U): U
Вычисляет слияние элементов этого итератора или обходного объекта с использованием указанного ассоциативного бинарного оператора.
Порядок выполнения операций над элементами не определен и может быть не детерминированным.
Примечание: не будет завершаться для бесконечных итераторов.
- z
нейтральный элемент для операции fold; может быть добавлен к результату любое количество раз, и не должен изменять результат (например,
Nilдля конкатенации списков, 0 для сложения или 1 для умножения).- op
бинарный оператор, который должен быть ассоциативным.
- returns
результат применения оператора fold
opмежду всеми элементами иz, илиzесли этот обходной объект или итератор пуст.
- Definition Classes
- AugmentedIterableIterator → TraversableOnce → GenTraversableOnce
def foldLeft[B](z: B)(op: (B, T) ⇒ B): B
Применяет бинарный оператор к начальному значению и всем элементам этого обходного объекта или итератора, слева направо.
Примечание: не будет завершаться для бесконечно больших коллекций.
Примечание: может возвращать разные результаты для разных запусков, если тип базовой коллекции не упорядочен или оператор не ассоциативен и коммутативен.
- B
тип результата бинарного оператора.
- z
начальное значение.
- op
бинарный оператор.
- returns
-
результат вставки
opмежду последовательными элементами этого обходного объекта или итератора, слева направо с начальным значениемzслева:op(...op(z, x_1), x_2, ..., x_n)
где
x1, ..., xn- это элементы этого обходного объекта или итератора. Возвращаетzесли этот обходной объект или итератор пуст.
- Definition Classes
- TraversableOnce → GenTraversableOnce
def foldRight[B](z: B)(op: (T, B) ⇒ B): B
Применяет бинарный оператор ко всем элементам этого обходного объекта или итератора и начальному значению, справа налево.
Примечание: не будет завершаться для бесконечно больших коллекций.
Примечание: может возвращать разные результаты для разных запусков, если тип базовой коллекции не упорядочен или оператор не ассоциативен и коммутативен.
- B
тип результата бинарного оператора.
- z
начальное значение.
- op
бинарный оператор.
- returns
-
результат вставки
opмежду последовательными элементами этого обходного объекта или итератора, справа налево с начальным значениемzсправа:op(x_1, op(x_2, ... op(x_n, z)...))
где
x1, ..., xn- это элементы этого обходного объекта или итератора. Возвращаетzесли этот обходной объект или итератор пуст.
- Definition Classes
- TraversableOnce → GenTraversableOnce
def forall(p: (T) ⇒ Boolean): Boolean
Проверяет, выполняется ли предикат для всех значений, производимых этим итератором.
Примечание: может не завершиться для бесконечных итераторов.
- p
предикат, используемый для проверки элементов.
- returns
trueесли заданный предикатpвыполняется для всех значений, производимых этим итератором, в противном случаеfalse.
- Definition Classes
- Iterator → TraversableOnce → GenTraversableOnce
- Note
Повторное использование: после вызова этого метода необходимо удалить итератор, на котором он был вызван. Использование его не определено и может быть изменено.
def foreach(f: (T) ⇒ Unit): Unit
Применяет функцию f ко всем значениям, производимым этим итератором.
- f
функция, которая применяется для своего побочного эффекта к каждому элементу. Результат функции
fигнорируется.
- Definition Classes
- Iterator → TraversableOnce → GenTraversableOnce
def formatted(fmtstr: String): String
Возвращает строку, отформатированную в соответствии с заданной format строкой. Форматные строки такие же, как у String.format (@см. java.lang.String.format).
- Неявный
- Этот член добавляется неявным преобразованием из Taken в StringFormat[Taken] с помощью метода StringFormat в scala.Predef.
- Definition Classes
- StringFormat
- Аннотации
- @inline()
final def getClass(): Class[_]
Возвращает представление класса во время выполнения объекта.
- returns
объект класса, соответствующий типу времени выполнения получателя.
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
- 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.
- returns
значение хэш-кода для этого объекта.
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в противном случае.
- 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
- Note
Переиспользование: После вызова этого метода следует удалить итератор, на котором он был вызван. Его использование не определено и может измениться.
def map[S](f: (T) ⇒ S): Mapped[S]
Создаёт новый итератор, отображающий все произведённые значения этого итератора в новые значения с помощью функции преобразования.
- f
функция преобразования
- returns
новый итератор, преобразующий каждое значение, производимое этим итератором, путём применения функции
fк нему.
- Definition Classes
- SeqSplitter → IterableSplitter → Iterator
- Note
Переиспользование: После вызова этого метода следует удалить итератор, на котором он был вызван, и использовать только возвращённый итератор. Использование старого итератора является неопределённым, может измениться и может привести к изменениям в новом итераторе тоже.
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.
- Definition Classes
- TraversableOnce → GenTraversableOnce
List(1, 2, 3).mkString("|") = "1|2|3"
def mkString(start: String, sep: String, end: String): String
Отображает все элементы этого итерируемого объекта или итератора в строке с использованием строк start, end и разделителя.
- 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(): T
Возвращает следующий элемент этого итератора.
- 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: T): Iterator[T]
Добавляет значение элемента к этому итератору до тех пор, пока не будет достигнута заданная целевая длина.
- len
целевая длина
- elem
значение заполнения
- returns
новый итератор, состоящий из всех значений этого итератора, за которым следует минимальное количество вхождений
elem, чтобы количество созданных значений было не меньшеlen.
- Definition Classes
- Iterator
def partition(p: (T) ⇒ Boolean): (Iterator[T], Iterator[T])
Разделяет этот итератор на два итератора в соответствии с предикатом.
- p
предикат для разделения
- returns
пара итераторов: итератор, удовлетворяющий предикату
p, и итератор, который этого не делает. Относительный порядок элементов в результирующих итераторах такой же, как и в исходном итераторе.
- Definition Classes
- 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
- Note
Переиспользование: После вызова этого метода следует удалить итератор, на котором он был вызван, а также переданный в качестве параметра, и использовать только возвращённый итератор. Использование старых итераторов не определено, может быть изменено и может привести к изменениям в новом итераторе тоже.
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
Перемножает элементы этого набора.
- returns
произведение всех элементов в этом наборе или итераторе чисел типа
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
размеры, используемые для разбиения этого итератора параллельных последовательностей на итераторы, которые просматривают непересекающиеся подмножества
- returns
последовательность итераторов непересекающихся подпоследовательностей этого параллельного итератора
- Definition Classes
- Taken → 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являются элементами этого обхода или итератора.
- Определяющие классы
- TraversableOnce
- Выбрасываемые исключения
UnsupportedOperationExceptionесли этот обход или итератор пуст.
def reduceLeftOption[B >: T](op: (B, T) ⇒ B): Option[B]
Необязательно применяет бинарный оператор ко всем элементам этого обхода или итератора, слева направо.
Примечание: не будет завершаться для коллекций бесконечного размера.
Примечание: может возвращать разные результаты для разных запусков, если только базовый тип коллекции не упорядочен или оператор не является ассоциативным и коммутативным.
- B
тип результата бинарного оператора.
- op
бинарный оператор.
- returns
необязательное значение, содержащее результат
reduceLeft(op), если этот обход или итератор не пуст,Noneв противном случае.
- Определяющие классы
- TraversableOnce → GenTraversableOnce
def reduceOption[A1 >: T](op: (A1, A1) ⇒ A1): Option[A1]
Сводит элементы этого обхода или итератора, если таковые имеются, используя указанный ассоциативный бинарный оператор.
Порядок, в котором выполняются операции над элементами, не указан и может быть недетерминированным.
- A1
Параметр типа для бинарного оператора, супертип
A.- op
Бинарный оператор, который должен быть ассоциативным.
- returns
Необязательное значение, содержащее результат применения оператора reduce
opко всем элементам, если коллекция не пуста, иNoneв противном случае.
- Определяющие классы
- 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являются элементами этого обхода или итератора.
- Определяющие классы
- TraversableOnce → GenTraversableOnce
- Выбрасываемые исключения
UnsupportedOperationExceptionесли этот обход или итератор пуст.
def reduceRightOption[B >: T](op: (T, B) ⇒ B): Option[B]
Необязательно применяет бинарный оператор ко всем элементам этого обхода или итератора, справа налево.
Примечание: не будет завершаться для коллекций бесконечного размера.
Примечание: может возвращать разные результаты для разных запусков, если только базовый тип коллекции не упорядочен или оператор не является ассоциативным и коммутативным.
- B
тип результата бинарного оператора.
- op
бинарный оператор.
- returns
необязательное значение, содержащее результат
reduceRight(op), если этот обход или итератор не пуст,Noneв противном случае.
- Определяющие классы
- TraversableOnce → GenTraversableOnce
var remaining: Int
Количество элементов, которые этому итератору еще предстоит пройти. Этот метод не изменяет состояние итератора.
Этот метод используется для предоставления подсказок о размере строителям и комбинирующим элементам, а также для приблизительного определения позиций итераторов внутри структуры данных.
Примечание: этот метод может быть реализован для возврата верхней границы количества элементов в итераторе, а не точного количества элементов для итерации. Параллельные коллекции, имеющие такие итераторы, называются коллекциями с нестрогими разделителями.
В этом случае необходимо учитывать 2 момента:
1) классы, наследующие ParIterable, должны переопределять методы take, drop, slice, splitAt, copyToArray и все остальные, использующие эту информацию.
2) если итератор предоставляет верхнюю границу количества элементов, то после разделения сумма значений remaining разделенных итераторов должна быть меньше или равна этой верхней границе.
- Определяющие классы
- Taken → 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
- Note
Переиспользование: После вызова этого метода следует отбросить итератор, на котором он был вызван, а также переданный в качестве параметра. Использование старых итераторов не определено и может измениться.
def scanLeft[B](z: B)(op: (B, T) ⇒ B): Iterator[B]
Возвращает коллекцию, содержащую кумулятивные результаты применения оператора слева направо, включая начальное значение.
Примечание: не будет завершаться для бесконечных итераторов.
Примечание: может возвращать разные результаты для разных запусков, если тип базовой коллекции не упорядочен.
- B
тип элементов в результирующей коллекции
- z
начальное значение
- op
бинарный оператор, применяемый к промежуточному результату и элементу
- returns
итератор с промежуточными результатами
- Definition Classes
- Iterator
- Note
Переиспользование: После вызова этого метода следует отбросить итератор, на котором он был вызван, и использовать только возвращенный итератор. Использование старого итератора не определено, может измениться и может привести к изменениям в новом итераторе.
def scanRight[B](z: B)(op: (T, B) ⇒ B): Iterator[B]
Возвращает коллекцию, содержащую кумулятивные результаты применения оператора справа налево. Голова коллекции — это последний кумулятивный результат.
Примечание: не будет завершаться для бесконечных итераторов.
Примечание: может возвращать разные результаты для разных запусков, если тип базовой коллекции не упорядочен.
- B
тип элементов в результирующей коллекции
- z
начальное значение
- op
бинарный оператор, применяемый к промежуточному результату и элементу
- returns
итератор с промежуточными результатами
- Definition Classes
- Iterator
- Note
Переиспользование: После вызова этого метода следует отбросить итератор, на котором он был вызван, и использовать только возвращенный итератор. Использование старого итератора не определено, может измениться и может привести к изменениям в новом итераторе.
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]
A version of this collection with all of the operations implemented sequentially (i.e., in a single-threaded manner).
This method returns a reference to this collection. In parallel collections, it is redefined to return a sequential implementation of this collection. In both cases, it has O(1) complexity.
- returns
a sequential view of the collection.
- Definition Classes
- Iterator → TraversableOnce → GenTraversableOnce
def setIndexFlag(f: Int): Unit
Устанавливает значение флага индекса.
Флаг индекса хранит целое число, которое имеет определённый смысл, специфичный для операции. Например, операция takeWhile устанавливает флаг индекса в позицию элемента, где предикат терпит неудачу. Другие рабочие процессы могут сравнить этот индекс с индексами, над которыми они работают, и вернуть, если этот индекс меньше их индекса. Примеры операций, использующих это, — takeWhile, dropWhile, span и indexOf.
- f
значение, которое нужно установить для флага индекса.
- Definition Classes
- DelegatedSignalling → Signalling
def setIndexFlagIfGreater(f: Int): Unit
Устанавливает значение флага индекса, если аргумент больше текущего значения. Этот метод делает это атомарно.
Флаг индекса хранит целое число, которое имеет определённый смысл, специфичный для операции. Например, операция 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
Размер этого набора или итератора, если его можно вычислить быстро.
- возвращает
количество элементов в этом наборе или итераторе, или -1, если размер нельзя определить быстро
- Атрибуты
- protected[collection]
- Определяющие классы
- GenTraversableOnce
def slice(from1: Int, until1: Int): SeqSplitter[T]
Создаёт итератор, возвращающий интервал значений, производимых этим итератором.
- возвращает
итератор, который продвигает этот итератор мимо первых
fromэлементов с использованиемdrop, а затем берётuntil - fromэлементов, используяtake.
- Определяющие классы
- SeqSplitter → IterableSplitter → Iterator
- Примечание
Переиспользование: После вызова этого метода следует удалить итератор, на котором он был вызван, и использовать только возвращённый итератор. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новом итераторе тоже.
def slice2combiner[U >: T, This](from: Int, until: Int, cb: Combiner[U, This]): Combiner[U, This]
- Определяющие классы
- AugmentedIterableIterator
def sliceIterator(from: Int, until: Int): Iterator[T]
Создаёт необязательно ограниченный срез, неограниченный, если until отрицательно.
- Атрибуты
- protected
- Определяющие классы
- Iterator
def sliding[B >: T](size: Int, step: Int = 1): GroupedIterator[B]
Возвращает итератор, представляющий «скользящее окно» вид этого итератора. Первый аргумент — размер окна, а второй аргумент step — это расстояние, на которое нужно продвигать окно на каждой итерации. step по умолчанию 1.
Значение по умолчанию GroupedIterator можно настроить, чтобы дополнить частичный результат до размера size или полностью подавить частичный результат.
Примеры использования:
// Returns List(List(1, 2, 3), List(2, 3, 4), List(3, 4, 5)) (1 to 5).iterator.sliding(3).toList // Returns List(List(1, 2, 3, 4), List(4, 5)) (1 to 5).iterator.sliding(4, 3).toList // Returns List(List(1, 2, 3, 4)) (1 to 5).iterator.sliding(4, 3).withPartial(false).toList // Returns List(List(1, 2, 3, 4), List(4, 5, 20, 25)) // Illustrating that withPadding's argument is by-name. val it2 = Iterator.iterate(20)(_ + 5) (1 to 5).iterator.sliding(4, 3).withPadding(it2.next).toList
- возвращает
Итератор, генерирующий
Seq[B]размеромsize, за исключением последнего элемента (который может быть единственным элементом), который будет усечён, если оставшихся элементов для группировки меньше, чемsize. Это поведение можно настроить.
- Определяющие классы
- Iterator
- Примечание
Переиспользование: После вызова этого метода следует удалить итератор, на котором он был вызван, и использовать только возвращённый итератор. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новом итераторе тоже.
def span(p: (T) ⇒ Boolean): (Iterator[T], Iterator[T])
Разделяет этот итератор на пару префикс/суффикс в соответствии с предикатом.
- p
тестовый предикат
- возвращает
пару итераторов, состоящих из самого длинного префикса этого, чьи элементы все удовлетворяют
p, и остальная часть итератора.
- Определяющие классы
- Iterator
- Примечание
Переиспользование: После вызова этого метода следует удалить итератор, на котором он был вызван, и использовать только возвращённые итераторы. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новых итераторах тоже.
def span2combiners[U >: T, This](p: (T) ⇒ Boolean, before: Combiner[U, This], after: Combiner[U, This]): (Combiner[U, This], Combiner[U, This])
- Определяющие классы
- AugmentedIterableIterator
def split: scala.Seq[SeqSplitter[T]]
Разделяет итератор на последовательность непересекающихся представлений.
Возвращает последовательность разделенных итераторов, каждый из которых перебирает некоторое подмножество элементов в коллекции. Эти подмножества не пересекаются и должны быть примерно равны по размеру. Эти подмножества не пустые, если только итератор не пустой, в этом случае этот метод возвращает последовательность с одним пустым итератором. Если разделитель имеет более двух элементов, этот метод вернёт два или более разделителя.
Реализаторам рекомендуется сохранять это разбиение относительно небольшим - двух разделителей уже достаточно при разбиении коллекции, хотя их может быть немного больше.
Примечание: этот метод фактически делает текущий разделитель недействительным.
- returns
последовательность непересекающихся итераторов коллекции
- Definition Classes
- Taken → SeqSplitter → PreciseSplitter → Taken → IterableSplitter → Splitter
def splitAt2combiners[U >: T, This](at: Int, before: Combiner[U, This], after: Combiner[U, This]): (Combiner[U, This], Combiner[U, This])
- Definition Classes
- AugmentedIterableIterator
def splitWithSignalling: scala.Seq[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 takeSeq[PI <: IterableSplitter[T]](sq: scala.Seq[PI])(taker: (PI, Int) ⇒ PI): Seq[PI]
- Attributes
- protected[this]
- Definition Classes
- Taken
def takeWhile(p: (T) ⇒ Boolean): Iterator[T]
Берет самый длинный префикс значений, производимых этим итератором, которые удовлетворяют предикату.
- p
Предикат, используемый для проверки элементов.
- returns
Итератор, возвращающий значения, производимые этим итератором, пока этот итератор производит значения, удовлетворяющие предикату
p.
- Definition Classes
- Iterator
- Note
Переиспользование: После вызова этого метода следует удалить итератор, на котором он был вызван, и использовать только возвращённый итератор. Использование старого итератора не определено, может измениться и может привести к изменениям в новом итераторе.
def takeWhile2combiner[U >: T, This](p: (T) ⇒ Boolean, cb: Combiner[U, This]): (Combiner[U, This], Boolean)
- Definition Classes
- AugmentedIterableIterator
def to[Col[_]]: Col[A]
Преобразует это итерабельное или итераторное множество в другое, копируя все элементы.
Примечание: не будет завершаться для бесконечных итераторов.
- Col
Тип коллекции для построения.
- returns
новая коллекция, содержащая все элементы этого итерабельного или итераторного множества.
- Definition Classes
- TraversableOnce → GenTraversableOnce
def toArray: Array[A]
Преобразует это итерабельное или итераторное множество в массив.
Примечание: не будет завершаться для бесконечных итераторов.
- returns
массив, содержащий все элементы этого итерабельного или итераторного множества. Для типа элемента этого итерабельного или итераторного множества должен быть доступен
ClassTag.
- Definition Classes
- TraversableOnce → GenTraversableOnce
def toBuffer[B >: T]: Buffer[B]
Использует содержимое этого итерабельного или итераторного множества для создания нового изменяемого буфера.
Примечание: не будет завершаться для бесконечно больших коллекций.
- returns
буфер, содержащий все элементы этого итерабельного или итераторного множества.
- Definition Classes
- TraversableOnce → GenTraversableOnce
def toIndexedSeq: immutable.IndexedSeq[T]
Преобразует это итерабельное или итераторное множество в индексированную последовательность.
Примечание: не будет завершаться для бесконечно больших коллекций.
- returns
индексированная последовательность, содержащая все элементы этого итерабельного или итераторного множества.
- Definition Classes
- TraversableOnce → GenTraversableOnce
def toIterable: Iterable[T]
Преобразует это итерабельное или итераторное множество в итерабельную коллекцию. Обратите внимание, что выбор целевого Iterable является ленивым в этой реализации по умолчанию, так как это TraversableOnce может быть ленивым и невычисленным (т.е. это может быть итератор, который можно проходить только один раз).
Примечание: не будет завершаться для бесконечно больших коллекций.
- returns
Iterableсодержащий все элементы этого итерабельного или итераторного множества.
- Definition Classes
- TraversableOnce → GenTraversableOnce
def toIterator: Iterator[T]
Возвращает итератор по элементам в этом итерабельном или итераторном множестве. Возвращает тот же итератор, если этот экземпляр уже является итератором.
Примечание: не будет завершаться для бесконечных итераторов.
- returns
итератор, содержащий все элементы этого итерабельного или итераторного множества.
- Definition Classes
- Iterator → GenTraversableOnce
def toList: List[T]
Преобразует это итерабельное или итераторное множество в список.
Примечание: не будет завершаться для бесконечно больших коллекций.
- returns
список, содержащий все элементы этого итерабельного или итераторного множества.
- Definition Classes
- TraversableOnce → GenTraversableOnce
def toMap[T, U]: Map[T, U]
Преобразует этот итерируемый объект или итератор в карту. Этот метод недоступен, если элементы не являются членами Tuple2, каждый ((T, U)) становится парой ключ-значение в карте. Повторные ключи будут перезаписаны последующими ключами: если это неупорядоченная коллекция, ключ в результирующей карте не определен.
Примечание: не будет завершаться для бесконечных итераторов.
- возвращает
карту типа
immutable.Map[T, U]содержащую все пары ключ/значение типа(T, U)этого итерируемого объекта или итератора.
- Определяющие классы
- TraversableOnce → GenTraversableOnce
def toParArray: ParArray[T]
- Неявный
- Этот член добавлен неявным преобразованием из Taken в CollectionsHaveToParArray[Taken, T] выполненным методом CollectionsHaveToParArray в scala.collection.parallel. Это преобразование произойдет только в том случае, если в области видимости имеется неявное значение типа (Taken) ⇒ GenTraversableOnce[T].
- Определяющие классы
- CollectionsHaveToParArray
def toSeq: Seq[T]
Преобразует этот итерируемый объект или итератор в последовательность. Как и в toIterable, по умолчанию он ленивый, так как этот TraversableOnce может быть ленивым и невычисленным.
Примечание: не будет завершаться для коллекций бесконечного размера.
- возвращает
последовательность, содержащую все элементы этого итерируемого объекта или итератора.
- Определяющие классы
- TraversableOnce → GenTraversableOnce
def toSet[B >: T]: immutable.Set[B]
Преобразует этот итерируемый объект или итератор в множество.
Примечание: не будет завершаться для коллекций бесконечного размера.
- возвращает
множество, содержащее все элементы этого итерируемого объекта или итератора.
- Определяющие классы
- TraversableOnce → GenTraversableOnce
def toStream: immutable.Stream[T]
Преобразует этот итерируемый объект или итератор в поток.
- возвращает
поток, содержащий все элементы этого итерируемого объекта или итератора.
- Определяющие классы
- Iterator → GenTraversableOnce
def toString(): String
Преобразует этот итератор в строку.
- возвращает
"<iterator>"пуст ли итератор или нет.
def toTraversable: Traversable[T]
Преобразует этот итерируемый объект или итератор в неопределённый Traversable. Вернёт ту же коллекцию, если этот экземпляр уже Traversable.
Примечание: не будет завершаться для бесконечных итераторов.
- возвращает
Traversable, содержащий все элементы этого итерируемого объекта или итератора.
- Определяющие классы
- Iterator → TraversableOnce → GenTraversableOnce
def toVector: Vector[T]
Преобразует этот итерируемый объект или итератор в Vector.
Примечание: не будет завершаться для коллекций бесконечного размера.
- возвращает
вектор, содержащий все элементы этого итерируемого объекта или итератора.
- Определяющие классы
- 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
предикат для проверки значений.
- возвращает
итератор, возвращающий те значения из этого итератора, которые удовлетворяют предикату
p.
- Классы-определения
- Iterator
- Примечание
Переиспользование: После вызова этого метода следует удалить итератор, на котором он был вызван, и использовать только возвращённый итератор. Использование старого итератора является неопределённым, может измениться и может привести к изменениям в новом итераторе.
def zip[B](that: Iterator[B]): Iterator[(T, B)]
Создаёт итератор, составленный из этого и другого итератора, объединяя соответствующие значения в пары. Если один из итераторов длиннее другого, его оставшиеся элементы игнорируются.
- that
Итератор, предоставляющий вторую половину каждой пары результатов
- возвращает
новый итератор, содержащий пары, состоящие из соответствующих элементов этого итератора и
that. Количество элементов, возвращаемых новым итератором, является минимальным из количества элементов, возвращаемых этим итератором иthat.
- Классы-определения
- Iterator
- Примечание
Переиспользование: После вызова этого метода следует удалить итератор, на котором он был вызван, а также переданный в качестве параметра, и использовать только возвращённый итератор. Использование старых итераторов является неопределённым, может измениться и может привести к изменениям в новом итераторе.
def zip2combiner[U >: T, S, That](otherpit: RemainsIterator[S], cb: Combiner[(U, S), That]): Combiner[(U, S), That]
- Классы-определения
- AugmentedIterableIterator
def zipAll[B](that: Iterator[B], thisElem: T, thatElem: B): Iterator[(T, B)]
Создаёт итератор, составленный из этого и другого итератора, объединяя соответствующие элементы в пары. Если один из итераторов короче другого, для заполнения используются заполнительные элементы.
- that
итератор
thatможет иметь другую длину, чем итератор само.- thisElem
элемент
thisElemиспользуется для заполнения результирующего итератора, если итератор само корочеthat- thatElem
элемент
thatElemиспользуется для заполнения результирующего итератора, еслиthatкороче итератора само- возвращает
новый итератор, содержащий пары, состоящие из соответствующих значений этого итератора и
that. Длина возвращённого итератора равна максимальной из длин этого итератора иthatЕсли этот итератор корочеthat,thisElemзначения используются для заполнения результата. Еслиthatкороче этого итератора,thatElemзначения используются для заполнения результата.
- Классы-определения
- Iterator
def zipAll2combiner[U >: T, S, That](that: RemainsIterator[S], thiselem: U, thatelem: S, cb: Combiner[(U, S), That]): Combiner[(U, S), That]
- Классы-определения
- AugmentedIterableIterator
def zipAllParSeq[S, U >: T, R >: S](that: SeqSplitter[S], thisElem: U, thatElem: R): ZippedAll[U, R]
- Definition Classes
- SeqSplitter → IterableSplitter
def zipParSeq[S](that: SeqSplitter[S]): Zipped[S]
- Definition Classes
- SeqSplitter → IterableSplitter
def zipWithIndex: Iterator[(T, Int)]
Создаёт итератор, который парсит каждый элемент, полученный этим итератором, со своим индексом, начиная со значения 0.
- returns
новый итератор, содержащий пары, состоящие из соответствующих элементов этого итератора и их индексов.
- Definition Classes
- Iterator
- Note
Повторное использование: после вызова этого метода следует удалить итератор, на котором он был вызван, и использовать только возвращённый итератор. Использование старого итератора не определено, может измениться и может привести к изменениям в новом итераторе также.
def →[B](y: B): (Taken, B)
- Implicit
- Этот член добавлен неявным преобразованием из Taken в ArrowAssoc[Taken] с помощью метода ArrowAssoc в scala.Predef.
- Definition Classes
- ArrowAssoc
Затенённые неявные члены значения
def filter(p: (T) ⇒ Boolean): TraversableOnce[T]
- Неявный
- Этот член добавлен неявным преобразованием из Taken в MonadOps[T] с помощью метода MonadOps в scala.collection.TraversableOnce.
- Затенение
- Этот неявный унаследованный член затеневается одним или несколькими членами в этом классе.
Для доступа к этому члену можно использовать приведение типа:(taken: MonadOps[T]).filter(p)
- Классы-определения
- MonadOps
def flatMap[B](f: (T) ⇒ GenTraversableOnce[B]): TraversableOnce[B]
- Неявный
- Этот член добавлен неявным преобразованием из Taken в MonadOps[T] с помощью метода MonadOps в scala.collection.TraversableOnce.
- Затенение
- Этот неявный унаследованный член затеневается одним или несколькими членами в этом классе.
Для доступа к этому члену можно использовать приведение типа:(taken: MonadOps[T]).flatMap(f)
- Классы-определения
- MonadOps
def map[B](f: (T) ⇒ B): TraversableOnce[B]
- Неявный
- Этот член добавлен неявным преобразованием из Taken в MonadOps[T] с помощью метода MonadOps в scala.collection.TraversableOnce.
- Затенение
- Этот неявный унаследованный член затеневается одним или несколькими членами в этом классе.
Для доступа к этому члену можно использовать приведение типа:(taken: MonadOps[T]).map(f)
- Классы-определения
- MonadOps
def withFilter(p: (T) ⇒ Boolean): Iterator[T]
- Неявный
- Этот член добавлен неявным преобразованием из Taken в MonadOps[T] с помощью метода MonadOps в scala.collection.TraversableOnce.
- Затенение
- Этот неявный унаследованный член затеневается одним или несколькими членами в этом классе.
Для доступа к этому члену можно использовать приведение типа:(taken: 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/SeqSplitter$Taken.html