Spec-Zone.ru › Scala 3.1

Объект scala.collection.Iterator

Класс-компаньон • Исходный код

@SerialVersionUID(3L)
объект Iterator extends IterableFactory[Iterator]

Супертипы
Тракт IterableFactory[Iterator]
Тракт Serializable
Класс Object
Тракт Matchable
Класс Any
Тип самого себя
Iterator.type

Конкретные методы

Исходный код
override def apply[A](xs: A*): Iterator[A]

Классы определений IterableFactory

Исходный код
def continually[A](elem: => A): Iterator[A]

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

Параметры значений
elem

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

Возвращаемое значение

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

Исходный код@inline
final def empty[T]: Iterator[T]

Итератор, который не производит никаких значений.

Исходный код
override def fill[A](len: Int)(elem: => A): Iterator[A]

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

Параметры значений
elem

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

len

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

Возвращаемое значение

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

Классы определений IterableFactory

Исходный код
override def from[A](source: IterableOnce[A]): Iterator[A]

Создаёт целевую коллекцию из существующей исходной коллекции

Параметры типов
A

тип элементов коллекции

Параметры значений
source

Исходная коллекция

Возвращаемое значение

новая коллекция с элементами source.

Классы определений IterableFactory

Исходный код
def from(start: Int): Iterator[Int]

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

Параметры значений
start

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

Возвращаемое значение

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

Исходный код
def from(start: Int, step: Int): Iterator[Int]

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

Параметры значения
start

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

step

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

Возвращает

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

Исходный код
def iterate[T](start: T)(f: T => T): Iterator[T]

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

Параметры значения
f

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

start

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

Возвращает

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

Исходный код
def newBuilder[A]: Builder[A, Iterator[A]]

Параметры типа
A

тип элементов коллекции

Возвращает

строитель для объектов Iterable.

Исходный код
def range(start: Int, end: Int): Iterator[Int]

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

Параметры значения
end

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

start

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

Возвращает

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

Исходный код
def range(start: Int, end: Int, step: Int): Iterator[Int]

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

Параметры значения
end

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

start

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

step

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

Возвращает

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

Исходный код
def single[A](a: A): Iterator[A]

Исходный код
override def tabulate[A](end: Int)(f: Int => A): Iterator[A]

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

Параметры значения
end

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

f

функция, вычисляющая значения элементов

Возвращает

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

Классы определений IterableFactory

Исходный код
override def unfold[A, S](init: S)(f: S => Option[(A, S)]): Iterator[A]

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

Параметры типа
A

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

S

Тип внутреннего состояния

Параметры значения
f

вычисляет следующий элемент (или возвращает None, чтобы сигнализировать об окончании коллекции)

init

начальное значение состояния

Возвращает

итератор, генерирующий элементы с помощью f, пока f не вернёт None

Классы определений IterableFactory

Наследованные методы

Source
def concat[A](xss: Iterable[A]*): Iterator[A]

Объединяет все аргументные коллекции в одну коллекцию.

Параметры значения
xss

коллекции, которые должны быть объединены.

Возвращает

объединение всех коллекций.

Унаследовано от IterableFactory

Source
def fill[A](n1: Int, n2: Int, n3: Int, n4: Int, n5: Int)(elem: => A): Iterator[Iterator[Iterator[Iterator[Iterator[A]]]]]

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

Параметры значения
elem

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

n1

число элементов в первом измерении

n2

число элементов во втором измерении

n3

число элементов в третьем измерении

n4

число элементов в четвёртом измерении

n5

число элементов в пятом измерении

Возвращает

Коллекция, содержащая результаты n1 x n2 x n3 x n4 x n5 вычислений elem.

Унаследовано от IterableFactory

Source
def fill[A](n1: Int, n2: Int, n3: Int, n4: Int)(elem: => A): Iterator[Iterator[Iterator[Iterator[A]]]]

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

Параметры значения
elem

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

n1

число элементов в первом измерении

n2

число элементов во втором измерении

n3

число элементов в третьем измерении

n4

число элементов в четвёртом измерении

Возвращает

Коллекция, содержащая результаты n1 x n2 x n3 x n4 вычислений elem.

Унаследовано от IterableFactory

Source
def fill[A](n1: Int, n2: Int, n3: Int)(elem: => A): Iterator[Iterator[Iterator[A]]]

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

