Spec-Zone.ru › Scala 2.12 Library

Класс scala.collection.IndexedSeqLike.Elements

класс Elements extends AbstractIterator[A] with BufferedIterator[A] with Serializable

Класс итератора, возвращаемого методом iterator. Несколько операций take, drop, и slice над этим итератором объединены для повышения эффективности.

Атрибуты
protected
Аннотации
@SerialVersionUID()
Источник
IndexedSeqLike.scala
Линейные супертипы

Конструкторы экземпляров

новый Elements(start: Int, end: Int)

Типовые члены

класс GroupedIterator[B >: A] extends AbstractIterator[Seq[B]] with Iterator[Seq[B]]

Гибкий итератор для преобразования Iterator[A] в Iterator[Seq[A]] с настраиваемым размером последовательности, шагом и стратегией обработки элементов, которые не помещаются равномерно.

Типичные использования могут быть реализованы методами grouped и sliding.

Определяющие классы
Iterator

Члены-значения

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

Неявный
Этот член добавляется с помощью неявного преобразования из Elements в any2stringadd[Elements] с помощью метода any2stringadd в scala.Predef.
Definition Classes
any2stringadd

def ++(that: ⇒ Iterator[A]): Iterator[A]

[use case]

Конкатенация этого итератора с другим.

that

другой итератор

returns

новый итератор, который сначала возвращает значения, полученные от этого итератора, за которыми следуют значения, полученные от итератора that.

Definition Classes
Iterator
Полная сигнатура

def ->[B](y: B): (Elements, B)

Неявный
Этот член добавляется с помощью неявного преобразования из Elements в ArrowAssoc[Elements] с помощью метода ArrowAssoc в scala.Predef.
Definition Classes
ArrowAssoc
Аннотации
@inline()

def /:[B](z: B)(op: (B, A) ⇒ 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: (A, 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, A) ⇒ B, combop: (B, B) ⇒ B): B

Агрегирует результаты применения оператора к последующим элементам.

Это более общая форма fold и reduce. Аналогично foldLeft, так как результат не требует быть супертипом типа элемента. Кроме того, позволяет обрабатывать параллельные коллекции частями, а затем объединять промежуточные результаты.

aggregate разбивает итерируемый объект или итератор на разделы и обрабатывает каждый раздел, последовательно применяя seqop, начиная с z (как foldLeft). Эти промежуточные результаты затем объединяются с помощью combop (как fold). Реализация этой операции может работать с произвольным числом разделов коллекции (даже с 1), поэтому combop может вызываться произвольное количество раз (даже 0).

Например, рассмотрим суммирование целочисленных значений списка символов. Начальное значение для суммы — 0. Сначала seqop преобразует каждый входной символ в целое число и добавляет его к сумме (раздела). Затем combop просто суммирует промежуточные результаты разделов:

List('a', 'b', 'c').aggregate(0)({ (sum, ch) => sum + ch.toInt }, { (p1, p2) => p1 + p2 })
B

тип накапливаемых результатов

z

начальное значение для накопленного результата раздела — обычно это нейтральный элемент для оператора seqop (например, Nil для конкатенации списков или 0 для суммирования), и может быть вычислено более одного раза

seqop

оператор, используемый для накопления результатов внутри раздела

combop

ассоциативный оператор, используемый для объединения результатов из разных разделов

Definition Classes
TraversableOnce → GenTraversableOnce

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: Elements.this.type

Создаёт буферизованный итератор из этого итератора.

returns

буферизованный итератор, производящий те же значения, что и этот итератор.

Definition Classes
BufferedIterator → Iterator
Note

Переиспользование: После вызова этого метода следует удалить итератор, на котором был вызван метод, и использовать только возвращённый итератор. Использование старого итератора является неопределённым, может быть изменено и может привести к изменениям в новом итераторе.

See also

scala.collection.BufferedIterator

def clone(): AnyRef

Создаёт копию объекта-получателя.

По умолчанию метод clone зависит от платформы.

returns

копию объекта-получателя.

Attributes
protected[lang]
Definition Classes
AnyRef
Annotations
@throws( ... ) @native()
Note

не указано SLS в качестве члена AnyRef

def collect[B](pf: PartialFunction[A, B]): Iterator[B]

Создаёт итератор, преобразуя значения, получаемые из этого итератора, с помощью частичной функции, отбрасывая те значения, для которых частичная функция не определена.

pf

частичная функция, которая фильтрует и отображает итератор.

returns

новый итератор, который возвращает каждое значение x , полученное из этого итератора, для которого pf определена, а также отображённое значение pf(x).

Definition Classes
Iterator
Annotations
@migration
Migration

(Изменено в версии 2.8.0) collect изменилось. Предыдущее поведение можно воспроизвести с помощью toSeq.

Примечание

Повторное использование: После вызова этого метода следует удалить итератор, на котором он был вызван, и использовать только возвращённый итератор. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новом итераторе тоже.

def collectFirst[B](pf: PartialFunction[A, B]): Option[B]

Находит первый элемент итератора или перебираемого объекта, для которого заданная частичная функция определена, и применяет эту частичную функцию к нему.

Примечание: может не завершиться для бесконечных коллекций.

Примечание: может возвращать разные результаты для разных запусков, если только тип коллекции не упорядоченный.

pf

частичная функция

returns

значение Option, содержащее результат применения pf к первому значению, для которого она определена, или None , если такового не существует.

Definition Classes
TraversableOnce
Пример:

    Seq("a", 1, 5L).collectFirst({ case x: Int => x*10 }) = Some(10)

def contains(elem: Any): Boolean

Проверяет, содержит ли этот итератор заданное значение в качестве элемента.

