Spec-Zone.ru › Scala 2.12 Library

Класс scala.collection.immutable.VectorIterator

класс VectorIterator[+A] extends AbstractIterator[A] with Iterator[A] with VectorPointer[A]

Источник
Vector.scala
Линейные надтипы
Известные подклассы

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

новый VectorIterator(_startIndex: Int, endIndex: Int)

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

класс GroupedIterator[B >: A] extends AbstractIterator[Последовательность[B]] with Iterator[Последовательность[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

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

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

[Пример использования]

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

that

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

returns

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

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

def ->[B](y: B): (VectorIterator[A], B)

Неявный
Этот член добавлен неявным преобразованием из VectorIterator[A] в ArrowAssoc[VectorIterator[A]] с помощью метода 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).

возвращает

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

Определяющие классы
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

строка, в которую добавляются элементы.

возвращает

строка b , в которую были добавлены элементы.

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

def addString(b: StringBuilder, sep: String): StringBuilder

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

Пример:

scala> val a = List(1,2,3,4)
a: List[Int] = List(1, 2, 3, 4)

scala> val b = new StringBuilder()
b: StringBuilder =

scala> a.addString(b, ", ")
res0: StringBuilder = 1, 2, 3, 4
b

строка, в которую добавляются элементы.

sep

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

возвращает

строка b , в которую были добавлены элементы.

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

def addString(b: StringBuilder, start: String, sep: String, end: String): StringBuilder

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

Пример:

scala> val a = List(1,2,3,4)
a: List[Int] = List(1, 2, 3, 4)

scala> val b = new StringBuilder()
b: StringBuilder =

scala> a.addString(b , "List(" , ", " , ")")
res5: StringBuilder = List(1, 2, 3, 4)
b

строка, в которую добавляются элементы.

start

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

sep

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

end

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

возвращает

строка b , в которую были добавлены элементы.

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

def aggregate[B](z: ⇒ B)(seqop: (B, 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

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

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

final def asInstanceOf[T0]: T0

Преобразовать объект-получатель к типу T0.

Обратите внимание, что успешность преобразования во время выполнения зависит от семантики стирания Scala. Следовательно, выражение 1.asInstanceOf[String] выбросит ClassCastException во время выполнения, в то время как выражение List(1).asInstanceOf[List[String]] не выбросит исключения. В последнем примере, потому что тип аргумента стирается во время компиляции, невозможно проверить, соответствуют ли содержимое списка требуемому типу.

возвращает

объект-получатель.

Определяющие классы
Any
Исключения

ClassCastException , если объект-получатель не является экземпляром стирания типа T0.

def buffered: BufferedIterator[A]

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

возвращает

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

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

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

См. также

scala.collection.BufferedIterator

def clone(): AnyRef

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

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

возвращает

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

Атрибуты
protected[lang]
Определяющие классы
AnyRef
Аннотации
@throws( ... ) @native()
Примечание

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

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

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

pf

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

возвращает

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

Определяющие классы
Iterator
Аннотации
@migration
Миграция

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

Примечание

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

def collectFirst[B](pf: PartialFunction[A, 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[A], start: Int, len: Int): Unit

[use case]

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

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

xs

массив, который нужно заполнить.

start

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

len

максимальное количество копируемых элементов.

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

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

[use case]

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

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

xs

массив, который нужно заполнить.

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

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

[use case]

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

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

xs

массив, который нужно заполнить.

start

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

Определяющие классы
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
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: (VectorIterator[A]) ⇒ Boolean, msg: ⇒ Any): VectorIterator[A]

Implicit
Этот член добавлен неявным преобразованием из VectorIterator[A] в Ensuring[VectorIterator[A]] выполненным методом Ensuring в scala.Predef.
Definition Classes
Ensuring

def ensuring(cond: (VectorIterator[A]) ⇒ Boolean): VectorIterator[A]

Implicit
Этот член добавлен неявным преобразованием из VectorIterator[A] в Ensuring[VectorIterator[A]] выполненным методом Ensuring в scala.Predef.
Definition Classes
Ensuring

def ensuring(cond: Boolean, msg: ⇒ Any): VectorIterator[A]

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

def ensuring(cond: Boolean): VectorIterator[A]

Implicit
Этот член добавлен неявным преобразованием из VectorIterator[A] в Ensuring[VectorIterator[A]] с помощью метода 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
Примечание

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

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

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

p

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

returns

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

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

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

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

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

p

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

returns

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

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

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

def finalize(): Unit

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

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

Attributes
protected[lang]
Definition Classes
AnyRef
Annotations
@throws( classOf[java.lang.Throwable] )
Примечание

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

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

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

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

p

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

returns

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

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

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

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

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

f

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

returns

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

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

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

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

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

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

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

A1

типовой параметр для бинарного оператора, надтип A.

z

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

op

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

returns

результат применения оператора сворачивания op ко всем элементам и z, или z, если этот обход или итератор пуст.

Определяющие классы
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, если этот обход или итератор пуст.

Определяющие классы
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, если этот обход или итератор пуст.

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

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

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

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

p

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

returns

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

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

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

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).

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

final def getClass(): Class[_]

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

возвращает

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

Definition Classes
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
Definition Classes
Iterator
Примечание

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

def hasDefiniteSize: Boolean

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

возвращает

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

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

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

def hasNext: Boolean

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

возвращает

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

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

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

def hashCode(): Int

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

возвращает

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

Definition Classes
AnyRef → Any
Аннотации
@native()

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

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

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

elem

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

from

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

возвращает

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

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

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

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

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

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

elem

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

возвращает

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

Definition Classes
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]

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

возвращает

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

Определяющие классы
TraversableOnce → GenTraversableOnce
Полная сигнатура
Исключения

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

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

[use case]

Находит первый элемент, который дает наименьшее значение, измеренное функцией 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 next(): A

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

возвращает

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

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

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

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: 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

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

Definition Classes
TraversableOnce → GenTraversableOnce

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

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

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

A1

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

op

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

returns

Значение Option, содержащее результат применения оператора reduce op к всем элементам, если коллекция не пуста, и 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: scala.List[A]

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

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

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

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

B

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

z

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

op

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

returns

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

Definition Classes
Iterator
Note

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

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).

