Trait scala.collection.parallel.Splitter
Companion object Splitter
trait Splitter[+T] extends Iterator[T]
Type Members
class GroupedIterator[B >: A] extends AbstractIterator[Seq[B]] with Iterator[Seq[B]]
Гибкий итератор для преобразования Iterator[A] в Iterator[Seq[A]], с настраиваемым размером последовательности, шагом и стратегией для обработки элементов, которые не помещаются равномерно.
Типичные использования могут быть достигнуты с помощью методов grouped и sliding.
- Definition Classes
- Iterator
Abstract Value Members
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 split: Seq[Splitter[T]]
Разделяет итератор на последовательность непересекающихся представлений.
Возвращает последовательность разделительных итераторов, каждый из которых перебирает некоторое подмножество элементов в коллекции. Эти подмножества не пересекаются и должны быть примерно равными по размеру. Эти подмножества не пустые, если итератор пустой, то метод вернёт последовательность с одним пустым итератором. Если у разделителя более двух элементов, метод вернёт два или более разделителей.
Реализаторам рекомендуется сохранять это разбиение относительно небольшим — двух разделителей уже достаточно при разбиении коллекции, хотя может быть немного больше.
Примечание: этот метод фактически делает текущий разделитель недействительным.
- returns
последовательность непересекающихся итераторов коллекции
Члены-значения
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
- Implicit
- Этот член добавлен неявным преобразованием из Splitter[T] в any2stringadd[Splitter[T]], выполненное методом any2stringadd в scala.Predef.
- Definition Classes
- any2stringadd
def ++(that: ⇒ Iterator[T]): Iterator[T]
Конкатенация текущего итератора с другим.
- that
другой итератор
- returns
новый итератор, который сначала возвращает значения, производимые этим итератором, а затем — значения, производимые итератором
that.
- Definition Classes
- Iterator
def ->[B](y: B): (Splitter[T], B)
- Implicit
- Этот член добавлен неявным преобразованием из Splitter[T] в ArrowAssoc[Splitter[T]], выполненное методом ArrowAssoc в scala.Predef.
- Definition Classes
- ArrowAssoc
- Annotations
- @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, к которому были добавлены элементы.
- Определяющие классы
- 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, к которому были добавлены элементы.
- Определяющие классы
- 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, к которому были добавлены элементы.
- Определяющие классы
- 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 преобразует каждый входной символ в Int и добавляет его к сумме (раздела). Затем combop просто нужно суммировать промежуточные результаты разделов:
List('a', 'b', 'c').aggregate(0)({ (sum, ch) => sum + ch.toInt }, { (p1, p2) => p1 + p2 })
- B
тип накопленных результатов
- z
начальное значение для накопленного результата раздела — обычно это нейтральный элемент для оператора
seqop(например,Nilдля конкатенации списков или0для суммирования) и может вычисляться более одного раза- seqop
оператор, используемый для накопления результатов внутри раздела
- combop
ассоциативный оператор, используемый для объединения результатов из разных разделов
- Определяющие классы
- TraversableOnce → GenTraversableOnce
final def asInstanceOf[T0]: T0
Привести получаемый объект к типу T0.
Обратите внимание, что успех приведения типов во время выполнения зависит от семантики стирания типов Scala. Поэтому выражение 1.asInstanceOf[String] вызовет ClassCastException во время выполнения, а выражение List(1).asInstanceOf[List[String]] — нет. В последнем примере, поскольку аргумент типа стирается во время компиляции, невозможно проверить, соответствуют ли содержимое списка запрашиваемому типу.
- returns
получаемый объект.
- Определяющие классы
- Any
- Выбрасываемые исключения
ClassCastExceptionесли получаемый объект не является экземпляром стирания типаT0.
def buffered: BufferedIterator[T]
Создает буферизованный итератор из этого итератора.
- returns
буферизованный итератор, производящий те же значения, что и этот итератор.
- Определяющие классы
- Iterator
- Примечание
Повторное использование: после вызова этого метода следует отказаться от итератора, к которому он был применен, и использовать только возвращенный итератор. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новом итераторе.
- См. также
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: (Splitter[T]) ⇒ Boolean, msg: ⇒ Any): Splitter[T]
- Неявный
- Этот член добавлен неявным преобразованием из Splitter[T] в Ensuring[Splitter[T]] выполненным методом Ensuring в scala.Predef.
- Definition Classes
- Ensuring
def ensuring(cond: (Splitter[T]) ⇒ Boolean): Splitter[T]
- Неявный
- Этот член добавлен неявным преобразованием из Splitter[T] в Ensuring[Splitter[T]] выполненным методом Ensuring в scala.Predef.
- Definition Classes
- Ensuring
def ensuring(cond: Boolean, msg: ⇒ Any): Splitter[T]
- Неявное
- Этот член добавлен неявным преобразованием из Splitter[T] в Ensuring[Splitter[T]], выполненным методом Ensuring в scala.Predef.
- Классы определений
- Ensuring
def ensuring(cond: Boolean): Splitter[T]
- Неявное
- Этот член добавлен неявным преобразованием из Splitter[T] в Ensuring[Splitter[T]], выполненным методом Ensuring в scala.Predef.
- Классы определений
- Ensuring
final def eq(arg0: AnyRef): Boolean
Проверяет, является ли аргумент (that) ссылкой на объект-получатель (this).
Метод eq реализует отношение эквивалентности на непустых экземплярах AnyRef, и имеет три дополнительных свойства:
-
Он согласован: для любых непустых экземпляров
x и y типа AnyRef, многократные вызовы x.eq(y) последовательно возвращают true или последовательно возвращают false.Для любого непустого экземпляра x типа AnyRef, x.eq(null) и null.eq(x) возвращает false.
null.eq(null) возвращает true. При переопределении методов equals или hashCode важно обеспечить согласованность их поведения с равенством ссылок. Таким образом, если два объекта являются ссылками друг на друга (o1 eq o2), они должны быть равны друг другу (o1 == o2) и должны иметь одинаковое значение хэша (o1.hashCode == o2.hashCode).
- возвращает
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
значение типа Option, содержащее первое значение, производимое итератором, которое удовлетворяет предикату
p, илиNoneесли такового не существует.
- Definition Classes
- Iterator → TraversableOnce → GenTraversableOnce
- Примечание
Переиспользование: после вызова этого метода итератор, на котором он был вызван, следует удалить. Использование его не определено и может измениться.
def flatMap[B](f: (T) ⇒ GenTraversableOnce[B]): Iterator[B]
Создаёт новый итератор, применяя функцию ко всем значениям, производимым этим итератором, и конкатенируя результаты.
- f
функция для применения к каждому элементу.
- returns
итератор, полученный путём применения данной функции, возвращающей итератор
fк каждому значению, производимому этим итератором, и конкатенации результатов.
- Definition Classes
- Iterator
- Примечание
Переиспользование: после вызова этого метода итератор, на котором он был вызван, следует удалить, используя только возвращённый итератор. Использование старого итератора не определено, может измениться, и может привести к изменениям в новом итераторе также.
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
- Примечание
Переиспользование: после вызова этого метода итератор, на котором он был вызван, следует удалить. Использование его не определено и может измениться.
def foreach(f: (T) ⇒ Unit): Unit
Применяет функцию f ко всем значениям, производимым этим итератором.
- f
функция, которая применяется для побочного эффекта к каждому элементу. Результат функции
fигнорируется.
- Классы-определения
- Iterator → TraversableOnce → GenTraversableOnce
def formatted(fmtstr: String): String
Возвращает строку, отформатированную в соответствии с заданной строкой format. Форматные строки такие же, как у String.format (@see java.lang.String.format).
- Неявный
- Этот член добавлен неявным преобразованием из Splitter[T] в StringFormat[Splitter[T]] при помощи метода StringFormat в scala.Predef.
- Классы-определения
- StringFormat
- Аннотации
- @inline()
final def getClass(): Class[_]
Возвращает представление класса объекта во время выполнения.
- возвращает
объект класса, соответствующий типу получателя во время выполнения.
def grouped[B >: T](size: Int): GroupedIterator[B]
Возвращает итератор, который группирует этот итератор в блоки фиксированного размера. Примеры использования:
// Returns List(List(1, 2, 3), List(4, 5, 6), List(7))) (1 to 7).iterator grouped 3 toList // Returns List(List(1, 2, 3), List(4, 5, 6)) (1 to 7).iterator grouped 3 withPartial false toList // Returns List(List(1, 2, 3), List(4, 5, 6), List(7, 20, 25) // Illustrating that withPadding's argument is by-name. val it2 = Iterator.iterate(20)(_ + 5) (1 to 7).iterator grouped 3 withPadding it2.next toList
- Классы-определения
- Iterator
- Примечание
Переиспользование: после вызова этого метода следует удалить итератор, на котором он был вызван, и использовать только возвращенный итератор. Использование старого итератора не определено, может измениться и может привести к изменениям в новом итераторе.
def hasDefiniteSize: Boolean
Проверяет, имеет ли этот итератор известный размер.
- возвращает
trueдля пустых итераторов,falseв противном случае.
- Классы-определения
- Iterator → TraversableOnce → GenTraversableOnce
- Примечание
Переиспользование: итератор остается действительным для дальнейшего использования независимо от возвращаемого результата.
def hashCode(): Int
Метод hashCode для ссылочных типов. См. hashCode в scala.Any.
- возвращает
значение хэш-кода для этого объекта.
def indexOf[B >: T](elem: B, from: Int): Int
Возвращает индекс первого вхождения указанного объекта в этом итерируемом объекте после или на определенном начальном индексе.
Примечание: может не завершиться для бесконечных итераторов.
- elem
элемент для поиска.
- from
начальный индекс
- возвращает
индекс
>= fromпервого вхожденияelemв значения, производимые этим итератором, или -1, если такого элемента не существует до конца итератора.
- Классы-определения
- Iterator
- Примечание
Переиспользование: после вызова этого метода следует удалить итератор, на котором он был вызван. Его использование не определено и может измениться.
def indexOf[B >: T](elem: B): Int
Возвращает индекс первого вхождения указанного объекта в этом итерируемом объекте.
Примечание: может не завершиться для бесконечных итераторов.
- elem
элемент для поиска.
- возвращает
индекс первого вхождения
elemв значения, производимые этим итератором, или -1, если такого элемента не существует до конца итератора.
- Классы-определения
- Iterator
- Примечание
Переиспользование: после вызова этого метода следует удалить итератор, на котором он был вызван. Его использование не определено и может измениться.
def indexWhere(p: (T) ⇒ Boolean, from: Int): Int
Возвращает индекс первого значения, удовлетворяющего предикату, или -1, после или на определенном начальном индексе.
Примечание: может не завершиться для бесконечных итераторов.
- p
предикат для проверки значений
- from
начальный индекс
- возвращает
индекс
>= fromпервого произведенного значения, удовлетворяющегоp, или -1, если такого элемента не существует до конца итератора.
- Классы-определения
- Iterator
- Примечание
Переиспользование: после вызова этого метода следует удалить итератор, на котором он был вызван. Его использование не определено и может измениться.
def indexWhere(p: (T) ⇒ Boolean): Int
Возвращает индекс первого произведённого значения, удовлетворяющего предикату, или -1.
Примечание: может не завершаться для бесконечных итераторов.
- p
предикат для проверки значений
- возвращает
индекс первого произведённого значения, удовлетворяющего
p, или -1, если такого элемента не существует до достижения конца итератора.
- Определяющие классы
- Iterator
- Примечание
Использование: после вызова этого метода следует удалить вызываемый итератор. Его дальнейшее использование не определено и может быть изменено.
def isEmpty: Boolean
Проверяет, пуст ли этот итератор.
- возвращает
trueесли hasNext ложно,falseв противном случае.
- Определяющие классы
- Iterator → TraversableOnce → GenTraversableOnce
- Примечание
Использование: итератор остаётся действительным для дальнейшего использования независимо от возвращаемого результата.
final def isInstanceOf[T0]: Boolean
Проверяет, является ли динамический тип получаемого объекта T0.
Обратите внимание, что результат проверки зависит от семантики стирания Scala. Следовательно, выражение 1.isInstanceOf[String] вернёт false, в то время как выражение List(1).isInstanceOf[List[String]] вернёт true. В последнем примере, поскольку аргумент типа стирается во время компиляции, нельзя проверить, соответствуют ли элементы списка указанному типу.
- возвращает
trueесли получаемый объект является экземпляром стирания типаT0;falseв противном случае.
- Определяющие классы
- Any
def isTraversableAgain: Boolean
Проверяет, может ли этот итератор быть повторно пройден.
- возвращает
false
- Определяющие классы
- Iterator → GenTraversableOnce
- Примечание
Использование: итератор остаётся действительным для дальнейшего использования независимо от возвращаемого результата.
def length: Int
Возвращает количество элементов в этом итераторе.
Примечание: не завершится для бесконечных итераторов.
- Определяющие классы
- Iterator
- Примечание
Использование: после вызова этого метода следует удалить вызываемый итератор. Его дальнейшее использование не определено и может быть изменено.
def map[B](f: (T) ⇒ B): Iterator[B]
Создаёт новый итератор, отображающий все произведённые значения этого итератора в новые значения с помощью функции преобразования.
- f
функция преобразования
- возвращает
новый итератор, преобразующий каждое значение, произведённое этим итератором, путём применения функции
fк нему.
- Определяющие классы
- Iterator
- Примечание
Использование: после вызова этого метода следует удалить вызываемый итератор и использовать только возвращённый итератор. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новом итераторе.
def max: A
Находит наибольший элемент.
- возвращает
наибольший элемент этого итератора или коллекции.
- Определяющие классы
- TraversableOnce → GenTraversableOnce
- Исключения
UnsupportedOperationException, если эта коллекция или итератор пуста.
def maxBy[B](f: (A) ⇒ B): A
Находит первый элемент, который даёт наибольшее значение, измеренное функцией f.
- B
Тип результата функции f.
- f
Функция измерения.
- возвращает
первый элемент этой коллекции или итератора с наибольшим значением, измеренным функцией f.
- Определяющие классы
- TraversableOnce → GenTraversableOnce
- Исключения
UnsupportedOperationExceptionесли эта коллекция или итератор пуста.
def min: A
Находит наименьший элемент.
- возвращает
наименьший элемент этой коллекции или итератора
- Определяющие классы
- TraversableOnce → GenTraversableOnce
- Исключения
UnsupportedOperationExceptionесли эта коллекция или итератор пуста.
def minBy[B](f: (A) ⇒ B): A
Находит первый элемент, который дает наименьшее значение, измеренное функцией f.
- B
Тип результата функции f.
- f
Функция измерения.
- возвращает
первый элемент этого итерируемого объекта или итератора с наименьшим значением, измеренным функцией f.
- Определяющие классы
- TraversableOnce → GenTraversableOnce
- Исключения
UnsupportedOperationException, если этот итерируемый объект или итератор пустой.
def mkString: String
Отображает все элементы этого итерируемого объекта или итератора в строке.
- возвращает
строковое представление этого итерируемого объекта или итератора. В результирующей строке строковые представления (с помощью метода
toString) всех элементов этого итерируемого объекта или итератора следуют друг за другом без разделительной строки.
- Определяющие классы
- TraversableOnce → GenTraversableOnce
def mkString(sep: String): String
Отображает все элементы этого итерируемого объекта или итератора в строке с использованием разделительной строки.
- sep
разделительная строка.
- возвращает
строковое представление этого итерируемого объекта или итератора. В результирующей строке строковые представления (с помощью метода
toString) всех элементов этого итерируемого объекта или итератора разделяются строкойsep.
- Определяющие классы
- TraversableOnce → GenTraversableOnce
List(1, 2, 3).mkString("|") = "1|2|3"
def mkString(start: String, sep: String, end: String): String
Отображает все элементы этого итерируемого объекта или итератора в строке, используя начальную, конечную и разделительные строки.
- start
начальная строка.
- sep
разделительная строка.
- end
конечная строка.
- возвращает
строковое представление этого итерируемого объекта или итератора. Результирующая строка начинается со строки
startи заканчивается строкойend. Внутри, строковые представления (с помощью методаtoString) всех элементов этого итерируемого объекта или итератора разделяются строкойsep.
- Определяющие классы
- TraversableOnce → GenTraversableOnce
List(1, 2, 3).mkString("(", "; ", ")") = "(1; 2; 3)"
final def ne(arg0: AnyRef): Boolean
Эквивалентно !(this eq that).
- возвращает
true, если аргумент не является ссылкой на получаемый объект;falseв противном случае.
- Определяющие классы
- AnyRef
def nonEmpty: Boolean
Проверяет, не пустой ли итерируемый объект или итератор.
- возвращает
true, если итерируемый объект или итератор содержит хотя бы один элемент;falseв противном случае.
- Определяющие классы
- TraversableOnce → GenTraversableOnce
final def notify(): Unit
Разбуживает единственную нить, которая ожидает монитор получаемого объекта.
- Определяющие классы
- AnyRef
- Аннотации
- @native()
- Примечание
не указано SLS как член AnyRef
final def notifyAll(): Unit
Разбуживает все нити, которые ожидают монитор получаемого объекта.
- Определяющие классы
- AnyRef
- Аннотации
- @native()
- Примечание
не указано SLS как член AnyRef
def padTo(len: Int, elem: T): Iterator[T]
Добавляет значение элемента к этому итератору до тех пор, пока не будет достигнута заданная целевая длина.
- len
целевая длина
- elem
значение заполнения
- возвращает
новый итератор, состоящий из всех значений этого итератора, за которым следует минимальное количество вхождений
elem, чтобы количество сгенерированных значений было по крайней мереlen.
- Определяющие классы
- Iterator
def partition(p: (T) ⇒ Boolean): (Iterator[T], Iterator[T])
Разделяет этот итератор на два итератора в соответствии с предикатом.
- p
предикат, по которому происходит разделение
- returns
пара итераторов: итератор, удовлетворяющий предикату
p, и итератор, не удовлетворяющий ему. Относительный порядок элементов в результирующих итераторах такой же, как и в исходном итераторе.
- Definition Classes
- Iterator
- Note
Повторное использование: после вызова этого метода следует удалить итератор, на котором он был вызван, и использовать только возвращенные итераторы. Использование старого итератора не определено, может измениться и может привести к изменениям в новых итераторах также.
def patch[B >: T](from: Int, patchElems: Iterator[B], replaced: Int): Iterator[B]
Возвращает этот итератор с изменёнными значениями. Замена по отрицательным индексам эквивалентна замене, начинающейся с 0. Замена по индексам, равным или большим длины исходного итератора, добавляет вставка в конец. Если заменённых значений больше, чем фактически существует, избыток игнорируется.
- from
Индекс начала замены
- patchElems
Итератор значений для замены
- replaced
Количество значений в исходном итераторе, которые заменяются вставкой.
- Definition Classes
- Iterator
- Note
Повторное использование: после вызова этого метода следует удалить итератор, на котором он был вызван, а также переданный итератор, и использовать только возвращённый итератор. Использование старых итераторов не определено, может измениться и может привести к изменениям в новом итераторе также.
def product: A
Произведение элементов этого набора.
- returns
произведение всех элементов в этом итерируемом или итераторе чисел типа
Int. ВместоInt, может быть использован любой другой типTс неявнымNumeric[T]реализацией, который может быть использован как тип элементов итерируемого или итератора и как тип результатаproduct. Примеры таких типов:Long,Float,Double,BigInt.
- Definition Classes
- TraversableOnce → GenTraversableOnce
def reduce[A1 >: T](op: (A1, A1) ⇒ A1): A1
Редуцирует элементы этого итерируемого или итератора с использованием указанного ассоциативного бинарного оператора.
Порядок выполнения операций над элементами не определен и может быть не детерминированным.
- A1
Тип параметр для бинарного оператора, надтипом
A.- op
Бинарный оператор, который должен быть ассоциативным.
- returns
Результат применения оператора reduce
opмежду всеми элементами, если итерируемый или итератор не пуст.
- Definition Classes
- TraversableOnce → 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
- TraversableOnce
- Исключения
UnsupportedOperationExceptionесли этот итерируемый или итератор пуст.
def reduceLeftOption[B >: T](op: (B, T) ⇒ B): Option[B]
Необязательно применяет бинарный оператор ко всем элементам этого итерируемого или итератора слева направо.
Примечание: не завершит работу для бесконечных коллекций.
Примечание: может вернуть разные результаты для разных запусков, если тип базовой коллекции не упорядочен или оператор не ассоциативен и коммутативен.
- B
тип результата бинарного оператора.
- op
бинарный оператор.
- returns
опциональное значение, содержащее результат
reduceLeft(op)если этот итерируемый или итератор не пуст,Noneв противном случае.
- Definition Classes
- TraversableOnce → GenTraversableOnce
def reduceOption[A1 >: T](op: (A1, A1) ⇒ A1): Option[A1]
Уменьшает элементы этого итерируемого объекта или итератора, если таковые имеются, с использованием указанного ассоциативного бинарного оператора.
Порядок выполнения операций над элементами не определён и может быть недетерминированным.
- A1
Тип параметр для бинарного оператора, супертип
A.- op
Бинарный оператор, который должен быть ассоциативным.
- returns
Значение типа Option, содержащее результат применения оператора reduce к
opмежду всеми элементами, если коллекция непустая, иNoneв противном случае.
- Definition Classes
- TraversableOnce → GenTraversableOnce
def reduceRight[B >: T](op: (T, B) ⇒ B): B
Применяет бинарный оператор ко всем элементам этого итерируемого объекта или итератора, справа налево.
Примечание: не будет завершаться для коллекций бесконечного размера.
Примечание: может возвращать разные результаты для разных запусков, если только тип базовой коллекции упорядочен или оператор ассоциативен и коммутативен.
- B
тип результата бинарного оператора.
- op
бинарный оператор.
- returns
-
результат вставки
opмежду последовательными элементами этого итерируемого объекта или итератора, справа налево:op(x_1, op(x_2, ..., op(x_{n-1}, x_n)...))где
x1, ..., xn- элементы этого итерируемого объекта или итератора.
- Definition Classes
- TraversableOnce → GenTraversableOnce
- Exceptions thrown
UnsupportedOperationException, если этот итерируемый объект или итератор пуст.
def reduceRightOption[B >: T](op: (T, B) ⇒ B): Option[B]
Необязательно применяет бинарный оператор ко всем элементам этого итерируемого объекта или итератора, справа налево.
Примечание: не будет завершаться для коллекций бесконечного размера.
Примечание: может возвращать разные результаты для разных запусков, если только тип базовой коллекции упорядочен или оператор ассоциативен и коммутативен.
- B
тип результата бинарного оператора.
- op
бинарный оператор.
- returns
значение типа 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
- 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 seq: Iterator[T]
Версия этого набора с реализацией всех операций последовательно (т.е., в однопоточном режиме).
Этот метод возвращает ссылку на этот набор. В параллельных наборах он переопределён, чтобы возвращать последовательную реализацию этого набора. В обоих случаях сложность составляет O(1).
- возвращает
последовательный вид набора.
- Классы-определения
- Iterator → TraversableOnce → GenTraversableOnce
def size: Int
Размер этого итерируемого объекта или итератора.
Примечание: не завершится для наборов бесконечного размера.
- возвращает
количество элементов в этом итерируемом объекте или итераторе.
- Классы-определения
- TraversableOnce → GenTraversableOnce
def sizeHintIfCheap: Int
Размер этого набора или итератора, если он может быть вычислен дёшево.
- возвращает
количество элементов в этом наборе или итераторе, или -1, если размер не может быть определен дёшево.
- Атрибуты
- protected[collection]
- Классы-определения
- GenTraversableOnce
def slice(from: Int, until: Int): Iterator[T]
Создаёт итератор, возвращающий интервал значений, производимых этим итератором.
- from
индекс первого элемента в этом итераторе, который входит в срез. Если отрицательное значение, срез начинается с нуля.
- until
индекс первого элемента, следующего за срезом. Если отрицательное значение, срез пустой.
- возвращает
итератор, который продвигает этот итератор мимо первых
fromэлементов, используяdrop, и затем берётuntil - fromэлементов, используяtake.
- Классы-определения
- Iterator
- Примечание
Переиспользование: После вызова этого метода, следует удалить итератор, на котором был вызван метод, и использовать только возвращённый итератор. Использование старого итератора не определено, может измениться и может привести к изменениям в новом итераторе тоже.
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 sum: A
Суммирует элементы этого набора.
- возвращает
сумма всех элементов в этом итерируемом объекте или итераторе чисел типа
Int. ВместоInt, может быть использован любой другой типTс явнымNumeric[T]реализацией, который может быть использован в качестве типа элемента итерируемого объекта или итератора и в качестве типа результатаsum. Примеры таких типов:Long,Float,Double,BigInt.
- Классы-определения
- TraversableOnce → GenTraversableOnce
final def synchronized[T0](arg0: ⇒ T0): T0
- Классы-определения
- AnyRef
def take(n: Int): Iterator[T]
Выбирает первые n значений этого итератора.
- n
количество значений для взятия
- возвращает
итератор, генерирующий только первые
nзначения этого итератора, или весь итератор, если он генерирует меньше чемnзначений.
- Классы-определения
- Iterator
- Примечание
Переиспользование: после вызова этого метода следует удалить итератор, на котором он был вызван, и использовать только возвращённый итератор. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новом итераторе тоже.
def takeWhile(p: (T) ⇒ Boolean): Iterator[T]
Возвращает самую длинную префиксную последовательность значений, генерируемых этим итератором, удовлетворяющую предикату.
- p
Предикат для проверки элементов.
- возвращает
Итератор, возвращающий значения, генерируемые этим итератором, пока этот итератор генерирует значения, удовлетворяющие предикату
p.
- Классы-определения
- Iterator
- Примечание
Переиспользование: после вызова этого метода следует удалить итератор, на котором он был вызван, и использовать только возвращённый итератор. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новом итераторе тоже.
def to[Col[_]]: Col[A]
Преобразует эту коллекцию или итератор в другую, копируя все элементы.
Примечание: не завершится для бесконечных итераторов.
- Col
Тип коллекции для построения.
- возвращает
новая коллекция, содержащая все элементы этой коллекции или итератора.
- Классы-определения
- TraversableOnce → GenTraversableOnce
def toArray: Array[A]
Преобразует эту коллекцию или итератор в массив.
Примечание: не завершится для бесконечных итераторов.
- возвращает
массив, содержащий все элементы этой коллекции или итератора. Должен быть доступен
ClassTagдля типа элемента этой коллекции или итератора.
- Классы-определения
- TraversableOnce → GenTraversableOnce
def toBuffer[B >: T]: Buffer[B]
Использует содержимое этой коллекции или итератора для создания нового изменяемого буфера.
Примечание: не завершится для бесконечно больших коллекций.
- возвращает
буфер, содержащий все элементы этой коллекции или итератора.
- Классы-определения
- TraversableOnce → GenTraversableOnce
def toIndexedSeq: immutable.IndexedSeq[T]
Преобразует эту коллекцию или итератор в индексированную последовательность.
Примечание: не завершится для бесконечно больших коллекций.
- возвращает
индексированная последовательность, содержащая все элементы этой коллекции или итератора.
- Классы-определения
- TraversableOnce → GenTraversableOnce
def toIterable: Iterable[T]
Преобразует эту коллекцию или итератор в итерируемую коллекцию. Обратите внимание, что выбор целевого Iterable ленив в этом реализации по умолчанию, так как этот TraversableOnce может быть ленивым и невычисленным (т.е. это может быть итератор, который можно пройти только один раз).
Примечание: не завершится для бесконечно больших коллекций.
- возвращает
итерируемая коллекция, содержащая все элементы этой коллекции или итератора.
- Классы-определения
- TraversableOnce → GenTraversableOnce
def toIterator: Iterator[T]
Возвращает итератор по элементам в этой коллекции или итераторе. Вернёт тот же итератор, если этот экземпляр уже является итератором.
Примечание: не завершится для бесконечных итераторов.
- возвращает
итератор, содержащий все элементы этой коллекции или итератора.
- Классы-определения
- Iterator → GenTraversableOnce
def toList: List[T]
Преобразует эту коллекцию или итератор в список.
Примечание: не завершится для бесконечно больших коллекций.
- возвращает
список, содержащий все элементы этой коллекции или итератора.
- Классы-определения
- TraversableOnce → GenTraversableOnce
def toMap[T, U]: Map[T, U]
Преобразует эту коллекцию или итератор в карту. Этот метод недоступен, если элементы не являются членами Tuple2, каждое ((T, U)) становится парой ключ-значение в карте. Повторяющиеся ключи будут перезаписаны последующими ключами: если это неупорядоченная коллекция, то какой ключ находится в результирующей карте, не определено.
Примечание: не завершится для бесконечных итераторов.
- возвращает
карта типа
immutable.Map[T, U]содержащая все пары ключ/значение типа(T, U)этой коллекции или итератора.
- Классы-определения
- TraversableOnce → GenTraversableOnce
def toParArray: ParArray[T]
- Неявный
- Этот член добавлен неявным преобразованием из Splitter[T] в CollectionsHaveToParArray[Splitter[T], T] с помощью метода CollectionsHaveToParArray в scala.collection.parallel. Это преобразование произойдёт только если неявное значение типа (Splitter[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]
Преобразует это итерируемое или итератор в неопределённое итерируемое. Возвращает ту же коллекцию, если этот экземпляр уже является итерируемым.
Примечание: не завершится для бесконечных итераторов.
- возвращает
итерируемое, содержащее все элементы этого итерируемого или итератора.
- Классы определения
- 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
предикат для проверки значений.
- возвращает
итератор, который генерирует те значения из этого итератора, которые удовлетворяют предикату
p.
- Определяющие классы
- Iterator
- Примечание
Переиспользование: После вызова этого метода нужно удалить итератор, на котором он был вызван, и использовать только возвращённый итератор. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новом итераторе.
def zip[B](that: Iterator[B]): Iterator[(T, B)]
Создаёт итератор, образованный из этого и другого итератора путём объединения соответствующих значений в пары. Если один из двух итераторов длиннее другого, его оставшиеся элементы игнорируются.
- that
Итератор, предоставляющий вторую половину каждой пары результата
- возвращает
новый итератор, содержащий пары, состоящие из соответствующих элементов этого итератора и
that. Количество элементов, возвращаемых новым итератором, равно минимуму количества элементов, возвращаемых этим итератором иthat.
- Определяющие классы
- Iterator
- Примечание
Переиспользование: После вызова этого метода нужно удалить итератор, на котором он был вызван, а также переданный в качестве параметра, и использовать только возвращённый итератор. Использование старых итераторов не определено, может быть изменено и может привести к изменениям в новом итераторе.
def zipAll[B](that: Iterator[B], thisElem: T, thatElem: B): Iterator[(T, B)]
Создаёт итератор, образованный из этого и другого итератора путём объединения соответствующих элементов в пары. Если один из двух итераторов короче другого, для дополнения более короткого итератора используются плацехолдерные элементы до длины более длинного.
- that
итератор
thatможет иметь другую длину по сравнению с итератором self.- thisElem
элемент
thisElemиспользуется для заполнения результирующего итератора, если итератор self корочеthat- thatElem
элемент
thatElemиспользуется для заполнения результирующего итератора, еслиthatкороче итератора self- возвращает
новый итератор, содержащий пары, состоящие из соответствующих значений этого итератора и
that. Длина возвращаемого итератора — максимальная из длин этого итератора иthat. Если этот итератор корочеthat, значенияthisElemиспользуются для заполнения результата. Еслиthatкороче этого итератора, значенияthatElemиспользуются для заполнения результата.
- Определяющие классы
- Iterator
def zipWithIndex: Iterator[(T, Int)]
Создаёт итератор, который сопоставляет каждый элемент, генерируемый этим итератором, с его индексом, начиная с 0.
- возвращает
новый итератор, содержащий пары, состоящие из соответствующих элементов этого итератора и их индексов.
- Определяющие классы
- Iterator
- Примечание
Переиспользование: После вызова этого метода нужно удалить итератор, на котором он был вызван, и использовать только возвращённый итератор. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новом итераторе.
def →[B](y: B): (Splitter[T], B)
- Неявный
- Этот член добавлен неявным преобразованием из Splitter[T] в ArrowAssoc[Splitter[T]] с помощью метода ArrowAssoc в scala.Predef.
- Определяющие классы
- ArrowAssoc
Затенённые неявные члены-значения
def filter(p: (T) ⇒ Boolean): TraversableOnce[T]
- Неявный
- Этот член добавлен неявным преобразованием из Splitter[T] в MonadOps[T], выполненное методом MonadOps в scala.collection.TraversableOnce.
- Затенение
- Этот неявно унаследованный член затенён одним или несколькими членами в этом классе.
Для доступа к этому члену можно использовать явное указание типа:(splitter: MonadOps[T]).filter(p)
- Классы-определения
- MonadOps
def flatMap[B](f: (T) ⇒ GenTraversableOnce[B]): TraversableOnce[B]
- Неявный
- Этот член добавлен неявным преобразованием из Splitter[T] в MonadOps[T], выполненное методом MonadOps в scala.collection.TraversableOnce.
- Затенение
- Этот неявно унаследованный член затенён одним или несколькими членами в этом классе.
Для доступа к этому члену можно использовать явное указание типа:(splitter: MonadOps[T]).flatMap(f)
- Классы-определения
- MonadOps
def map[B](f: (T) ⇒ B): TraversableOnce[B]
- Неявный
- Этот член добавлен неявным преобразованием из Splitter[T] в MonadOps[T], выполненное методом MonadOps в scala.collection.TraversableOnce.
- Затенение
- Этот неявно унаследованный член затенён одним или несколькими членами в этом классе.
Для доступа к этому члену можно использовать явное указание типа:(splitter: MonadOps[T]).map(f)
- Классы-определения
- MonadOps
def withFilter(p: (T) ⇒ Boolean): Iterator[T]
- Неявный
- Этот член добавлен неявным преобразованием из Splitter[T] в MonadOps[T], выполненное методом MonadOps в scala.collection.TraversableOnce.
- Затенение
- Этот неявно унаследованный член затенён одним или несколькими членами в этом классе.
Для доступа к этому члену можно использовать явное указание типа:(splitter: 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/Splitter.html
Разделитель (или итератор разбиения) может быть разделен на более разделителей, которые перебирают непересекающиеся подмножества элементов.
тип элементов, по которым этот разделитель перебирает
2.9