Spec-Zone.ru › Scala 2.12 Library

Объект scala.collection.Iterator

Компаньон трейт Iterator

объект Iterator

Объект Iterator предоставляет различные функции для создания специализированных итераторов.

Источник
Iterator.scala
С момента

2.8

Линейные надтипы

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

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

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

implicit def IteratorCanBuildFrom[A]: BufferedCanBuildFrom[A, Iterator]

С появлением TraversableOnce и Iterator, может быть полезно иметь билдер, работающий с Iterator для того, чтобы их можно было обрабатывать единообразно вместе с коллекциями. Смотрите scala.util.Random.shuffle для примера.

def apply[A](elems: A*): Iterator[A]

Создаёт итератор с заданными элементами.

elems

Элементы, возвращаемые по одному от итератора

returns

Итератор, который генерирует заданные элементы при первых вызовах next, и в котором нет других элементов.

final def asInstanceOf[T0]: T0

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

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

returns

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

Definition Classes
Any
Исключения

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

def clone(): AnyRef

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

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

returns

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

Атрибуты
protected[lang]
Definition Classes
AnyRef
Аннотации
@throws( ... ) @native()
Примечание

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

def continually[A](elem: ⇒ A): Iterator[A]

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

elem

вычисление элемента.

returns

итератор, содержащий бесконечное число результатов вычисления elem.

val empty: Iterator[Nothing]

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 fill[A](len: Int)(elem: ⇒ A): Iterator[A]

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

len

количество элементов, возвращаемых итератором.

elem

вычисление элемента

returns

Итератор, который генерирует результаты n вычислений elem.

def finalize(): Unit

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

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

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

не специфицировано SLS как член AnyRef

def from(start: Int, step: Int): Iterator[Int]

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

start

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

step

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

returns

итератор, генерирующий бесконечную последовательность значений start, start + 1 * step, start + 2 * step, ...

def from(start: Int): Iterator[Int]

Создаёт бесконечный итератор, который возвращает последовательные значения от некоторого начального значения.

start

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

returns

итератор, генерирующий бесконечную последовательность значений start, start + 1, start + 2, ...

final def getClass(): Class[_]

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

returns

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

Definition Classes
AnyRef → Any
Annotations
@native()

def hashCode(): Int

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

returns

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

Definition Classes
AnyRef → Any
Annotations
@native()

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 iterate[T](start: T)(f: (T) ⇒ T): Iterator[T]

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

start

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

f

функция, которая многократно применяется

returns

итератор, генерирующий бесконечную последовательность значений start, f(start), f(f(start)), ...

final def ne(arg0: AnyRef): Boolean

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

returns

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

Definition Classes
AnyRef

final def notify(): Unit

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

Definition Classes
AnyRef
Annotations
@native()
Note

не специфицировано SLS как член AnyRef

final def notifyAll(): Unit

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

Definition Classes
AnyRef
Annotations
@native()
Note

не специфицировано SLS как член AnyRef

def range(start: Int, end: Int, step: Int): Iterator[Int]

Итератор, генерирующий значения с равными интервалами в некотором целочисленном интервале.

start

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

end

конечное значение итератора (первое значение, НЕ возвращаемое)

step

значение приращения итератора (должно быть положительным или отрицательным)

returns

итератор, генерирующий значения start, start + step, ... до, но не включая end

def range(start: Int, end: Int): Iterator[Int]

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

start

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

end

конечное значение итератора (первое значение, НЕ возвращаемое)

returns

итератор, генерирующий значения start, start + 1, ..., end - 1

def single[A](elem: A): Iterator[A]

Создаёт итератор, который генерирует одно единственное значение. Примечание: Эквивалентен, но более эффективен, чем Iterator(elem)

elem

значение

returns

Итератор, который генерирует elem при первом вызове next, и у которого нет других элементов.

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

Definition Classes
AnyRef

def tabulate[A](end: Int)(f: (Int) ⇒ A): Iterator[A]

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

end

Количество элементов, возвращаемых итератором

f

Функция вычисления значений элементов

returns

Итератор, который генерирует значения f(0), ..., f(n -1).

def toString(): String

Создаёт строковое представление этого объекта. По умолчанию представление зависит от платформы. На платформе Java это конкатенация имени класса, «@» и хэш-кода объекта в шестнадцатеричном формате.

returns

строковое представление объекта.

Definition Classes
AnyRef → Any

final def wait(): Unit

Definition Classes
AnyRef
Annotations
@throws( ... )

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

Definition Classes
AnyRef
Annotations
@throws( ... )

final def wait(arg0: Long): Unit

Definition Classes
AnyRef
Annotations
@throws( ... ) @native()

© 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/Iterator$.html

Spec-Zone.ru

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