Spec-Zone.ru › Scala 3.2

Итератор объектов.Iterator

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

объект Iterator расширяет IterableFactory[Iterator]

Супертипы
тракт IterableFactory[Iterator]
тракт Serializable
класс Object
тракт Matchable
класс Any
Тип «self»
Iterator.type

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

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

Создаёт коллекцию со списком указанных элементов.

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

тип элементов создаваемой коллекции

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

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

Возвращает

новую коллекцию с элементами elems

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

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

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

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

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

Возвращает

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

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

Итератор, не производящий значений.

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

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

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

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

len

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

Возвращает

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

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

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

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

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

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

Параметры значения
исходник

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

Возвращает

новую коллекцию с элементами 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

Наследуемые методы

Исходный код
def concat[A](xss: Iterable[A]*): CC[A]

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

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

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

Возвращает

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

Наследуется из IterableFactory

Исходный код
def fill[A](n1: Int, n2: Int, n3: Int, n4: Int, n5: Int)(elem: => A): CC[CC[CC[CC[CC[A]]]]]

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

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

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

n1

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

n2

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

n3

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

n4

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

n5

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

Возвращает

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

Наследуется из IterableFactory

Исходный код
def fill[A](n1: Int, n2: Int, n3: Int, n4: Int)(elem: => A): CC[CC[CC[CC[A]]]]

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

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

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

n1

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

n2

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

n3

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

n4

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

Возвращает

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

Наследуется из IterableFactory

Исходный код
def fill[A](n1: Int, n2: Int, n3: Int)(elem: => A): CC[CC[CC[A]]]

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

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

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

n1

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

n2

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

n3

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

Возвращает

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

Наследуется из IterableFactory

Исходный код
def fill[A](n1: Int, n2: Int)(elem: => A): CC[CC[A]]

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

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

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

n1

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

n2

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

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

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

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

Источник
def iterate[A](start: A, len: Int)(f: A => A): CC[A]

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

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

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

len

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

start

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

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

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

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

Источник
def range[A : Integral](start: A, end: A, step: A): CC[A]

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

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

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

start

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

step

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

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

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

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

Источник
def range[A : Integral](start: A, end: A): CC[A]

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

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

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

start

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

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

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

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

Источник
def tabulate[A](n1: Int, n2: Int, n3: Int, n4: Int, n5: Int)(f: (Int, Int, Int, Int, Int) => A): CC[CC[CC[CC[CC[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

Источник
def tabulate[A](n1: Int, n2: Int, n3: Int, n4: Int)(f: (Int, Int, Int, Int) => A): CC[CC[CC[CC[A]]]]

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

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

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

n1

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

n2

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

n3

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

n4

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

Возвращает

Коллекция, состоящая из элементов 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): CC[CC[CC[A]]]

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

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

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

n1

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

n2

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

n3

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

Возвращает

Коллекция, состоящая из элементов 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): CC[CC[A]]

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

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

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

n1

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

n2

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

Возвращает

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

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

Унаследованные неявные имплициты

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

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

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

Spec-Zone.ru

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