Примечание: может не завершиться для бесконечных итераторов.

elem

элемент для проверки.

returns

true , если этот итератор производит некоторое значение, которое равно (как определяется ==) elem, false в противном случае.

Definition Classes
Iterator
Примечание

Повторное использование: После вызова этого метода следует удалить итератор, на котором он был вызван. Использование итератора не определено и может быть изменено.

def copyToArray(xs: Array[A], start: Int, len: Int): Unit

[use case]

Копирует выбранные значения, производимые этим итератором, в массив. Заполняет заданный массив xs , начиная с индекса start , не более чем len значениями, производимыми этим итератором. Копирование прекращается, как только достигается конец текущего итератора, конец массива или len элементов были скопированы.

Примечание: не завершится для бесконечных итераторов.

xs

массив для заполнения.

start

начальный индекс.

len

максимальное количество элементов для копирования.

Definition Classes
Iterator → TraversableOnce → GenTraversableOnce
Полная подпись

def copyToArray(xs: Array[A]): Unit

[use case]

Копирует элементы этого перебираемого объекта или итератора в массив. Заполняет заданный массив xs значениями этого перебираемого объекта или итератора. Копирование прекращается, как только достигается конец текущего перебираемого объекта или итератора, или конец целевого массива.

Примечание: не завершится для бесконечных итераторов.

xs

массив для заполнения.

Definition Classes
TraversableOnce → GenTraversableOnce
Полная подпись

def copyToArray(xs: Array[A], start: Int): Unit

[use case]

Копирует элементы этого перебираемого объекта или итератора в массив. Заполняет заданный массив xs значениями этого перебираемого объекта или итератора, начиная с индекса start. Копирование прекращается, как только достигается конец текущего перебираемого объекта или итератора, или конец целевого массива.

Примечание: не завершится для бесконечных итераторов.

xs

массив для заполнения.

start

начальный индекс.

Definition Classes
TraversableOnce → GenTraversableOnce
Полная подпись

def copyToBuffer[B >: A](dest: Buffer[B]): Unit

Копирует все элементы этого перебираемого объекта или итератора в буфер.

Примечание: не завершится для бесконечных коллекций.

dest

буфер, в который копируются элементы.

Definition Classes
TraversableOnce

def corresponds[B](that: GenTraversableOnce[B])(p: (A, B) ⇒ Boolean): Boolean

Проверяет, соответствует ли каждый элемент этого итератора соответствующему элементу другого набора, удовлетворяя предикату проверки.

B

тип элементов that

that

другой набор

p

предикат проверки, который связывает элементы из обоих наборов

returns

true если оба набора имеют одинаковую длину и p(x, y) является true для всех соответствующих элементов x этого итератора и y из that, в противном случае false

Definition Classes
Iterator

def count(p: (A) ⇒ Boolean): Int

Подсчитывает количество элементов в последовательности или итераторе, которые удовлетворяют предикату.

p

предикат, используемый для проверки элементов.

returns

количество элементов, удовлетворяющих предикату p.

Definition Classes
TraversableOnce → GenTraversableOnce

def drop(n: Int): Iterator[A]

Перемещает этот итератор дальше первых n элементов или длины итератора, что меньше.

n

количество элементов для удаления

returns

итератор, который производит все значения текущего итератора, за исключением первых n значений.

Definition Classes
Elements → Iterator
Note

Переиспользование: После вызова этого метода следует удалить итератор, на котором он был вызван, и использовать только итератор, который был возвращен. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новом итераторе тоже.

def dropWhile(p: (A) ⇒ Boolean): Iterator[A]

Пропускает самую длинную последовательность элементов этого итератора, которые удовлетворяют заданному предикату p, и возвращает итератор оставшихся элементов.

p

предикат, используемый для пропуска элементов.

returns

итератор, состоящий из оставшихся элементов

Definition Classes
Iterator
Note

Переиспользование: После вызова этого метода следует удалить итератор, на котором он был вызван, и использовать только итератор, который был возвращен. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новом итераторе тоже.

def duplicate: (Iterator[A], Iterator[A])

Создает два новых итератора, которые оба итерируются по тем же элементам, что и этот итератор (в том же порядке). Дублирующие итераторы считаются равными, если они находятся на том же элементе.

Поскольку большинство методов итераторов сделают исходный итератор непригодным для дальнейшего использования, этот метод предоставляет надежный способ вызова нескольких таких методов на итераторе.

returns

пара итераторов

Definition Classes
Iterator
Note

Реализация может выделять временное хранилище для элементов, проитерированных одним итератором, но еще не другим.

,

Переиспользование: После вызова этого метода следует удалить итератор, на котором он был вызван, и использовать только итераторы, которые были возвращены. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новых итераторах тоже.

def ensuring(cond: (Elements) ⇒ Boolean, msg: ⇒ Any): Elements

Неявный
Этот член добавлен неявным преобразованием из Elements в Ensuring[Elements] с помощью метода Ensuring в scala.Predef.
Definition Classes
Ensuring

def ensuring(cond: (Elements) ⇒ Boolean): Elements

Неявный
Этот член добавлен неявным преобразованием из Elements в Ensuring[Elements] с помощью метода Ensuring в scala.Predef.
Definition Classes
Ensuring

def ensuring(cond: Boolean, msg: ⇒ Any): Elements

Неявный
Этот член добавлен неявным преобразованием из Elements в Ensuring[Elements] с помощью метода Ensuring в scala.Predef.
Definition Classes
Ensuring

def ensuring(cond: Boolean): Elements

Неявный
Этот член добавлен неявным преобразованием из Elements в Ensuring[Elements] с помощью метода Ensuring в scala.Predef.
Definition Classes
Ensuring

