Trait scala.collection.parallel.PreciseSplitter
trait PreciseSplitter[+T] extends Splitter[T]
Типовые члены
class GroupedIterator[B >: A] extends AbstractIterator[Seq[B]] with Iterator[Seq[B]]
Гибкий итератор для преобразования Iterator[A] в Iterator[Seq[A]], с настраиваемым размером последовательности, шагом и стратегией для обработки элементов, которые не помещаются равномерно.
Типичные использования могут быть достигнуты с помощью методов grouped и sliding.
- Definition Classes
- Iterator
Абстрактные члены значения
abstract def hasNext: Boolean
Проверяет, может ли этот итератор предоставить другой элемент.
- returns
trueесли последующий вызовnextвернёт элемент,falseв противном случае.
- Definition Classes
- Iterator
- Note
Повторное использование: итератор остаётся допустимым для дальнейшего использования независимо от возвращаемого результата.
abstract def next(): T
Возвращает следующий элемент этого итератора.
- returns
следующий элемент этого итератора, если
hasNextравенtrue, в противном случае поведение не определено.
- Definition Classes
- Iterator
- Note
Повторное использование: итератор остаётся допустимым для дальнейшего использования независимо от возвращаемого результата.
abstract def psplit(sizes: Int*): Seq[PreciseSplitter[T]]
Разделяет разделитель на непересекающиеся представления.
Эта перегруженная версия метода split специфична для точных разделителей. Она возвращает последовательность разделителей, каждый из которых итерирует некоторое подмножество элементов в этом разделителе. Размеры подразделителей в разбиении равны размеру в соответствующем аргументе, если в этом разделителе достаточно элементов для такого разделения.
Если элементов недостаточно, для каждого дополнительного аргумента добавляется разделитель с нулевыми элементами. Если есть дополнительные элементы, добавляется дополнительный разделитель в конце для компенсации.
Например, предположим, что у нас есть разделитель ps с 100 элементами. Вызов:
ps.split(50, 25, 25, 10, 5)
вернёт последовательность из пяти разделителей, последние два из которых пустые. С другой стороны, вызов:
ps.split(50, 40)
вернёт последовательность из трёх разделителей, последний из которых содержит десять элементов.
Примечание: этот метод фактически делает текущий разделитель недействительным.
В отличие от случая с split в разделителях, представления, возвращаемые этим методом, могут быть пустыми.
- sizes
размеры, используемые для разделения этого итератора разбиения на итераторы, которые обходят непересекающиеся подмножества
- returns
последовательность непересекающихся итераторов подпоследовательностей этого параллельного итератора
abstract def split: Seq[PreciseSplitter[T]]
Разделяет итератор на последовательность непересекающихся представлений.
Возвращает последовательность итераторов разбиений, каждый из которых итерирует некоторое подмножество элементов в коллекции. Эти подмножества являются непересекающимися и должны быть примерно одинаковыми по размеру. Эти подмножества не пустые, за исключением случая, когда итератор пуст, в этом случае метод возвращает последовательность с одним пустым итератором. Если у разделителя более двух элементов, этот метод вернёт два или более разделителя.
Реализаторам рекомендуется хранить это разбиение относительно небольшим - два разделителя уже достаточно при разбиении коллекции, хотя может быть и несколько больше.
Примечание: этот метод фактически делает текущий разделитель недействительным.
- returns
последовательность непересекающихся итераторов коллекции
- Definition Classes
- PreciseSplitter → Splitter
Члены-значения конкретного типа
final def !=(arg0: Any): Boolean
Проверка двух объектов на неравенство.
- returns
trueесли !(this == that), в противном случае false.
- Definition Classes
- AnyRef → Any
final def ##(): Int
Эквивалентно x.hashCode за исключением упакованных числовых типов и null. Для числовых типов возвращает хэш-значение, согласованное с равенством значений: если два экземпляра типа значения сравниваются как true, то ## вернет одинаковое хэш-значение для каждого из них. Для null возвращает хэш-код, где null.hashCode выбрасывает NullPointerException.
- returns
значение хэша, согласованное с ==
- Definition Classes
- AnyRef → Any
def +(other: String): String
- Неявный
- Этот член добавлен с помощью неявного преобразования из PreciseSplitter[T] в any2stringadd[PreciseSplitter[T]], выполненное методом any2stringadd в scala.Predef.
- Definition Classes
- any2stringadd
def ++(that: ⇒ Iterator[T]): Iterator[T]
Конкатенация этого итератора с другим.
- that
другой итератор
- returns
новый итератор, который сначала возвращает значения, производимые этим итератором, а затем значения, производимые итератором
that.
- Definition Classes
- Iterator
def ->[B](y: B): (PreciseSplitter[T], B)
- Неявный
- Этот член добавлен с помощью неявного преобразования из PreciseSplitter[T] в ArrowAssoc[PreciseSplitter[T]] выполненное методом ArrowAssoc в scala.Predef.
- Definition Classes
- ArrowAssoc
- Аннотации
- @inline()
def /:[B](z: B)(op: (B, T) ⇒ B): B
Применяет бинарный оператор к начальному значению и всем элементам этого итерируемого объекта или итератора, слева направо.
Примечание: /: - это альтернативная запись для foldLeft; z /: xs эквивалентно xs foldLeft z.
Примеры:
Обратите внимание, что функция свертки, используемая для вычисления b, эквивалентна функции свертки, используемой для вычисления c.
scala> val a = List(1,2,3,4) a: List[Int] = List(1, 2, 3, 4) scala> val b = (5 /: a)(_+_) b: Int = 15 scala> val c = (5 /: a)((x,y) => x + y) c: Int = 15
Примечание: не завершится для коллекций бесконечной длины.
Примечание: может вернуть разные результаты при разных запусках, если только тип базовой коллекции не является упорядоченным или оператор не является ассоциативным и коммутативным.
- B
тип результата бинарного оператора.
- z
начальное значение.
- op
бинарный оператор.
- returns
-
результат вставки
opмежду последовательными элементами этого итерируемого объекта или итератора, слева направо, с начальным значениемzслева:op(...op(op(z, x_1), x_2), ..., x_n)
где
x1, ..., xnявляются элементами этого итерируемого объекта или итератора.
- Definition Classes
- TraversableOnce → GenTraversableOnce
def :\[B](z: B)(op: (T, B) ⇒ B): B
Применяет бинарный оператор ко всем элементам этого итерируемого объекта или итератора и начальному значению, справа налево.
Примечание: :\ - это альтернативная запись для foldRight; xs :\ z эквивалентно xs foldRight z.
Примечание: не завершится для коллекций бесконечной длины.
Примечание: может вернуть разные результаты при разных запусках, если только тип базовой коллекции не является упорядоченным или оператор не является ассоциативным и коммутативным.
Примеры:
Обратите внимание, что функция свертки, используемая для вычисления b, эквивалентна функции свертки, используемой для вычисления c.
scala> val a = List(1,2,3,4) a: List[Int] = List(1, 2, 3, 4) scala> val b = (a :\ 5)(_+_) b: Int = 15 scala> val c = (a :\ 5)((x,y) => x + y) c: Int = 15
- B
тип результата бинарного оператора.
- z
начальное значение
- op
бинарный оператор
- returns
-
результат вставки
opмежду последовательными элементами этого итерируемого объекта или итератора, справа налево, с начальным значениемzсправа:op(x_1, op(x_2, ... op(x_n, z)...))
где
x1, ..., xnявляются элементами этого итерируемого объекта или итератора.
- Definition Classes
- TraversableOnce → GenTraversableOnce
final def ==(arg0: Any): Boolean
Выражение x == that эквивалентно if (x eq null) that eq null else x.equals(that).
- returns
trueесли объект-получатель эквивалентен аргументу;falseв противном случае.
- Definition Classes
- AnyRef → Any
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 })
final def asInstanceOf[T0]: T0
Приводит объект-получатель к типу T0.
Обратите внимание, что успех приведения типов во время выполнения зависит от правил стирания типов Scala. Таким образом, выражение 1.asInstanceOf[String] выбросит ClassCastException во время выполнения, а выражение List(1).asInstanceOf[List[String]] — нет. В последнем примере, так как тип аргумента стёрся во время компиляции, нельзя проверить, соответствуют ли содержимое списка требуемому типу.
- returns
объект-получатель.
- Definition Classes
- Any
- Exceptions thrown
ClassCastException, если объект-получатель не является экземпляром стираемого типаT0.
def buffered: BufferedIterator[T]
Создает буферизованный итератор из этого итератора.
- returns
буферизованный итератор, производящий те же значения, что и этот итератор.
- Definition Classes
- Iterator
- Note
Повторное использование: После вызова этого метода старый итератор нужно отбросить, а использовать только возвращённый. Использование старого итератора не определено, может измениться и может привести к изменениям в новом итераторе.
- See also
def clone(): AnyRef
Создать копию объекта-приёмника.
По умолчанию реализация метода clone зависит от платформы.
- возвращает
копию объекта-приёмника.
def collect[B](pf: PartialFunction[T, B]): Iterator[B]
Создаёт итератор, преобразуя значения, производимые этим итератором с помощью частичной функции, отбрасывая те значения, для которых частичная функция не определена.
- pf
частичная функция, которая фильтрует и отображает итератор.
- возвращает
новый итератор, который возвращает каждое значение
xпроизводимое этим итератором, для которогоpfопределена, а такжеpf(x).
- Определяющие классы
- Iterator
- Аннотации
- @migration
- Миграция
(Изменено в версии 2.8.0)
collectизменилось. Предыдущее поведение можно воспроизвести с помощьюtoSeq.- Примечание
Переиспользование: после вызова этого метода следует удалить итератор, на котором был вызван метод, и использовать только возвращённый итератор. Использование старого итератора неопределено, может быть изменено и может привести к изменениям в новом итераторе также.
def collectFirst[B](pf: PartialFunction[T, B]): Option[B]
Находит первый элемент перечислимого или итератора, для которого заданная частичная функция определена, и применяет частичную функцию к нему.
Примечание: может не завершиться для бесконечных коллекций.
Примечание: может возвращать разные результаты для разных запусков, если тип базовой коллекции не упорядочен.
- pf
частичная функция
- возвращает
значение Option, содержащее pf, применённое к первому значению, для которого оно определено, или
Noneесли такового нет.
- Определяющие классы
- TraversableOnce
Seq("a", 1, 5L).collectFirst({ case x: Int => x*10 }) = Some(10)
def contains(elem: Any): Boolean
Проверяет, содержит ли этот итератор заданное значение как элемент.
Примечание: может не завершиться для бесконечных итераторов.
- elem
элемент для проверки.
- возвращает
trueесли этот итератор производит некоторое значение, которое равно (как определено==)elem,falseв противном случае.
- Определяющие классы
- Iterator
- Примечание
Переиспользование: после вызова этого метода следует удалить итератор, на котором был вызван метод. Использование его неопределено и может быть изменено.
def copyToArray(xs: Array[T], start: Int, len: Int): Unit
Копирует выбранные значения, производимые этим итератором, в массив. Заполняет указанный массив xs начиная с индекса start не более чем len значениями, производимыми этим итератором. Копирование прекратится, как только будет достигнут конец текущего итератора, или конец массива, или len элементов были скопированы.
Примечание: не завершится для бесконечных итераторов.
- xs
массив для заполнения.
- start
начальный индекс.
- len
максимальное число элементов для копирования.
- Определяющие классы
- Iterator → TraversableOnce → GenTraversableOnce
def copyToArray(xs: Array[A]): Unit
Копирует элементы этого перечислимого или итератора в массив. Заполняет заданный массив xs значениями этого перечислимого или итератора. Копирование прекратится, как только будет достигнут конец текущего перечислимого или итератора, или конец целевого массива.
Примечание: не завершится для бесконечных итераторов.
- xs
массив для заполнения.
- Определяющие классы
- TraversableOnce → GenTraversableOnce
def copyToArray(xs: Array[A], start: Int): Unit
Копирует элементы этого перечислимого или итератора в массив. Заполняет заданный массив xs значениями этого перечислимого или итератора, начиная с индекса start. Копирование прекратится, как только будет достигнут конец текущего перечислимого или итератора, или конец целевого массива.
Примечание: не завершится для бесконечных итераторов.
- xs
массив для заполнения.
- start
начальный индекс.
- Определяющие классы
- TraversableOnce → GenTraversableOnce
def copyToBuffer[B >: T](dest: Buffer[B]): Unit
Копирует все элементы этого итерируемого объекта или итератора в буфер.
Примечание: не будет завершаться для коллекций бесконечного размера.
- dest
Буфер, в который копируются элементы.
- Definition Classes
- TraversableOnce
def corresponds[B](that: GenTraversableOnce[B])(p: (T, B) ⇒ Boolean): Boolean
Проверяет, соответствует ли каждый элемент этого итератора соответствующему элементу другой коллекции, удовлетворяя условию предиката.
- B
тип элементов
that- that
другая коллекция
- p
предикат проверки, который связывает элементы из обеих коллекций
- returns
trueесли обе коллекции имеют одинаковую длину иp(x, y)равноtrueдля всех соответствующих элементовxэтого итератора иyколлекцииthat, в противном случаеfalse
- Definition Classes
- Iterator
def count(p: (T) ⇒ Boolean): Int
Подсчитывает количество элементов в итерируемом объекте или итераторе, удовлетворяющих предикату.
- p
предикат для проверки элементов.
- returns
количество элементов, удовлетворяющих предикату
p.
- Definition Classes
- TraversableOnce → GenTraversableOnce
def drop(n: Int): Iterator[T]
Перемещает этот итератор за первые n элементов или длину итератора, что меньше.
- n
количество элементов для удаления
- returns
итератор, который генерирует все значения текущего итератора, за исключением первых
nзначений.
- Definition Classes
- Iterator
- Note
Повторное использование: после вызова этого метода необходимо удалить вызываемый итератор и использовать только возвращённый итератор. Использование старого итератора не определено, может измениться, и может привести к изменениям в новом итераторе тоже.
def dropWhile(p: (T) ⇒ Boolean): Iterator[T]
Пропускает самую длинную последовательность элементов этого итератора, которые удовлетворяют заданному предикату p, и возвращает итератор оставшихся элементов.
- p
предикат для пропуска элементов.
- returns
итератор, содержащий оставшиеся элементы
- Definition Classes
- Iterator
- Note
Повторное использование: после вызова этого метода необходимо удалить вызываемый итератор и использовать только возвращённый итератор. Использование старого итератора не определено, может измениться, и может привести к изменениям в новом итераторе тоже.
def duplicate: (Iterator[T], Iterator[T])
Создает два новых итератора, которые оба итерируют по тем же элементам, что и этот итератор (в том же порядке). Дублированные итераторы считаются равными, если они расположены в одном элементе.
Учитывая, что большинство методов для итераторов сделают исходный итератор непригодным для дальнейшего использования, этот метод предоставляет надёжный способ вызова нескольких таких методов для итератора.
- returns
пара итераторов
- Definition Classes
- Iterator
- Note
-
Реализация может выделять временное хранилище для элементов, перечисленных одним итератором, но ещё не другим.
,Повторное использование: после вызова этого метода необходимо удалить вызываемый итератор и использовать только возвращённые итераторы. Использование старого итератора не определено, может измениться, и может привести к изменениям в новых итераторах тоже.
def ensuring(cond: (PreciseSplitter[T]) ⇒ Boolean, msg: ⇒ Any): PreciseSplitter[T]
- Implicit
- Этот член добавлен неявным преобразованием из PreciseSplitter[T] в Ensuring[PreciseSplitter[T]] выполняемым методом Ensuring в scala.Predef.
- Definition Classes
- Ensuring
def ensuring(cond: (PreciseSplitter[T]) ⇒ Boolean): PreciseSplitter[T]
- Implicit
- Этот член добавлен неявным преобразованием из PreciseSplitter[T] в Ensuring[PreciseSplitter[T]] выполняемым методом Ensuring в scala.Predef.
- Definition Classes
- Ensuring
def ensuring(cond: Boolean, msg: ⇒ Any): PreciseSplitter[T]
- Неявный
- Этот член добавлен неявным преобразованием из PreciseSplitter[T] в Ensuring[PreciseSplitter[T]] с помощью метода Ensuring в scala.Predef.
- Определяющие классы
- Ensuring
def ensuring(cond: Boolean): PreciseSplitter[T]
- Неявный
- Этот член добавлен неявным преобразованием из PreciseSplitter[T] в Ensuring[PreciseSplitter[T]] с помощью метода 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 filterNot(p: (T) ⇒ Boolean): Iterator[T]
Создает итератор по всем элементам этого итератора, которые не удовлетворяют предикату p.
- p
предикат, используемый для проверки значений.
- возвращает
итератор, который производит значения этого итератора, которые не удовлетворяют предикату
p.
- Определяющие классы
- Iterator
- Примечание
Переиспользование: После вызова этого метода следует удалить итератор, на котором он был вызван, и использовать только возвращенный итератор. Использование старого итератора не определено, может измениться и может привести к изменениям в новом итераторе.
def finalize(): Unit
Вызывается сборщиком мусора для объекта-получателя, когда на объект больше нет ссылок.
Детали того, когда и если вызывается метод finalize, а также взаимодействие между finalize и нелокальными возвратами и исключениями, зависят от платформы.
- Атрибуты
- protected[lang]
- Определяющие классы
- AnyRef
- Аннотации
- @throws( classOf[java.lang.Throwable] )
- Примечание
не задано SLS в качестве члена AnyRef
def find(p: (T) ⇒ Boolean): Option[T]
Находит первое значение, производимое итератором, удовлетворяющее предикату, если таковое есть.
Примечание: может не завершиться для бесконечных итераторов.
- p
предикат, используемый для проверки значений.
- returns
вариантное значение, содержащее первое значение, производимое итератором, которое удовлетворяет предикату
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 fold[A1 >: T](z: A1)(op: (A1, A1) ⇒ A1): A1
Производит свертку элементов этого перебираемого объекта или итератора, используя заданный ассоциативный бинарный оператор.
Порядок выполнения операций над элементами не определён и может быть не детерминированным.
Примечание: не завершится для бесконечных коллекций.
- A1
тип параметр для бинарного оператора, надтип
A.- z
нейтральный элемент для операции свертки; может быть добавлен к результату произвольное количество раз, и не должен менять результат (например,
Nilдля конкатенации списков, 0 для сложения или 1 для умножения).- op
бинарный оператор, который должен быть ассоциативным.
- returns
результат применения оператора свертки
opмежду всеми элементами иz, илиzесли этот перебираемый объект или итератор пустой.
- Definition Classes
- 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).
- Неявный
- Этот член добавлен неявным преобразованием из PreciseSplitter[T] в StringFormat[PreciseSplitter[T]] с помощью метода StringFormat в scala.Predef.
- Definition Classes
- StringFormat
- Annotations
- @inline()
final def getClass(): Class[_]
Возвращает представление класса объекта во время выполнения.
- возвращает
объект класса, соответствующий типу получателя во время выполнения.
def grouped[B >: T](size: Int): GroupedIterator[B]
Возвращает итератор, который группирует этот итератор в блоки фиксированного размера. Примеры использования:
// Returns List(List(1, 2, 3), List(4, 5, 6), List(7))) (1 to 7).iterator grouped 3 toList // Returns List(List(1, 2, 3), List(4, 5, 6)) (1 to 7).iterator grouped 3 withPartial false toList // Returns List(List(1, 2, 3), List(4, 5, 6), List(7, 20, 25) // Illustrating that withPadding's argument is by-name. val it2 = Iterator.iterate(20)(_ + 5) (1 to 7).iterator grouped 3 withPadding it2.next toList
- Definition Classes
- Iterator
- Примечание
Переиспользование: После вызова этого метода следует удалить итератор, на котором он был вызван, и использовать только возвращенный итератор. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новом итераторе также.
def hasDefiniteSize: Boolean
Проверяет, имеет ли этот итератор известный размер.
- возвращает
trueдля пустых итераторов,falseв противном случае.
- Definition Classes
- Iterator → TraversableOnce → GenTraversableOnce
- Примечание
Переиспользование: итератор остается допустимым для дальнейшего использования, независимо от возвращаемого результата.
def hashCode(): Int
Метод hashCode для ссылочных типов. См. hashCode в scala.Any.
- возвращает
значение хэш-кода для этого объекта.
def indexOf[B >: T](elem: B, from: Int): Int
Возвращает индекс первого вхождения указанного объекта в этом итерируемом объекте после или на некотором стартовом индексе.
Примечание: может не завершиться для бесконечных итераторов.
- elem
элемент для поиска.
- from
стартовый индекс
- возвращает
индекс
>= fromпервого вхожденияelemв значения, производимые этим итератором, или -1, если такой элемент не существует до достижения конца итератора.
- Definition Classes
- Iterator
- Примечание
Переиспользование: После вызова этого метода следует удалить итератор, на котором он был вызван. Использование его не определено и может быть изменено.
def indexOf[B >: T](elem: B): Int
Возвращает индекс первого вхождения указанного объекта в этом итерируемом объекте.
Примечание: может не завершиться для бесконечных итераторов.
- elem
элемент для поиска.
- возвращает
индекс первого вхождения
elemв значения, производимые этим итератором, или -1, если такой элемент не существует до достижения конца итератора.
- Definition Classes
- Iterator
- Примечание
Переиспользование: После вызова этого метода следует удалить итератор, на котором он был вызван. Использование его не определено и может быть изменено.
def indexWhere(p: (T) ⇒ Boolean, from: Int): Int
Возвращает индекс первого произведенного значения, удовлетворяющего предикату, или -1, после или на некотором стартовом индексе.
Примечание: может не завершиться для бесконечных итераторов.
- p
предикат для проверки значений
- from
стартовый индекс
- возвращает
индекс
>= fromпервого произведенного значения, удовлетворяющегоp, или -1, если такой элемент не существует до достижения конца итератора.
- Definition Classes
- Iterator
- Примечание
Переиспользование: После вызова этого метода следует удалить итератор, на котором он был вызван. Использование его не определено и может быть изменено.
def indexWhere(p: (T) ⇒ Boolean): Int
Возвращает индекс первого произведённого значения, удовлетворяющего предикату, или -1.
Примечание: может не завершиться для бесконечных итераторов.
- p
предикат для проверки значений
- returns
индекс первого произведённого значения, удовлетворяющего
p, или -1, если такого элемента не существует до конца итератора.
- Definition Classes
- Iterator
- Note
Повторное использование: после вызова этого метода итератор должен быть отброшен. Его использование не определено и может измениться.
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 isTraversableAgain: Boolean
Проверяет, можно ли многократно пройти по этому итератору.
- returns
false
- Definition Classes
- Iterator → GenTraversableOnce
- Note
Повторное использование: итератор остаётся действительным для дальнейшего использования независимо от возвращаемого результата.
def length: Int
Возвращает количество элементов в этом итераторе.
Примечание: не завершится для бесконечных итераторов.
- Definition Classes
- Iterator
- Note
Повторное использование: после вызова этого метода итератор должен быть отброшен. Его использование не определено и может измениться.
def map[B](f: (T) ⇒ B): Iterator[B]
Создаёт новый итератор, который отображает все произведённые значения этого итератора в новые значения с помощью функции преобразования.
- f
функция преобразования
- returns
новый итератор, который преобразует каждое значение, произведённое этим итератором, применяя функцию
fк нему.
- Definition Classes
- Iterator
- Note
Повторное использование: после вызова этого метода итератор должен быть отброшен, и следует использовать только возвращённый итератор. Использование старого итератора не определено, может измениться и может привести к изменениям в новом итераторе тоже.
def max: A
Находит наибольший элемент.
- returns
наибольший элемент этого обходного объекта или итератора.
- Definition Classes
- TraversableOnce → GenTraversableOnce
- Exceptions thrown
UnsupportedOperationExceptionесли этот обходной объект или итератор пуст.
def maxBy[B](f: (A) ⇒ B): A
Находит первый элемент, который даёт наибольшее значение, измеряемое функцией f.
- B
Тип результата функции f.
- f
Функция измерения.
- returns
первый элемент этого обходного объекта или итератора с наибольшим значением, измеренным функцией f.
- Definition Classes
- TraversableOnce → GenTraversableOnce
- Exceptions thrown
UnsupportedOperationExceptionесли этот обходной объект или итератор пуст.
def min: A
Находит наименьший элемент.
- returns
наименьший элемент этого обходного объекта или итератора
- Definition Classes
- TraversableOnce → GenTraversableOnce
- Exceptions thrown
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 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
- Итератор
- Примечание
Переиспользование: После вызова этого метода необходимо удалить итератор, на котором он был вызван, и использовать только возвращенные итераторы. Использование старого итератора не определено, может измениться и может привести к изменениям в новых итераторах тоже.
def patch[B >: T](from: Int, patchElems: Итератор[B], replaced: Int): Итератор[B]
Возвращает этот итератор с измененными значениями. Замена по отрицательным индексам эквивалентна замене, начинающейся с 0. Замена по индексам, равным или большим длины исходного итератора, добавляет замену в конец. Если заменены значения больше, чем фактически существуют, избыток игнорируется.
- from
Начальный индекс для замены
- patchElems
Итератор значений замены
- replaced
Количество значений в исходном итераторе, которые заменяются заменой.
- Definition Classes
- Итератор
- Примечание
Переиспользование: После вызова этого метода необходимо удалить итератор, на котором он был вызван, а также переданный в качестве параметра и использовать только возвращенный итератор. Использование старых итераторов не определено, может измениться и может привести к изменениям в новом итераторе тоже.
def product: A
Умножает элементы этого набора.
- returns
произведение всех элементов в этом перебираемом или итераторе чисел типа
Int. ВместоInt, любой другой типTс неявнойNumeric[T]реализацией может использоваться в качестве типа элемента перебираемого или итератора и в качестве типа результатаproduct. Примеры таких типов:Long,Float,Double,BigInt.
- Definition Classes
- Перебираемый один раз → GenTraversableOnce
def reduce[A1 >: T](op: (A1, A1) ⇒ A1): A1
Сводит элементы этого перебираемого или итератора с помощью указанного ассоциативного бинарного оператора.
Порядок выполнения операций над элементами не определён и может быть не детерминированным.
- A1
Тип параметра для бинарного оператора, надтип
A.- op
Бинарный оператор, который должен быть ассоциативным.
- returns
Результат применения оператора reduce
opмежду всеми элементами, если перебираемый или итератор не пустой.
- Definition Classes
- Перебираемый один раз → GenTraversableOnce
- Исключения
UnsupportedOperationExceptionесли этот перебираемый или итератор пустой.
def reduceLeft[B >: T](op: (B, T) ⇒ B): B
Применяет бинарный оператор ко всем элементам этого перебираемого или итератора слева направо.
Примечание: не будет завершаться для бесконечных коллекций.
Примечание: может возвращать разные результаты для разных запусков, если тип базовой коллекции не упорядочен или оператор не ассоциативен и не коммутативен.
- B
тип результата бинарного оператора.
- op
бинарный оператор.
- returns
-
результат вставки
opмежду последовательными элементами этого перебираемого или итератора слева направо:op( op( ... op(x_1, x_2) ..., x_{n-1}), x_n)где
x1, ..., xn— это элементы этого перебираемого или итератора.
- Definition Classes
- Перебираемый один раз
- Исключения
UnsupportedOperationExceptionесли этот перебираемый или итератор пустой.
def reduceLeftOption[B >: T](op: (B, T) ⇒ B): Option[B]
Возможно применяет бинарный оператор ко всем элементам этого перебираемого или итератора слева направо.
Примечание: не будет завершаться для бесконечных коллекций.
Примечание: может возвращать разные результаты для разных запусков, если тип базовой коллекции не упорядочен или оператор не ассоциативен и не коммутативен.
- B
тип результата бинарного оператора.
- op
бинарный оператор.
- returns
значение типа Option, содержащее результат
reduceLeft(op)если этот перебираемый или итератор не пустой,Noneв противном случае.
- Definition Classes
- Перебираемый один раз → GenTraversableOnce
def reduceOption[A1 >: T](op: (A1, A1) ⇒ A1): Option[A1]
Уменьшает элементы этого итерируемого объекта или итератора, если таковые имеются, с использованием указанного ассоциативного бинарного оператора.
Порядок выполнения операций над элементами не определен и может быть недетерминированным.
- A1
Тип параметр для бинарного оператора, надтипом
A.- op
Бинарный оператор, который должен быть ассоциативным.
- returns
Значение типа Option, содержащее результат применения оператора reduce к всем элементам, если коллекция не пустая, и
Noneв противном случае.
- Definition Classes
- TraversableOnce → GenTraversableOnce
def reduceRight[B >: T](op: (T, B) ⇒ B): B
Применяет бинарный оператор ко всем элементам этого итерируемого объекта или итератора, слева направо.
Примечание: не завершится для бесконечных коллекций.
Примечание: может возвращать разные результаты для разных запусков, если тип базовой коллекции не упорядочен или оператор не является ассоциативным и коммутативным.
- B
тип результата бинарного оператора.
- op
бинарный оператор.
- returns
-
результат вставки
opмежду последовательными элементами этого итерируемого объекта или итератора, справа налево:op(x_1, op(x_2, ..., op(x_{n-1}, x_n)...))где
x1, ..., xn- элементы этого итерируемого объекта или итератора.
- Definition Classes
- TraversableOnce → GenTraversableOnce
- Исключения
UnsupportedOperationException, если этот итерируемый объект или итератор пуст.
def reduceRightOption[B >: T](op: (T, B) ⇒ B): Option[B]
Выполняет бинарный оператор над всеми элементами этого итерируемого объекта или итератора, справа налево, необязательно.
Примечание: не завершится для бесконечных коллекций.
Примечание: может возвращать разные результаты для разных запусков, если тип базовой коллекции не упорядочен или оператор не является ассоциативным и коммутативным.
- B
тип результата бинарного оператора.
- op
бинарный оператор.
- returns
значение типа Option, содержащее результат
reduceRight(op), если этот итерируемый объект или итератор не пустой,Noneв противном случае.
- Definition Classes
- TraversableOnce → GenTraversableOnce
def reversed: List[T]
- Attributes
- protected[this]
- Definition Classes
- TraversableOnce
def sameElements(that: Iterator[_]): Boolean
Проверяет, производит ли другой итератор те же значения, что и этот.
Примечание: не завершится для бесконечных итераторов.
- that
другая итерация
- returns
true, если оба итератора производят одни и те же элементы в том же порядке,falseв противном случае.
- Definition Classes
- Iterator
- Примечание
Переиспользование: после вызова этого метода следует удалить итератор, на котором он был вызван, а также переданный в качестве параметра. Использование старых итераторов не определено и может быть изменено.
def scanLeft[B](z: B)(op: (B, T) ⇒ B): Iterator[B]
Создаёт коллекцию, содержащую кумулятивные результаты применения оператора слева направо, включая начальное значение.
Примечание: не завершится для бесконечных итераторов.
Примечание: может возвращать разные результаты для разных запусков, если тип базовой коллекции не упорядочен.
- B
тип элементов в результирующей коллекции
- z
начальное значение
- op
бинарный оператор, применяемый к промежуточному результату и элементу
- returns
итератор с промежуточными результатами
- Definition Classes
- Iterator
- Примечание
Переиспользование: после вызова этого метода следует удалить вызываемый итератор, и использовать только возвращённый итератор. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новом итераторе.
def scanRight[B](z: B)(op: (T, B) ⇒ B): Iterator[B]
Создаёт коллекцию, содержащую кумулятивные результаты применения оператора справа налево. Голова коллекции - последний кумулятивный результат.
Примечание: не завершится для бесконечных итераторов.
Примечание: может возвращать разные результаты для разных запусков, если тип базовой коллекции не упорядочен.
- B
тип элементов в результирующей коллекции
- z
начальное значение
- op
бинарный оператор, применяемый к промежуточному результату и элементу
- returns
итератор с промежуточными результатами
- Definition Classes
- Iterator
- Примечание
Переиспользование: после вызова этого метода следует удалить вызываемый итератор, и использовать только возвращённый итератор. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новом итераторе.
Iterator(1, 2, 3, 4).scanRight(0)(_ + _).toList == List(10, 9, 7, 4, 0)
def seq: Iterator[T]
Версия этого набора с последовательной реализацией всех операций (то есть в однопоточном режиме).
Этот метод возвращает ссылку на этот набор. В параллельных наборах он переопределяется для возвращения последовательной реализации этого набора. В обоих случаях сложность составляет O(1).
- returns
последовательный вид набора.
- Definition Classes
- Iterator → TraversableOnce → GenTraversableOnce
def size: Int
Размер этого итерируемого объекта или итератора.
Примечание: не завершится для наборов бесконечного размера.
- returns
количество элементов в этом итерируемом объекте или итераторе.
- Definition Classes
- TraversableOnce → GenTraversableOnce
def sizeHintIfCheap: Int
Размер этого набора или итератора, если его можно вычислить недорого
- returns
количество элементов в этом наборе или итераторе, или -1, если размер нельзя определить дешево
- Attributes
- protected[collection]
- Definition Classes
- GenTraversableOnce
def slice(from: Int, until: Int): Iterator[T]
Создает итератор, возвращающий интервал значений, производимых этим итератором.
- from
индекс первого элемента в этом итераторе, который является частью среза. Если отрицательное, срез начинается с нуля.
- until
индекс первого элемента, следующего за срезом. Если отрицательное, срез пустой.
- returns
итератор, который перемещает этот итератор мимо первых
fromэлементов, используяdrop, и затем беретuntil - fromэлементов, используяtake.
- Definition Classes
- Iterator
- Note
Использование: После вызова этого метода необходимо удалить итератор, на котором он был вызван, и использовать только возвращённый итератор. Использование старого итератора не определено, может измениться и может привести к изменениям в новом итераторе.
def sliceIterator(from: Int, until: Int): Iterator[T]
Создает необязательно ограниченный срез, неограниченный, если until отрицателен.
- Attributes
- protected
- Definition Classes
- Iterator
def sliding[B >: T](size: Int, step: Int = 1): GroupedIterator[B]
Возвращает итератор, который представляет собой представление "скользящего окна" этого итератора. Первый аргумент — размер окна, а второй аргумент step — это то, насколько далеко следует продвигать окно на каждой итерации. step по умолчанию 1.
Значение по умолчанию GroupedIterator можно настроить, чтобы либо дополнить частичный результат до размера size, либо подавить частичный результат полностью.
Примеры использования:
// Returns List(List(1, 2, 3), List(2, 3, 4), List(3, 4, 5)) (1 to 5).iterator.sliding(3).toList // Returns List(List(1, 2, 3, 4), List(4, 5)) (1 to 5).iterator.sliding(4, 3).toList // Returns List(List(1, 2, 3, 4)) (1 to 5).iterator.sliding(4, 3).withPartial(false).toList // Returns List(List(1, 2, 3, 4), List(4, 5, 20, 25)) // Illustrating that withPadding's argument is by-name. val it2 = Iterator.iterate(20)(_ + 5) (1 to 5).iterator.sliding(4, 3).withPadding(it2.next).toList
- returns
Итератор, создающий
Seq[B]s размеромsize, за исключением последнего элемента (который может быть единственным), который будет усечён, если оставшихся элементов меньшеsize. Это поведение можно настроить.
- Definition Classes
- Iterator
- Note
Использование: После вызова этого метода необходимо удалить итератор, на котором он был вызван, и использовать только возвращённый итератор. Использование старого итератора не определено, может измениться и может привести к изменениям в новом итераторе.
def span(p: (T) ⇒ Boolean): (Iterator[T], Iterator[T])
Разделяет этот итератор на пару префикс/суффикс в соответствии с предикатом.
- p
предикат проверки
- returns
пара итераторов, состоящая из самого длинного префикса этого, элементы которого удовлетворяют
p, и остальная часть итератора.
- Definition Classes
- Iterator
- Note
Использование: После вызова этого метода необходимо удалить итератор, на котором он был вызван, и использовать только возвращённые итераторы. Использование старого итератора не определено, может измениться и может привести к изменениям в новых итераторах.
def sum: A
Суммирует элементы этого набора.
- returns
сумма всех элементов в этом итерируемом объекте или итераторе чисел типа
Int. ВместоInt, любой другой типTс неявной реализациейNumeric[T]может быть использован в качестве типа элемента итерируемого объекта или итератора и типа результатаsum. Примеры таких типов:Long,Float,Double,BigInt.
- Definition Classes
- TraversableOnce → GenTraversableOnce
final def synchronized[T0](arg0: ⇒ T0): T0
- Definition Classes
- AnyRef
def take(n: Int): Iterator[T]
Выбирает первые n значений этого итератора.
- n
количество значений для взятия
- returns
итератор, генерирующий только первые
nзначения этого итератора, или весь итератор, если он генерирует меньше, чемnзначений.
- Definition Classes
- Iterator
- Note
Переиспользование: После вызова этого метода нужно удалить итератор, на котором он был вызван, и использовать только возвращённый итератор. Использование старого итератора не определено, может измениться и может привести к изменениям в новом итераторе тоже.
def takeWhile(p: (T) ⇒ Boolean): Iterator[T]
Взятие наибольшего префикса значений, генерируемых этим итератором, удовлетворяющих предикату.
- p
Предикат, используемый для проверки элементов.
- returns
Итератор, возвращающий значения, генерируемые этим итератором, до тех пор, пока этот итератор не сгенерирует значение, которое не удовлетворяет предикату
p.
- Definition Classes
- Iterator
- Note
Переиспользование: После вызова этого метода нужно удалить итератор, на котором он был вызван, и использовать только возвращённый итератор. Использование старого итератора не определено, может измениться и может привести к изменениям в новом итераторе тоже.
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
итерируемая коллекция, содержащая все элементы этого итерируемого объекта или итератора.
- 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)) становится парой ключ-значение в карте. Повторяющиеся ключи будут перезаписываться последующими ключами: если это неупорядоченная коллекция, какой ключ находится в результирующей карте не определено.
Примечание: не завершится для бесконечных итераторов.
- returns
карта типа
immutable.Map[T, U], содержащая все пары ключ/значение типа(T, U)этого итерируемого объекта или итератора.
- Definition Classes
- TraversableOnce → GenTraversableOnce
def toParArray: ParArray[T]
- Неявный
- Этот член добавлен с помощью неявного преобразования из PreciseSplitter[T] в CollectionsHaveToParArray[PreciseSplitter[T], T] с помощью метода CollectionsHaveToParArray в scala.collection.parallel. Это преобразование будет выполнено только в том случае, если в области видимости есть неявное значение типа (PreciseSplitter[T]) ⇒ 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]
Преобразует эту итерируемую или итератор в вектор.
Примечание: не завершится для бесконечных коллекций.
- возвращает
вектор, содержащий все элементы этой итерируемой или итератора.
- Определяющие классы
- TraversableOnce → GenTraversableOnce
final def wait(): Unit
- Определяющие классы
- AnyRef
- Аннотации
- @throws( ... )
final def wait(arg0: Long, arg1: Int): Unit
- Определяющие классы
- AnyRef
- Аннотации
- @throws( ... )
final def wait(arg0: Long): Unit
def withFilter(p: (T) ⇒ Boolean): Iterator[T]
Создаёт итератор над всеми элементами этого итератора, удовлетворяющими предикату p. Порядок элементов сохраняется.
Примечание: withFilter эквивалентно filter для итераторов. Оно существует для того, чтобы выражения for с фильтрами работали над итераторами.
- p
предикат для проверки значений.
- returns
итератор, который генерирует те значения из этого итератора, которые удовлетворяют предикату
p.
- Definition Classes
- Iterator
- Note
Переиспользование: После вызова этого метода следует удалить итератор, на котором он был вызван, и использовать только возвращённый итератор. Использование старого итератора неопределённо, может измениться и может привести к изменениям в новом итераторе.
def zip[B](that: Iterator[B]): Iterator[(T, B)]
Создаёт итератор, образованный из этого итератора и другого итератора путём объединения соответствующих значений в пары. Если один из двух итераторов длиннее другого, его оставшиеся элементы игнорируются.
- that
Итератор, предоставляющий вторую половину каждой пары результатов
- returns
новый итератор, содержащий пары, состоящие из соответствующих элементов этого итератора и
that. Количество элементов, возвращаемых новым итератором, равно минимуму количества элементов, возвращаемых этим итератором иthat.
- Definition Classes
- Iterator
- Note
Переиспользование: После вызова этого метода следует удалить итератор, на котором он был вызван, а также переданный в качестве параметра, и использовать только возвращённый итератор. Использование старых итераторов неопределённо, может измениться и может привести к изменениям в новом итераторе.
def zipAll[B](that: Iterator[B], thisElem: T, thatElem: B): Iterator[(T, B)]
Создаёт итератор, образованный из этого итератора и другого итератора путём объединения соответствующих элементов в пары. Если один из двух итераторов короче другого, для продления короче итератора до длины более длинного используется элемент-заполнитель.
- that
итератор
thatможет иметь другую длину, чем итератор self.- thisElem
элемент
thisElemиспользуется для заполнения результирующего итератора, если итератор self корочеthat- thatElem
элемент
thatElemиспользуется для заполнения результирующего итератора, еслиthatкороче итератора self- returns
новый итератор, содержащий пары, состоящие из соответствующих значений этого итератора и
that. Длина возвращаемого итератора — максимальное из длин этого итератора иthat. Если этот итератор корочеthat, значенияthisElemиспользуются для заполнения результата. Еслиthatкороче этого итератора, значенияthatElemиспользуются для заполнения результата.
- Definition Classes
- Iterator
def zipWithIndex: Iterator[(T, Int)]
Создаёт итератор, который сопоставляет каждый элемент, производимый этим итератором, с его индексом, считая с 0.
- returns
новый итератор, содержащий пары, состоящие из соответствующих элементов этого итератора и их индексов.
- Definition Classes
- Iterator
- Note
Переиспользование: После вызова этого метода следует удалить итератор, на котором он был вызван, и использовать только возвращённый итератор. Использование старого итератора неопределённо, может измениться и может привести к изменениям в новом итераторе.
def →[B](y: B): (PreciseSplitter[T], B)
- Неявный
- Этот член добавлен неявным преобразованием из PreciseSplitter[T] в ArrowAssoc[PreciseSplitter[T]] при помощи метода ArrowAssoc в scala.Predef.
- Definition Classes
- ArrowAssoc
Затенённые неявные члены значения
def filter(p: (T) ⇒ Boolean): TraversableOnce[T]
- Неявный
- Этот член добавлен благодаря неявной конверсии из PreciseSplitter[T] в MonadOps[T], выполненной методом MonadOps в scala.collection.TraversableOnce.
- Затенение
- Этот неявно унаследованный член затенён одним или несколькими членами в этом классе.
Для доступа к этому члену можно использовать описание типа:(preciseSplitter: MonadOps[T]).filter(p)
- Определяющие классы
- MonadOps
def flatMap[B](f: (T) ⇒ GenTraversableOnce[B]): TraversableOnce[B]
- Неявный
- Этот член добавлен благодаря неявной конверсии из PreciseSplitter[T] в MonadOps[T], выполненной методом MonadOps в scala.collection.TraversableOnce.
- Затенение
- Этот неявно унаследованный член затенён одним или несколькими членами в этом классе.
Для доступа к этому члену можно использовать описание типа:(preciseSplitter: MonadOps[T]).flatMap(f)
- Определяющие классы
- MonadOps
def map[B](f: (T) ⇒ B): TraversableOnce[B]
- Неявный
- Этот член добавлен благодаря неявной конверсии из PreciseSplitter[T] в MonadOps[T], выполненной методом MonadOps в scala.collection.TraversableOnce.
- Затенение
- Этот неявно унаследованный член затенён одним или несколькими членами в этом классе.
Для доступа к этому члену можно использовать описание типа:(preciseSplitter: MonadOps[T]).map(f)
- Определяющие классы
- MonadOps
def withFilter(p: (T) ⇒ Boolean): Iterator[T]
- Неявный
- Этот член добавлен благодаря неявной конверсии из PreciseSplitter[T] в MonadOps[T], выполненной методом MonadOps в scala.collection.TraversableOnce.
- Затенение
- Этот неявно унаследованный член затенён одним или несколькими членами в этом классе.
Для доступа к этому члену можно использовать описание типа:(preciseSplitter: 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/PreciseSplitter.html
Точный разделитель (или точный итератор разбиения) может быть разделен на произвольное количество разделителей, которые обходятся по непересекающимся подмножествам произвольных размеров.
Реализаторы могут захотеть переопределить параметрический метод
splitдля повышения эффективности.тип элементов, которые обходит этот разделитель
2.9