Параметры значения
elem

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

n1

число элементов в первом измерении

n2

число элементов во втором измерении

n3

число элементов в третьем измерении

Возвращает

Коллекция, содержащая результаты n1 x n2 x n3 вычислений elem.

Унаследовано от IterableFactory

Source
def fill[A](n1: Int, n2: Int)(elem: => A): Iterator[Iterator[A]]

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

Параметры значения
elem

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

n1

число элементов в первом измерении

n2

число элементов во втором измерении

Возвращает

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

Унаследовано от IterableFactory

Source
def iterate[A](start: A, len: Int)(f: A => A): Iterator[A]

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

Параметры значения
f

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

len

количество элементов, содержащихся в коллекции

start

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

Возвращает

коллекция со значениями len в последовательности start, f(start), f(f(start)), ...

Унаследовано от IterableFactory

Source
def range[A : Integral](start: A, end: A, step: A): Iterator[A]

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

Параметры значения
end

конечное значение коллекции (первое значение, *не* содержащееся)

start

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

step

разность между последовательными элементами коллекции (должна быть положительной или отрицательной)

Возвращает

коллекция со значениями start, start + step, ... до, но не включая end

Унаследовано от IterableFactory

Source
def range[A : Integral](start: A, end: A): Iterator[A]

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

Параметры значения
end

конечное значение коллекции (первое значение, *не* содержащееся)

start

первый элемент коллекции

Возвращает

коллекция со значениями start, start + 1, ..., end - 1

Унаследовано от IterableFactory

Source
def tabulate[A](n1: Int, n2: Int, n3: Int, n4: Int, n5: Int)(f: (Int, Int, Int, Int, Int) => A): Iterator[Iterator[Iterator[Iterator[Iterator[A]]]]]

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

Параметры значения
f

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

n1

число элементов в первом измерении

n2

число элементов во втором измерении

n3

число элементов в третьем измерении

n4

число элементов в четвёртом измерении

n5

число элементов в пятом измерении

Возвращает

Коллекция, состоящая из элементов f(i1, i2, i3, i4, i5) для 0 <= i1 < n1, 0 <= i2 < n2, 0 <= i3 < n3, 0 <= i4 < n4, и 0 <= i5 < n5.

Унаследовано от IterableFactory

Source
def tabulate[A](n1: Int, n2: Int, n3: Int, n4: Int)(f: (Int, Int, Int, Int) => A): Iterator[Iterator[Iterator[Iterator[A]]]]

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

Параметры значения
f

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

n1

количество элементов в первом измерении

n2

количество элементов во втором измерении

n3

количество элементов в третьем измерении

n4

количество элементов в четвёртом измерении

Возвращает

Коллекция, состоящая из элементов f(i1, i2, i3, i4) для 0 <= i1 < n1, 0 <= i2 < n2, 0 <= i3 < n3, и 0 <= i4 < n4.

Унаследовано от IterableFactory

Исходный код
def tabulate[A](n1: Int, n2: Int, n3: Int)(f: (Int, Int, Int) => A): Iterator[Iterator[Iterator[A]]]

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

Параметры значения
f

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

n1

количество элементов в первом измерении

n2

количество элементов во втором измерении

n3

количество элементов в третьем измерении

Возвращает

Коллекция, состоящая из элементов f(i1, i2, i3) для 0 <= i1 < n1, 0 <= i2 < n2, и 0 <= i3 < n3.

Унаследовано от IterableFactory

Исходный код
def tabulate[A](n1: Int, n2: Int)(f: (Int, Int) => A): Iterator[Iterator[A]]

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

Параметры значения
f

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

n1

количество элементов в первом измерении

n2

количество элементов во втором измерении

Возвращает

Коллекция, состоящая из элементов f(i1, i2) для 0 <= i1 < n1 и 0 <= i2 < n2.

Унаследовано от IterableFactory

Унаследованные неявные значения

Исходный код
implicit def iterableFactory[A]: Factory[A, Iterator[A]]

Унаследовано от IterableFactory

© 2002-2022 EPFL, with contributions from Lightbend.
Licensed under the Apache License, Version 2.0.
https://scala-lang.org/api/3.1.1/scala/collection/Iterator$.html

Spec-Zone.ru

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