final def eq(arg0: AnyRef): Boolean

Проверяет, является ли аргумент (that) ссылкой на объект-получатель (this).

Метод eq реализует отношение эквивалентности на непустых экземплярах AnyRef, и обладает тремя дополнительными свойствами:

    Он согласован: для любых непустых экземпляров x и y типа AnyRef, многократные вызовы x.eq(y) последовательно возвращают true или последовательно возвращают false. Для любого непустого экземпляра x типа AnyRef, x.eq(null) и null.eq(x) возвращают false. null.eq(null) возвращает true.

При переопределении методов equals или hashCode важно обеспечить согласованность их поведения с равенством ссылок. Таким образом, если два объекта являются ссылками друг на друга (o1 eq o2), они должны быть равны друг другу (o1 == o2) и должны хэшироваться к одному значению (o1.hashCode == o2.hashCode).

returns

true если аргумент является ссылкой на объект-получатель; false в противном случае.

Definition Classes
AnyRef

def equals(arg0: Any): Boolean

Метод равенства для ссылочных типов. Реализация по умолчанию делегирует вызов методу eq.

См. также equals в scala.Any.

returns

true если объект-получатель эквивалентен аргументу; false в противном случае.

Definition Classes
AnyRef → Any

def exists(p: (A) ⇒ Boolean): Boolean

Проверяет, выполняется ли предикат для некоторых значений, генерируемых этим итератором.

Примечание: может не завершиться для бесконечных итераторов.

p

предикат, используемый для проверки элементов.

returns

true если данный предикат p выполняется для некоторых значений, генерируемых этим итератором, в противном случае false.

Definition Classes
Iterator → TraversableOnce → GenTraversableOnce
Note

Переиспользование: после вызова этого метода, итератор, на котором он был вызван, следует удалить. Использование его после этого не определено и может измениться.

def filter(p: (A) ⇒ Boolean): Iterator[A]

Возвращает итератор по всем элементам этого итератора, удовлетворяющим предикату p. Порядок элементов сохраняется.

p

предикат, используемый для проверки значений.

returns

итератор, который генерирует те значения из этого итератора, которые удовлетворяют предикату p.

Definition Classes
Iterator
Note

Переиспользование: после вызова этого метода, итератор, на котором он был вызван, следует удалить, используя только возвращённый итератор. Использование старого итератора не определено, может измениться и может привести к изменениям в новом итераторе.

def filterNot(p: (A) ⇒ Boolean): Iterator[A]

Создаёт итератор по всем элементам этого итератора, которые не удовлетворяют предикату p.

p

предикат, используемый для проверки значений.

returns

итератор, который генерирует те значения из этого итератора, которые не удовлетворяют предикату p.

Definition Classes
Iterator
Note

Переиспользование: после вызова этого метода, итератор, на котором он был вызван, следует удалить, используя только возвращённый итератор. Использование старого итератора не определено, может измениться и может привести к изменениям в новом итераторе.

def finalize(): Unit

Вызывается сборщиком мусора для объекта-получателя, когда больше нет ссылок на объект.

Подробности о времени и условиях вызова метода finalize, а также взаимодействие finalize с нелокальными возвратами и исключениями, зависят от платформы.

Attributes
protected[lang]
Definition Classes
AnyRef
Annotations
@throws( classOf[java.lang.Throwable] )
Note

не указано SLS как член AnyRef

def find(p: (A) ⇒ Boolean): Option[A]

Находит первое значение, генерируемое итератором, удовлетворяющее предикату, если таковое есть.

Примечание: может не завершиться для бесконечных итераторов.

p

предикат, используемый для проверки значений.

returns

значение типа option, содержащее первое значение, генерируемое итератором, которое удовлетворяет предикату p, или None если такового нет.

Definition Classes
Iterator → TraversableOnce → GenTraversableOnce
Note

Переиспользование: после вызова этого метода, итератор, на котором он был вызван, следует удалить. Использование его после этого не определено и может измениться.

def flatMap[B](f: (A) ⇒ GenTraversableOnce[B]): Iterator[B]

Создаёт новый итератор, применяя функцию ко всем значениям, производимым этим итератором, и конкатенируя результаты.

f

функция, применяемая к каждому элементу.

returns

итератор, полученный путём применения заданной функции, возвращающей итератор f к каждому значению, производимому этим итератором, и конкатенации результатов.

Definition Classes
Iterator
Note

Использование: после вызова этого метода следует удалить итератор, на котором он был вызван, и использовать только возвращённый итератор. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новом итераторе.

def fold[A1 >: A](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, A) ⇒ 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: (A, 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: (A) ⇒ Boolean): Boolean

Проверяет, выполняется ли предикат для всех значений, производимых этим итератором.

Примечание: может не завершаться для бесконечных итераторов.

p

предикат, используемый для проверки элементов.

returns

true если заданный предикат p выполняется для всех значений, производимых этим итератором, в противном случае false.

Definition Classes
Iterator → TraversableOnce → GenTraversableOnce
Note

Использование: после вызова этого метода следует удалить итератор, на котором он был вызван. Его использование не определено и может быть изменено.

def foreach(f: (A) ⇒ Unit): Unit

[use case]

Применяет функцию f ко всем значениям, производимым этим итератором.

f

функция, которая применяется для побочного эффекта к каждому элементу. Результат функции f отбрасывается.

Definition Classes
Iterator → TraversableOnce → GenTraversableOnce
Полная сигнатура

def formatted(fmtstr: String): String

Возвращает строку, отформатированную в соответствии с заданной format строкой. Формат строк соответствует String.format (@см. java.lang.String.format).

