Объект scala.collection.Iterator
Компаньон трейт Iterator
объект 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
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
копия объекта-получателя.
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
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
объект класса, соответствующий типу времени выполнения получателя.
def hashCode(): Int
Метод hashCode для ссылочных типов. См. hashCode в scala.Any.
- returns
значение хэш-кода для этого объекта.
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
© 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
Объект
Iteratorпредоставляет различные функции для создания специализированных итераторов.2.8