returns

последовательный вид коллекции.

Definition Classes
Iterator → TraversableOnce → GenTraversableOnce

def size: Int

Размер этого обходчика или итератора.

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

returns

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

Definition Classes
TraversableOnce → GenTraversableOnce

def sizeHintIfCheap: Int

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

returns

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

Attributes
protected[collection]
Definition Classes
GenTraversableOnce

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

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

from

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

until

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

returns

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

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

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

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

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

Attributes
protected
Definition Classes
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
returns

Итератор, производящий Seq[B] размером size, за исключением последнего элемента (который может быть единственным), который будет усечён, если оставшихся элементов меньше, чем size элементов, которые нужно сгруппировать. Это поведение можно настроить.

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

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

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

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

p

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

returns

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

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

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

def sum: A

[use case]

Суммирует элементы этого набора.

returns

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

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

final def synchronized[T0](arg0: ⇒ T0): T0

Definition Classes
AnyRef

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

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

n

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

returns

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

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

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

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

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

p

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

returns

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

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

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

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

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

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

returns

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

Definition Classes
TraversableOnce → GenTraversableOnce

def toIterable: collection.Iterable[A]

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

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

returns

итерируемая коллекция, содержащая все элементы этого итерируемого объекта или итератора.

Definition Classes
TraversableOnce → GenTraversableOnce

def toIterator: Iterator[A]

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

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

returns

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

Definition Classes
Iterator → GenTraversableOnce

def toList: scala.List[A]

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

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

возвращает

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

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

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

[use case]

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

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

возвращает

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

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

def toSeq: collection.Seq[A]

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

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

возвращает

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

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

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

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

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

возвращает

множество, содержащее все элементы этого итерируемого множества или итератора.

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

def toStream: Stream[A]

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

возвращает

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

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

def toString(): String

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

возвращает

"<iterator>" пуст ли итератор.

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

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

def toTraversable: collection.Traversable[A]

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

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

возвращает

итерируемое множество, содержащее все элементы этого итерируемого множества или итератора.

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

def toVector: scala.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

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

returns

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

Definition Classes
Iterator
Note

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

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

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

that

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

returns

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

Definition Classes
Iterator
Note

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

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

[use case]

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

that

итератор that может иметь разную длину по сравнению с исходным итератором.

thisElem

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

thatElem

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

returns

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

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

def zipWithIndex: Iterator[(A, Int)]

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

returns

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

Definition Classes
Iterator
Note

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

def →[B](y: B): (VectorIterator[A], B)

Неявный
Этот член добавляется неявным преобразованием из VectorIterator[A] в ArrowAssoc[VectorIterator[A]], выполненное методом ArrowAssoc в scala.Predef.
Definition Classes
ArrowAssoc

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

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

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

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

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

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

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

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

Неявный
Этот член добавлен неявным преобразованием из VectorIterator[A] в MonadOps[A], выполненным методом MonadOps в scala.collection.TraversableOnce.
Затенение
Этот неявный унаследованный член затенён одним или несколькими членами в этом классе.
Для доступа к этому члену можно использовать приведение типа:
(vectorIterator: 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/immutable/VectorIterator.html

Spec-Zone.ru

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