Неявное
Этот член добавлен неявно при преобразовании из Elements в StringFormat[Elements] с помощью метода StringFormat в scala.Predef.
Классы-определения
StringFormat
Аннотации
@inline()

final def getClass(): Class[_]

Возвращает представление класса объекта во время выполнения.

возвращает

объект класса, соответствующий типу получателя во время выполнения.

Классы-определения
AnyRef → Any
Аннотации
@native()

def grouped[B >: A](size: Int): GroupedIterator[B]

Возвращает итератор, который группирует этот итератор в блоки фиксированного размера. Примеры использования:

// Returns List(List(1, 2, 3), List(4, 5, 6), List(7)))
(1 to 7).iterator grouped 3 toList
// Returns List(List(1, 2, 3), List(4, 5, 6))
(1 to 7).iterator grouped 3 withPartial false toList
// Returns List(List(1, 2, 3), List(4, 5, 6), List(7, 20, 25)
// Illustrating that withPadding's argument is by-name.
val it2 = Iterator.iterate(20)(_ + 5)
(1 to 7).iterator grouped 3 withPadding it2.next toList
Классы-определения
Iterator
Примечание

Повторное использование: после вызова этого метода следует удалить итератор, на котором он был вызван, и использовать только возвращённый итератор. Использование старого итератора не определено, может измениться и может привести к изменениям в новом итераторе.

def hasDefiniteSize: Boolean

Проверяет, имеет ли этот итератор известный размер.

возвращает

true для пустых итераторов, false в противном случае.

Классы-определения
Iterator → TraversableOnce → GenTraversableOnce
Примечание

Повторное использование: итератор остаётся допустимым для дальнейшего использования независимо от возвращаемого результата.

def hasNext: Boolean

Проверяет, может ли этот итератор предоставить другой элемент.

возвращает

true если последующий вызов next вернёт элемент, false в противном случае.

Классы-определения
Elements → Iterator
Примечание

Повторное использование: итератор остаётся допустимым для дальнейшего использования независимо от возвращаемого результата.

def hashCode(): Int

Метод hashCode для ссылочных типов. См. hashCode в scala.Any.

возвращает

значение хэш-кода для этого объекта.

Классы-определения
AnyRef → Any
Аннотации
@native()

def head: A

Возвращает следующий элемент итератора, не продвигаясь вперёд.

Классы-определения
Elements → BufferedIterator

def headOption: Option[A]

Возвращает опцию следующего элемента итератора, не продвигаясь вперёд.

возвращает

следующий элемент этого итератора, если у него есть следующий элемент None в противном случае

Классы-определения
BufferedIterator

def indexOf[B >: A](elem: B, from: Int): Int

Возвращает индекс первого вхождения указанного объекта в этом итерируемом объекте после или на некотором начальном индексе.

Примечание: может не завершаться для бесконечных итераторов.

elem

элемент для поиска.

from

начальный индекс

возвращает

индекс >= from первого вхождения elem в значениях, производимых этим итератором, или -1, если такого элемента не существует до тех пор, пока не будет достигнут конец итератора.

Классы-определения
Iterator
Примечание

Повторное использование: после вызова этого метода следует удалить итератор, на котором он был вызван. Его использование не определено и может быть изменено.

def indexOf[B >: A](elem: B): Int

Возвращает индекс первого вхождения указанного объекта в этом итерируемом объекте.

Примечание: может не завершаться для бесконечных итераторов.

elem

элемент для поиска.

возвращает

индекс первого вхождения elem в значениях, производимых этим итератором, или -1, если такого элемента не существует до тех пор, пока не будет достигнут конец итератора.

Классы-определения
Iterator
Примечание

Повторное использование: после вызова этого метода следует удалить итератор, на котором он был вызван. Его использование не определено и может быть изменено.

def indexWhere(p: (A) ⇒ Boolean, from: Int): Int

Возвращает индекс первого произведённого значения, удовлетворяющего предикату, или -1, после или на некотором начальном индексе.

Примечание: может не завершаться для бесконечных итераторов.

p

предикат для проверки значений

from

начальный индекс

returns

индекс >= from первого произведённого значения, удовлетворяющего p, или -1, если такого элемента не существует до достижения конца итератора.

Definition Classes
Iterator
Note

Повторное использование: После вызова этого метода нужно удалить итератор, на котором он был вызван. Использование его неопределено и может измениться.

def indexWhere(p: (A) ⇒ 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: (A) ⇒ B): Iterator[B]

Создаёт новый итератор, который отображает все произведённые значения этого итератора в новые значения с помощью функции преобразования.

f

функция преобразования

returns

новый итератор, который преобразует каждое значение, производимое этим итератором, путём применения функции f к нему.

Definition Classes
Iterator
Note

Повторное использование: После вызова этого метода нужно удалить итератор, на котором он был вызван, и использовать только возвращённый итератор. Использование старого итератора не определено, может измениться и может привести к изменениям в новом итераторе.

def max: A

[use case]

Находит наибольший элемент.

returns

наибольший элемент этого перебираемого объекта или итератора.

Definition Classes
TraversableOnce → GenTraversableOnce
Полная сигнатура
Исключения

UnsupportedOperationException, если этот перебираемый объект или итератор пустой.

def maxBy[B](f: (A) ⇒ B): A

[use case]

Находит первый элемент, который даёт наибольшее значение, измеряемое функцией f.

B

Тип результата функции f.

f

Функция измерения.

returns

первый элемент этого перебираемого объекта или итератора с наибольшим значением, измеряемым функцией f.

Definition Classes
TraversableOnce → GenTraversableOnce
Полная сигнатура
Исключения

UnsupportedOperationException, если этот перебираемый объект или итератор пустой.

def min: A

[use case]

Находит наименьший элемент.

returns

наименьший элемент этого перебираемого объекта или итератора

Definition Classes
TraversableOnce → GenTraversableOnce
Полная сигнатура
Исключения

UnsupportedOperationException, если этот перебираемый объект или итератор пустой.

def minBy[B](f: (A) ⇒ B): A

[use case]

Находит первый элемент, который дает наименьшее значение, измеренное функцией f.

B

Тип результата функции f.

f

Функция измерения.

returns

первый элемент этого перебираемого или итератора с наименьшим значением, измеренным функцией f.

Definition Classes
TraversableOnce → GenTraversableOnce
Полная сигнатура
Исключения

UnsupportedOperationException, если этот перебираемый или итератор пуст.

def mkString: String

Отображает все элементы этого перебираемого или итератора в строке.

returns

строковое представление этого перебираемого или итератора. В результирующей строке строковые представления (относительно метода toString) всех элементов этого перебираемого или итератора следуют друг за другом без разделительной строки.

Definition Classes
TraversableOnce → GenTraversableOnce

def mkString(sep: String): String

Отображает все элементы этого перебираемого или итератора в строке с использованием разделительной строки.

sep

разделительная строка.

returns

строковое представление этого перебираемого или итератора. В результирующей строке строковые представления (относительно метода toString) всех элементов этого перебираемого или итератора разделяются строкой sep.

Definition Classes
TraversableOnce → GenTraversableOnce
Пример:

    List(1, 2, 3).mkString("|") = "1|2|3"

def mkString(start: String, sep: String, end: String): String

Отображает все элементы этого перебираемого или итератора в строке, используя начальную, конечную и разделительные строки.

start

начальная строка.

sep

разделительная строка.

end

конечная строка.

returns

строковое представление этого перебираемого или итератора. Результирующая строка начинается со строки start и заканчивается строкой end. Внутри, строковые представления (относительно метода toString) всех элементов этого перебираемого или итератора разделяются строкой sep.

Definition Classes
TraversableOnce → GenTraversableOnce
Пример:

    List(1, 2, 3).mkString("(", "; ", ")") = "(1; 2; 3)"

final def ne(arg0: AnyRef): Boolean

Эквивалентно !(this eq that).

returns

true , если аргумент не является ссылкой на объект-получатель; false в противном случае.

Definition Classes
AnyRef

def next(): A

Производит следующий элемент этого итератора.

returns

следующий элемент этого итератора, если hasNext равен true, в противном случае поведение не определено.

Definition Classes
Elements → Iterator
Примечание

Повторное использование: итератор остается действительным для дальнейшего использования, независимо от возвращаемого результата.

def nonEmpty: Boolean

Проверяет, не является ли перебираемый или итератор пустым.

returns

true если перебираемый или итератор содержит хотя бы один элемент, false в противном случае.

Definition Classes
TraversableOnce → GenTraversableOnce

final def notify(): Unit

Разбуждает один поток, ждущий монитора объекта-получателя.

Definition Classes
AnyRef
Аннотации
@native()
Примечание

не указано SLS как член AnyRef

final def notifyAll(): Unit

Разбуждает все потоки, ждущие монитора объекта-получателя.

Definition Classes
AnyRef
Аннотации
@native()
Примечание

не указано SLS как член AnyRef

def padTo(len: Int, elem: A): Iterator[A]

[use case]

Добавляет значение элемента к этому итератору до тех пор, пока не будет достигнута заданная целевая длина.

len

целевая длина

elem

значение заполнения

returns

новый итератор, состоящий из всех значений этого итератора, за которым следует минимальное количество повторений elem, чтобы количество произведенных значений было не менее len.

Definition Classes
Iterator
Полная сигнатура

def partition(p: (A) ⇒ Boolean): (Iterator[A], Iterator[A])

Разделяет этот итератор на два итератора в соответствии с предикатом.

p

предикат, по которому выполняется разделение

returns

пара итераторов: итератор, удовлетворяющий предикату p , и итератор, который этого не делает. Относительный порядок элементов в результирующих итераторах совпадает с порядком в исходном итераторе.

Definition Classes
Iterator
Примечание

Переиспользование: После вызова этого метода следует удалить вызвавший его итератор и использовать только возвращённые итераторы. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новых итераторах тоже.

def patch[B >: A](from: Int, patchElems: Iterator[B], replaced: Int): Iterator[B]

Возвращает этот итератор с изменёнными значениями.

Замена по отрицательным индексам эквивалентна замене, начинающейся с 0.

Замена по индексам, равным или большим длины исходного итератора, добавляет замену в конец. Если замещено больше значений, чем существует, избыток игнорируется.

from

Индекс начала замены

patchElems

Итератор значений замены

replaced

Количество значений в исходном итераторе, которые заменяются заменой.

Definition Classes
Iterator
Примечание

Переиспользование: После вызова этого метода необходимо удалить вызвавший его итератор, а также переданный в качестве параметра, и использовать только возвращённый итератор. Использование старых итераторов не определено, может быть изменено и может привести к изменениям в новом итераторе тоже.

def product: A

[use case]

Перемножает элементы этой коллекции.

returns

произведение всех элементов в этом итерируемом объекте или итераторе чисел типа Int. Вместо Int, может быть использован любой другой тип T с неявным Numeric[T] реализацией в качестве типа элементов итерируемого объекта или итератора и как тип результата product. Примеры таких типов: Long, Float, Double, BigInt.

Definition Classes
TraversableOnce → GenTraversableOnce
Полная сигнатура

def reduce[A1 >: A](op: (A1, A1) ⇒ A1): A1

Сводит элементы этого итерируемого объекта или итератора, используя заданный ассоциативный бинарный оператор.

Порядок выполнения операций над элементами не определён и может быть не детерминированным.

A1

Параметр типа для бинарного оператора, являющийся супертипом A.

op

Бинарный оператор, который должен быть ассоциативным.

returns

Результат применения оператора reduce op между всеми элементами, если итерируемый объект или итератор непустой.

Definition Classes
TraversableOnce → GenTraversableOnce
Исключения

UnsupportedOperationException, если этот итерируемый объект или итератор пустой.

def reduceLeft[B >: A](op: (B, A) ⇒ 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 >: A](op: (B, A) ⇒ B): Option[B]

Возможная применённая бинарная операция ко всем элементам этого итерируемого объекта или итератора слева направо.

Примечание: не завершит работу для бесконечных коллекций.

Примечание: может возвращать разные результаты для разных запусков, если только тип базовой коллекции не упорядочен или оператор не ассоциативен и коммутативен.

B

тип результата бинарного оператора.

op

бинарный оператор.

returns

опциональное значение, содержащее результат reduceLeft(op) , если этот итерируемый объект или итератор непустой, None в противном случае.

Definition Classes
TraversableOnce → GenTraversableOnce

def reduceOption[A1 >: A](op: (A1, A1) ⇒ A1): Option[A1]

Уменьшает элементы этого итерируемого объекта или итератора, если таковые имеются, с использованием указанного ассоциативного бинарного оператора.

Порядок выполнения операций над элементами не определен и может быть не детерминированным.

A1

Параметр типа для бинарного оператора, являющийся супертипом A.

op

Бинарный оператор, который должен быть ассоциативным.

returns

Значение типа Option, содержащее результат применения оператора reduce к всем элементам, если коллекция непуста, и None в противном случае.

Definition Classes
TraversableOnce → GenTraversableOnce

def reduceRight[B >: A](op: (A, 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 >: A](op: (A, B) ⇒ B): Option[B]

Необязательно применяет бинарный оператор ко всем элементам этого итерируемого объекта или итератора, справа налево.

Примечание: не завершится для коллекций бесконечного размера.

Примечание: может возвращать разные результаты для разных запусков, если только тип базовой коллекции не является упорядоченным или оператор не является ассоциативным и коммутативным.

B

тип результата бинарного оператора.

op

бинарный оператор.

returns

значение типа Option, содержащее результат reduceRight(op), если этот итерируемый объект или итератор непуст, None в противном случае.

Definition Classes
TraversableOnce → GenTraversableOnce

def reversed: List[A]

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, A) ⇒ B): Iterator[B]

Создаёт коллекцию, содержащую кумулятивные результаты применения оператора слева направо, включая начальное значение.

Примечание: не завершится для бесконечных итераторов.

Примечание: может возвращать разные результаты для разных запусков, если только тип базовой коллекции не является упорядоченным.

B

тип элементов в результирующей коллекции

z

начальное значение

op

бинарный оператор, применяемый к промежуточному результату и элементу

returns

итератор с промежуточными результатами

Definition Classes
Iterator
Примечание

Переиспользование: После вызова этого метода следует удалить вызвавший итератор и использовать только возвращённый итератор. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новом итераторе.

def scanRight[B](z: B)(op: (A, 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[A]

Версия этого набора с реализацией всех операций последовательно (т.е., в однопоточном режиме).

Этот метод возвращает ссылку на этот набор. В параллельных наборах он переопределяется для возвращения последовательной реализации этого набора. В обоих случаях сложность составляет O(1).

возвращает

последовательный вид набора.

Классы определения
Iterator → TraversableOnce → GenTraversableOnce

def size: Int

Размер этого перебираемого объекта или итератора.

Примечание: не будет завершаться для наборов бесконечного размера.

возвращает

количество элементов в этом перебираемом объекте или итераторе.

Классы определения
TraversableOnce → GenTraversableOnce

def sizeHintIfCheap: Int

Размер этого набора или итератора, если он может быть вычислен с низкими затратами.

возвращает

количество элементов в этом наборе или итераторе, или -1, если размер не может быть определен с низкими затратами

Атрибуты
protected[collection]
Классы определения
GenTraversableOnce

def slice(from: Int, until: Int): Iterator[A]

Создаёт итератор, возвращающий интервал значений, производимых этим итератором.

from

индекс первого элемента в этом итераторе, который является частью среза. Если отрицательный, срез начинается с нуля.

until

индекс первого элемента, следующего за срезом. Если отрицательный, срез пустой.

возвращает

итератор, который продвигает этот итератор мимо первых from элементов, используя drop, и затем берёт until - from элементов, используя take.

Классы определения
Elements → Iterator
Примечание

Переиспользование: После вызова этого метода следует удалить итератор, на котором он был вызван, и использовать только возвращённый итератор. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новом итераторе тоже.

def sliceIterator(from: Int, until: Int): Iterator[A]

Создаёт необязательно ограниченный срез, неограниченный, если until отрицательный.

Атрибуты
protected
Классы определения
Iterator

def sliding[B >: A](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: (A) ⇒ Boolean): (Iterator[A], Iterator[A])

Разделяет этот итератор на пару префикс/суффикс в соответствии с предикатом.

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[A]

Выбирает первые n значений этого итератора.

n

количество значений для взятия

returns

итератор, генерирующий только первые n значения этого итератора, или весь итератор, если он генерирует меньше n значений.

Definition Classes
Elements → Iterator
Note

Переиспользование: после вызова этого метода следует удалить итератор, на котором он был вызван, и использовать только возвращенный итератор. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новом итераторе тоже.

def takeWhile(p: (A) ⇒ Boolean): Iterator[A]

Возвращает самый длинный префикс значений, производимых этим итератором, которые удовлетворяют предикату.

p

Предикат, используемый для проверки элементов.

returns

Итератор, возвращающий значения, производимые этим итератором, пока этот итератор производит значения, удовлетворяющие предикату p.

Definition Classes
Iterator
Note

Переиспользование: после вызова этого метода следует удалить итератор, на котором он был вызван, и использовать только возвращенный итератор. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новом итераторе тоже.

def to[Col[_]]: Col[A]

[use case]

Преобразует эту итерацию или последовательность в другую, копируя все элементы.

Примечание: не будет завершаться для бесконечных итераторов.

Col

Тип коллекции, который нужно построить.

returns

новая коллекция, содержащая все элементы этой итерации или последовательности.

Definition Classes
TraversableOnce → GenTraversableOnce
Полная подпись

def toArray: Array[A]

[use case]

Преобразует эту итерацию или последовательность в массив.

Примечание: не будет завершаться для бесконечных итераторов.

returns

массив, содержащий все элементы этой итерации или последовательности. Должен быть доступен ClassTag для типа элементов этой итерации или последовательности.

Definition Classes
TraversableOnce → GenTraversableOnce
Полная подпись

def toBuffer[B >: A]: Buffer[B]

Использует содержимое этой итерации или последовательности для создания нового изменяемого буфера.

Примечание: не будет завершаться для бесконечных коллекций.

returns

буфер, содержащий все элементы этой итерации или последовательности.

Definition Classes
TraversableOnce → GenTraversableOnce

def toIndexedSeq: immutable.IndexedSeq[A]

Преобразует эту итерацию или последовательность в индексированную последовательность.

Примечание: не будет завершаться для бесконечных коллекций.

returns

индексированная последовательность, содержащая все элементы этой итерации или последовательности.

Definition Classes
TraversableOnce → GenTraversableOnce

def toIterable: Iterable[A]

Преобразует эту итерацию или последовательность в коллекцию итерируемую коллекцию. Обратите внимание, что выбор целевого Iterable является ленивым в этой реализации по умолчанию, так как этот TraversableOnce может быть ленивым и неопределенным (т. е. это может быть итератор, который может быть пройден только один раз).

Примечание: не будет завершаться для бесконечных коллекций.

returns

итерируемая коллекция, содержащая все элементы этой итерации или последовательности.

Definition Classes
TraversableOnce → GenTraversableOnce

def toIterator: Iterator[A]

Возвращает итератор по элементам в этой итерации или последовательности. Вернет тот же итератор, если этот экземпляр уже является итератором.

Примечание: не будет завершаться для бесконечных итераторов.

returns

итератор, содержащий все элементы этой итерации или последовательности.

Definition Classes
Iterator → GenTraversableOnce

def toList: List[A]

Преобразует эту итерацию или последовательность в список.

Примечание: не будет завершаться для бесконечных коллекций.

returns

список, содержащий все элементы этой итерации или последовательности.

Definition Classes
TraversableOnce → GenTraversableOnce

def toMap[T, U]: Map[T, U]

[use case]

Преобразует эту итерацию или последовательность в словарь. Этот метод недоступен, если элементы не являются членами Tuple2, каждая ((T, U)) становится парой ключ-значение в словаре. Повторяющиеся ключи будут перезаписаны более поздними ключами: если это неупорядоченная коллекция, какой ключ находится в результирующем словаре, не определено.

Примечание: не будет завершаться для бесконечных итераторов.

returns

словарь типа immutable.Map[T, U], содержащий все пары ключ/значение типа (T, U) этой итерации или последовательности.

Definition Classes
TraversableOnce → GenTraversableOnce
Полная подпись

def toParArray: ParArray[T]

Неявный
Этот член добавлен неявным преобразованием из Elements в CollectionsHaveToParArray[Elements, T] с помощью метода CollectionsHaveToParArray в scala.collection.parallel. Это преобразование будет выполнено только если в области видимости есть неявное значение типа (Elements) ⇒ GenTraversableOnce[T].
Определяющие классы
CollectionsHaveToParArray

def toSeq: Seq[A]

Преобразует эту последовательность или итератор в последовательность. Как и в toIterable, эта реализация ленивая, так как эта TraversableOnce может быть ленивой и невычисленной.

Примечание: не будет завершаться для бесконечных коллекций.

возвращает

последовательность, содержащую все элементы этой последовательности или итератора.

Определяющие классы
TraversableOnce → GenTraversableOnce

def toSet[B >: A]: immutable.Set[B]

Преобразует эту последовательность или итератор в множество.

Примечание: не будет завершаться для бесконечных коллекций.

возвращает

множество, содержащее все элементы этой последовательности или итератора.

Определяющие классы
TraversableOnce → GenTraversableOnce

def toStream: immutable.Stream[A]

Преобразует эту последовательность или итератор в поток.

возвращает

поток, содержащий все элементы этой последовательности или итератора.

Определяющие классы
Iterator → GenTraversableOnce

def toString(): String

Преобразует этот итератор в строку.

возвращает

"<iterator>" пуст или нет.

Определяющие классы
Iterator → AnyRef → Any
Примечание

Переиспользование: итератор остается действительным для дальнейшего использования независимо от возвращаемого результата.

def toTraversable: Traversable[A]

Преобразует эту последовательность или итератор в неопределённое значение Traversable. Вернёт ту же коллекцию, если этот экземпляр уже Traversable.

Примечание: не завершится для бесконечных итераторов.

возвращает

Traversable, содержащий все элементы этой последовательности или итератора.

Определяющие классы
Iterator → TraversableOnce → GenTraversableOnce

def toVector: Vector[A]

Преобразует эту последовательность или итератор в вектор.

Примечание: не завершится для бесконечных коллекций.

возвращает

вектор, содержащий все элементы этой последовательности или итератора.

Определяющие классы
TraversableOnce → GenTraversableOnce

final def wait(): Unit

Определяющие классы
AnyRef
Аннотации
@throws( ... )

final def wait(arg0: Long, arg1: Int): Unit

Определяющие классы
AnyRef
Аннотации
@throws( ... )

final def wait(arg0: Long): Unit

Определяющие классы
AnyRef
Аннотации
@throws( ... ) @native()

def withFilter(p: (A) ⇒ Boolean): Iterator[A]

Создаёт итератор над всеми элементами этого итератора, удовлетворяющими предикату p. Порядок элементов сохраняется.

Примечание: withFilter эквивалентно filter для итераторов. Оно существует, чтобы выражения for с фильтрами работали с итераторами.

p

предикат, используемый для проверки значений.

возвращает

итератор, который генерирует те значения из этого итератора, которые удовлетворяют предикату p.

Классы-определения
Iterator
Примечание

Переиспользование: после вызова этого метода следует отбросить итератор, на котором он был вызван, и использовать только возвращённый итератор. Использование старого итератора не определено, может измениться и может привести к изменениям в новом итераторе.

def zip[B](that: Iterator[B]): Iterator[(A, B)]

Создаёт итератор, образованный из этого итератора и другого итератора путём объединения соответствующих значений в пары. Если один из двух итераторов длиннее другого, его оставшиеся элементы игнорируются.

that

Итератор, предоставляющий вторую половину каждой пары результатов

возвращает

новый итератор, содержащий пары, состоящие из соответствующих элементов этого итератора и that. Количество элементов, возвращаемых новым итератором, является минимальным из количества элементов, возвращаемых этим итератором и that.

Классы-определения
Iterator
Примечание

Переиспользование: после вызова этого метода следует отбросить итератор, на котором он был вызван, а также тот, что был передан в качестве параметра, и использовать только возвращённый итератор. Использование старых итераторов не определено, может измениться и может привести к изменениям в новом итераторе.

def zipAll[B](that: Iterator[B], thisElem: A, thatElem: B): Iterator[(A, B)]

[use case]

Создаёт итератор, образованный из этого итератора и другого итератора путём объединения соответствующих элементов в пары. Если один из двух итераторов короче другого, для расширения короче итератора до длины более длинного используются плацехолдеры.

that

итератор that может иметь другую длину, чем самописной итератор.

thisElem

элемент thisElem используется для заполнения результирующего итератора, если самописной итератор короче that

thatElem

элемент thatElem используется для заполнения результирующего итератора, если that короче самописного итератора

возвращает

новый итератор, содержащий пары, состоящие из соответствующих значений этого итератора и that. Длина возвращённого итератора является максимальной из длин этого итератора и that . Если этот итератор короче that, значения thisElem используются для заполнения результата. Если that короче этого итератора, значения thatElem используются для заполнения результата.

Классы-определения
Iterator
Полная сигнатура

def zipWithIndex: Iterator[(A, Int)]

Создаёт итератор, который объединяет каждый элемент, производимый этим итератором, со своим индексом, начиная с 0.

возвращает

новый итератор, содержащий пары, состоящие из соответствующих элементов этого итератора и их индексов.

Классы-определения
Iterator
Примечание

Переиспользование: после вызова этого метода следует отбросить итератор, на котором он был вызван, и использовать только возвращённый итератор. Использование старого итератора не определено, может измениться и может привести к изменениям в новом итераторе.

def →[B](y: B): (Elements, B)

Неявный
Этот член добавляется неявным преобразованием из Elements в ArrowAssoc[Elements] с помощью метода ArrowAssoc в scala.Predef.
Классы-определения
ArrowAssoc

Затенённые неявные члены значения

def filter(p: (A) ⇒ Boolean): TraversableOnce[A]

Неявный
Этот член добавлен с помощью неявного преобразования из Elements в MonadOps[A] с помощью метода MonadOps в scala.collection.TraversableOnce.
Затенение
Этот неявно унаследованный член затенено одним или несколькими членами в этом классе.
Для доступа к этому члену можно использовать приведение типа:
(elements: MonadOps[A]).filter(p)
Классы определений
MonadOps

def flatMap[B](f: (A) ⇒ GenTraversableOnce[B]): TraversableOnce[B]

Неявный
Этот член добавлен с помощью неявного преобразования из Elements в MonadOps[A] с помощью метода MonadOps в scala.collection.TraversableOnce.
Затенение
Этот неявно унаследованный член затенено одним или несколькими членами в этом классе.
Для доступа к этому члену можно использовать приведение типа:
(elements: MonadOps[A]).flatMap(f)
Классы определений
MonadOps

def map[B](f: (A) ⇒ B): TraversableOnce[B]

Неявный
Этот член добавлен с помощью неявного преобразования из Elements в MonadOps[A] с помощью метода MonadOps в scala.collection.TraversableOnce.
Затенение
Этот неявно унаследованный член затенено одним или несколькими членами в этом классе.
Для доступа к этому члену можно использовать приведение типа:
(elements: MonadOps[A]).map(f)
Классы определений
MonadOps

def withFilter(p: (A) ⇒ Boolean): Iterator[A]

Неявный
Этот член добавлен с помощью неявного преобразования из Elements в MonadOps[A] с помощью метода MonadOps в scala.collection.TraversableOnce.
Затенение
Этот неявно унаследованный член затенено одним или несколькими членами в этом классе.
Для доступа к этому члену можно использовать приведение типа:
(elements: MonadOps[A]).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/IndexedSeqLike$Elements.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API