Класс scala.collection.immutable.StreamIterator
final класс StreamIterator[+A] extends AbstractIterator[A] with Iterator[A]
Конструкторы экземпляров
новый StreamIterator(self: Stream[A])
Типовые члены
класс GroupedIterator[B >: A] extends AbstractIterator[Seq[B]] with Iterator[Seq[B]]
Гибкий итератор для преобразования Iterator[A] в Iterator[Seq[A]], с настраиваемым размером последовательности, шагом и стратегией обработки элементов, которые не помещаются равномерно.
Типичные применения могут быть реализованы с помощью методов grouped и sliding.
- Определяющие классы
- Iterator
класс LazyCell extends AnyRef
Члены-значения
final def !=(arg0: Any): Boolean
Проверка двух объектов на неравенство.
- возвращает
trueесли !(this == that), иначе false.
- Определения классов
- AnyRef → Any
final def ##(): Int
Эквивалентно x.hashCode за исключением упакованных числовых типов и null. Для чисел возвращается хэш-значение, согласованное с равенством значений: если два экземпляра типа значения сравниваются как true, то ## вычислит одинаковое хэш-значение для каждого из них. Для null возвращается хэш-код, где null.hashCode вызывает NullPointerException.
- возвращает
хэш-значение, согласованное с ==
- Определения классов
- AnyRef → Any
def +(other: String): String
- Неявный
- Этот член добавляется с помощью неявного преобразования из StreamIterator[A] в any2stringadd[StreamIterator[A]] с помощью метода any2stringadd в scala.Predef.
- Определения классов
- any2stringadd
def ++(that: ⇒ Iterator[A]): Iterator[A]
Конкатенация этого итератора с другим.
- that
другой итератор
- возвращает
новый итератор, который сначала выдает значения, производимые этим итератором, а затем значения, производимые итератором
that.
- Определения классов
- Iterator
def ->[B](y: B): (StreamIterator[A], B)
- Неявный
- Этот член добавляется с помощью неявного преобразования из StreamIterator[A] в ArrowAssoc[StreamIterator[A]] с помощью метода ArrowAssoc в scala.Predef.
- Определения классов
- 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
бинарный оператор.
- возвращает
-
результат вставки
opмежду последовательными элементами этого итерируемого или перебираемого объекта слева направо с начальным значениемzслева:op(...op(op(z, x_1), x_2), ..., x_n)
где
x1, ..., xn— это элементы этого итерируемого или перебираемого объекта.
- Определения классов
- 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
бинарный оператор.
- возвращает
-
результат вставки
opмежду последовательными элементами этого итерируемого или перебираемого объекта справа налево с начальным значениемzсправа:op(x_1, op(x_2, ... op(x_n, z)...))
где
x1, ..., xn— это элементы этого итерируемого или перебираемого объекта.
- Определения классов
- 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
- Примечание
Переиспользование: После вызова этого метода следует удалить итератор, на котором он был вызван, и использовать только возвращенный итератор. Использование старого итератора неопределено, может быть изменено и может привести к изменениям в новом итераторе также.
- См. также
def clone(): AnyRef
Создайте копию объекта-приёмника.
По умолчанию реализация метода clone зависит от платформы.
- returns
копия объекта-приёмника.
def collect[B](pf: PartialFunction[A, B]): Iterator[B]
Создаёт итератор, преобразуя значения, производимые этим итератором, с помощью частичной функции, отбрасывая те значения, для которых частичная функция не определена.
- pf
частичная функция, которая фильтрует и отображает итератор.
- returns
новый итератор, который выводит каждое значение
x, производимое этим итератором, для которогоpfопределена, изображениеpf(x).
- Определяющие классы
- Iterator
- Аннотации
- @migration
- Миграция
(Изменено в версии 2.8.0)
collectизменилось. Предыдущее поведение может быть воспроизведено с помощьюtoSeq.- Примечание
Переиспользование: после вызова этого метода следует отбросить вызываемый итератор и использовать только возвращенный итератор. Использование старого итератора неопределено, может быть изменено и может привести к изменениям в новом итераторе.
def collectFirst[B](pf: PartialFunction[A, B]): Option[B]
Находит первый элемент итерируемого или итератора, для которого заданная частичная функция определена, и применяет к нему частичную функцию.
Примечание: может не завершаться для бесконечно больших коллекций.
Примечание: может возвращать разные результаты для разных запусков, если тип базовой коллекции не упорядочен.
- pf
частичная функция
- returns
значения Option, содержащие pf, применённое к первому значению, для которого оно определено, или
None, если такового нет.
- Определяющие классы
- TraversableOnce
Seq("a", 1, 5L).collectFirst({ case x: Int => x*10 }) = Some(10)
def contains(elem: Any): Boolean
Проверяет, содержит ли этот итератор заданное значение в качестве элемента.
Примечание: может не завершаться для бесконечных итераторов.
- elem
тестируемый элемент.
- returns
true, если этот итератор производит какое-либо значение, которое равно (как определено==)elem,falseв противном случае.
- Определяющие классы
- Iterator
- Примечание
Переиспользование: после вызова этого метода следует отбросить вызываемый итератор. Использовать его неопределено и может быть изменено.
def copyToArray(xs: Array[A], start: Int, len: Int): Unit
Копирует выбранные значения, производимые этим итератором, в массив. Заполняет заданный массив xs , начиная с индекса start , максимум len значениями, производимыми этим итератором. Копирование прекращается, как только достигается конец текущего итератора, или конец массива, или len элементов были скопированы.
Примечание: не будет завершаться для бесконечных итераторов.
- xs
массив для заполнения.
- start
начальный индекс.
- len
максимальное число элементов для копирования.
- Определяющие классы
- Iterator → TraversableOnce → GenTraversableOnce
def copyToArray(xs: Array[A]): Unit
Копирует элементы этого итерируемого или итератора в массив. Заполняет заданный массив xs значениями этого итерируемого или итератора. Копирование прекращается, как только достигается конец текущего итерируемого или итератора, или конец целевого массива.
Примечание: не будет завершаться для бесконечных итераторов.
- xs
массив для заполнения.
- Определяющие классы
- TraversableOnce → GenTraversableOnce
def copyToArray(xs: Array[A], start: Int): Unit
Копирует элементы этого итерируемого или итератора в массив. Заполняет заданный массив 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этого итератора иythat, в противном случае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: (StreamIterator[A]) ⇒ Boolean, msg: ⇒ Any): StreamIterator[A]
- Implicit
- Этот член добавлен неявным преобразованием из StreamIterator[A] в Ensuring[StreamIterator[A]] с помощью метода Ensuring в scala.Predef.
- Definition Classes
- Ensuring
def ensuring(cond: (StreamIterator[A]) ⇒ Boolean): StreamIterator[A]
- Implicit
- Этот член добавлен неявным преобразованием из StreamIterator[A] в Ensuring[StreamIterator[A]] с помощью метода Ensuring в scala.Predef.
- Definition Classes
- Ensuring
def ensuring(cond: Boolean, msg: ⇒ Any): StreamIterator[A]
- Implicit
- Этот член добавлен неявным преобразованием из StreamIterator[A] в Ensuring[StreamIterator[A]] с помощью метода Ensuring в scala.Predef.
- Definition Classes
- Ensuring
def ensuring(cond: Boolean): StreamIterator[A]
- Implicit
- Этот член добавлен неявным преобразованием из StreamIterator[A] в Ensuring[StreamIterator[A]] с помощью метода Ensuring в scala.Predef.
- Definition Classes
- Ensuring
final def eq(arg0: AnyRef): Boolean
Проверяет, является ли аргумент (that) ссылкой на объект-получатель (this).
Метод eq реализует отношение эквивалентности на не-null экземплярах AnyRef, и обладает тремя дополнительными свойствами:
-
Он согласован: для любых не-null экземпляров
x и y типа AnyRef, многократные вызовы x.eq(y) последовательно возвращают true или последовательно возвращают false.Для любого не-null экземпляра 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
- Note
Переиспользование: После вызова этого метода итератор, на котором он был вызван, следует считать недействительным. Использование его в дальнейшем не определено и может измениться.
def filter(p: (A) ⇒ Boolean): Iterator[A]
Возвращает итератор по всем элементам этого итератора, которые удовлетворяют предикату p. Порядок элементов сохраняется.
- p
предикат, используемый для проверки значений.
- returns
итератор, который производит те значения этого итератора, которые удовлетворяют предикату
p.
- Definition Classes
- Iterator
- Note
Переиспользование: После вызова этого метода итератор, на котором он был вызван, следует считать недействительным, и использовать только возвращённый итератор. Использование старого итератора не определено, может измениться и может привести к изменениям в новом итераторе.
def filterNot(p: (A) ⇒ Boolean): Iterator[A]
Создаёт итератор по всем элементам этого итератора, которые не удовлетворяют предикату p.
- p
предикат, используемый для проверки значений.
- returns
итератор, который производит те значения этого итератора, которые не удовлетворяют предикату
p.
- Definition Classes
- Iterator
- Note
Переиспользование: После вызова этого метода итератор, на котором он был вызван, следует считать недействительным, и использовать только возвращённый итератор. Использование старого итератора не определено, может измениться и может привести к изменениям в новом итераторе.
def finalize(): Unit
Вызывается сборщиком мусора для объекта-получателя, когда к объекту больше нет ссылок.
Подробности о том, когда и будет ли вызван метод finalize, а также взаимодействие между finalize и нелокальными возвратами и исключениями, зависят от платформы.
- Attributes
- protected[lang]
- Definition Classes
- AnyRef
- Annotations
- @throws( classOf[java.lang.Throwable] )
- Note
не указано 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
Применяет функцию f ко всем значениям, производимым этим итератором.
- f
функция, которая применяется для побочного эффекта к каждому элементу. Результат функции
fигнорируется.
- Definition Classes
- Iterator → TraversableOnce → GenTraversableOnce
def formatted(fmtstr: String): String
Возвращает строку, отформатированную согласно заданной format строке. Форматные строки аналогичны String.format (@см. java.lang.String.format).
- Неявный
- Этот член добавляется неявным преобразованием из StreamIterator[A] в StringFormat[StreamIterator[A]] с помощью метода StringFormat в scala.Predef.
- Definition Classes
- StringFormat
- Аннотации
- @inline()
final def getClass(): Class[_]
Возвращает представление класса объекта во время выполнения.
- возвращает
объект класса, соответствующий типу получателя во время выполнения.
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
- StreamIterator → Iterator
- Примечание
Переиспользование: Итератор остаётся валидным для дальнейшего использования независимо от возвращённого результата.
def hashCode(): Int
Метод hashCode для ссылочных типов. См. hashCode в scala.Any.
- возвращает
значение хэш-кода для этого объекта.
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,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
Находит максимальный элемент.
- returns
наибольший элемент этого набора или итератора.
- Definition Classes
- TraversableOnce → GenTraversableOnce
- Исключения
UnsupportedOperationExceptionесли этот набор или итератор пустой.
def maxBy[B](f: (A) ⇒ B): A
Находит первый элемент, который дает наибольшее значение, измеряемое функцией f.
- B
Тип результата функции f.
- f
Функция измерения.
- returns
первый элемент этого набора или итератора с наибольшим значением, измеренным функцией f.
- Definition Classes
- TraversableOnce → GenTraversableOnce
- Исключения
UnsupportedOperationExceptionесли этот набор или итератор пустой.
def min: A
Находит наименьший элемент.
- returns
наименьший элемент этого итерируемого объекта или итератора
- Definition Classes
- TraversableOnce → GenTraversableOnce
- Исключения
UnsupportedOperationException, если этот итерируемый объект или итератор пустой.
def minBy[B](f: (A) ⇒ B): A
Находит первый элемент, который возвращает наименьшее значение, измеренное функцией f.
- B
Тип результата функции f.
- f
Функция измерения.
- returns
первый элемент этого итерируемого объекта или итератора с наименьшим значением, измеренным функцией f.
- Definition Classes
- TraversableOnce → GenTraversableOnce
- Исключения
UnsupportedOperationExceptionесли этот итерируемый объект или итератор пустой.
def mkString: String
Отображает все элементы этого итерируемого объекта или итератора в строке.
- returns
строковое представление этого итерируемого объекта или итератора. В результирующей строке строковые представления (с использованием метода
toString) всех элементов этого итерируемого объекта или итератора следуют друг за другом без разделителя.
- Definition Classes
- TraversableOnce → GenTraversableOnce
def mkString(sep: String): String
Отображает все элементы этого итерируемого объекта или итератора в строке с использованием разделительной строки.
- sep
разделительная строка.
- returns
строковое представление этого итерируемого объекта или итератора. В результирующей строке строковые представления (с использованием метода
toString) всех элементов этого итерируемого объекта или итератора разделены строкойsep.
- Definition Classes
- TraversableOnce → GenTraversableOnce
List(1, 2, 3).mkString("|") = "1|2|3"
def mkString(start: String, sep: String, end: String): String
Отображает все элементы этого итерируемого объекта или итератора в строке с использованием начальной, конечной и разделительной строк.
- start
начальная строка.
- sep
разделительная строка.
- end
конечная строка.
- returns
строковое представление этого итерируемого объекта или итератора. Результирующая строка начинается со строки
startи заканчивается строкойend. Внутри строковые представления (с использованием методаtoString) всех элементов этого итерируемого объекта или итератора разделены строкойsep.
- Definition Classes
- TraversableOnce → GenTraversableOnce
List(1, 2, 3).mkString("(", "; ", ")") = "(1; 2; 3)"
final def ne(arg0: AnyRef): Boolean
Эквивалентно !(this eq that).
- returns
trueесли аргумент не является ссылкой на объект-получатель;falseв противном случае.
- Definition Classes
- AnyRef
def next(): A
Возвращает следующий элемент этого итератора.
- returns
следующий элемент этого итератора, если
hasNextявляетсяtrue, в противном случае - неопределенное поведение.
- Definition Classes
- StreamIterator → Iterator
- Примечание
Переиспользование: Итератор остается действительным для дальнейшего использования, независимо от возвращаемого результата.
def nonEmpty: Boolean
Проверяет, не пуст ли итерируемый объект или итератор.
- returns
trueесли итерируемый объект или итератор содержит по крайней мере один элемент,falseв противном случае.
- Definition Classes
- TraversableOnce → GenTraversableOnce
final def notify(): Unit
Разбуждает одну нить, ожидающую монитора объекта-получателя.
- Definition Classes
- AnyRef
- Annotations
- @native()
- Примечание
не указано в SLS как член AnyRef
final def notifyAll(): Unit
Разбуждает все нити, ожидающие монитора объекта-получателя.
- Definition Classes
- AnyRef
- Annotations
- @native()
- Примечание
не указано в SLS как член AnyRef
def padTo(len: Int, elem: A): Iterator[A]
Добавляет значение элемента в этот итератор до тех пор, пока не будет достигнута заданная целевая длина.
- 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
Перемножает элементы этого набора.
- 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
- Note
Переиспользование: После вызова этого метода следует удалить итератор, на котором он был вызван, и использовать только возвращённый итератор. Использование старого итератора неопределено, может измениться и может привести к изменениям в новом итераторе тоже.
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
- Note
Переиспользование: После вызова этого метода следует удалить итератор, на котором он был вызван, и использовать только возвращённый итератор. Использование старого итератора неопределено, может измениться и может привести к изменениям в новом итераторе тоже.
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
- Note
Переиспользование: После вызова этого метода следует удалить итератор, на котором он был вызван, и использовать только возвращённый итератор. Использование старого итератора неопределено, может измениться и может привести к изменениям в новом итераторе тоже.
def span(p: (A) ⇒ Boolean): (Iterator[A], Iterator[A])
Разделяет этот итератор на пару префикс/суффикс в соответствии с предикатом.
- p
предикат проверки
- returns
пара итераторов, состоящая из самого длинного префикса этого итератора, чьи элементы все удовлетворяют
p, и остальной части итератора.
- Definition Classes
- Iterator
- Note
Переиспользование: После вызова этого метода следует удалить итератор, на котором он был вызван, и использовать только возвращённые итераторы. Использование старого итератора неопределено, может измениться и может привести к изменениям в новых итераторах тоже.
def sum: A
Суммирует элементы этой коллекции.
- 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
- Note
Переиспользование: После вызова этого метода, необходимо удалить вызываемый итератор и использовать только возвращённый итератор. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новом итераторе также.
def takeWhile(p: (A) ⇒ Boolean): Iterator[A]
Берет самое длинное префиксное значение, производимое этим итератором, которое удовлетворяет предикату.
- p
Предикат, используемый для проверки элементов.
- returns
Итератор, возвращающий значения, производимые этим итератором, пока этот итератор не произведёт значение, которое не удовлетворяет предикату
p.
- Definition Classes
- Iterator
- Note
Переиспользование: После вызова этого метода, необходимо удалить вызываемый итератор и использовать только возвращённый итератор. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новом итераторе также.
def to[Col[_]]: Col[A]
Преобразует этот итерируемый объект или итератор в другой, копируя все элементы.
Примечание: не будет завершаться для бесконечных итераторов.
- Col
Тип коллекции для построения.
- returns
новая коллекция, содержащая все элементы этого итерируемого объекта или итератора.
- Definition Classes
- TraversableOnce → GenTraversableOnce
def toArray: Array[A]
Преобразует этот итерируемый объект или итератор в массив.
Примечание: не будет завершаться для бесконечных итераторов.
- 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]
Преобразует этот обход или итератор в список.
Примечание: не завершит работу для бесконечных итераторов.
- returns
список, содержащий все элементы этого обхода или итератора.
- Definition Classes
- StreamIterator → TraversableOnce → GenTraversableOnce
def toMap[T, U]: collection.Map[T, U]
Преобразует этот обход или итератор в карту. Этот метод недоступен, если элементы не являются членами Tuple2, каждый ((T, U)) становится парой ключ-значение в карте. Повторяющиеся ключи будут перезаписаны более поздними ключами: если это неупорядоченная коллекция, какой ключ находится в результирующей карте, не определено.
Примечание: не завершит работу для бесконечных итераторов.
- returns
карта типа
immutable.Map[T, U]содержащая все пары ключ/значение типа(T, U)этого обхода или итератора.
- Definition Classes
- TraversableOnce → GenTraversableOnce
def toSeq: collection.Seq[A]
Преобразует этот обход или итератор в последовательность. Как и в toIterable, в этом стандартном варианте она ленивая, так как этот TraversableOnce может быть ленивым и неоценочным.
Примечание: не завершит работу для бесконечно больших коллекций.
- returns
последовательность, содержащая все элементы этого обхода или итератора.
- Definition Classes
- TraversableOnce → GenTraversableOnce
def toSet[B >: A]: Set[B]
Преобразует этот обход или итератор в множество.
Примечание: не завершит работу для бесконечно больших коллекций.
- returns
множество, содержащее все элементы этого обхода или итератора.
- Definition Classes
- TraversableOnce → GenTraversableOnce
def toStream: Stream[A]
Преобразует этот обход или итератор в поток.
- returns
поток, содержащий все элементы этого обхода или итератора.
- Definition Classes
- StreamIterator → Iterator → GenTraversableOnce
def toString(): String
Преобразует этот итератор в строку.
- returns
"<iterator>"пуст ли итератор или нет.
def toTraversable: collection.Traversable[A]
Преобразует этот обход или итератор в неопределённый обход. Вернёт ту же коллекцию, если этот экземпляр уже является обходом.
Примечание: не завершит работу для бесконечных итераторов.
- returns
обход, содержащий все элементы этого обхода или итератора.
- Definition Classes
- Iterator → TraversableOnce → GenTraversableOnce
def toVector: scala.Vector[A]
Преобразует этот обход или итератор в вектор.
Примечание: не завершит работу для бесконечно больших коллекций.
- returns
вектор, содержащий все элементы этого обхода или итератора.
- Definition Classes
- TraversableOnce → GenTraversableOnce
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
def withFilter(p: (A) ⇒ Boolean): Iterator[A]
Создаёт итератор, содержащий только те элементы из этого итератора, которые удовлетворяют предикату p. Порядок элементов сохраняется.
Примечание: withFilter эквивалентно filter для итераторов. Оно существует, чтобы выражения for с фильтрацией работали с итераторами.
- p
предикат, используемый для проверки значений.
- returns
итератор, который генерирует те значения из этого итератора, которые удовлетворяют предикату
p.
- Definition Classes
- Iterator
- Примечание
Переиспользование: После вызова этого метода, следует удалить итератор, на котором был вызван метод, и использовать только возвращённый итератор. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новом итераторе.
def zip[B](that: Iterator[B]): Iterator[(A, B)]
Создаёт итератор, образованный из этого и другого итератора, комбинируя соответствующие значения в пары. Если один из двух итераторов длиннее другого, его оставшиеся элементы игнорируются.
- that
Итератор, предоставляющий вторую половину каждой пары результата
- returns
новый итератор, содержащий пары, состоящие из соответствующих элементов этого итератора и
that. Количество элементов, возвращаемых новым итератором, равно минимуму из количества элементов, возвращаемых этим итератором иthat.
- Definition Classes
- Iterator
- Примечание
Переиспользование: После вызова этого метода, следует удалить итератор, на котором был вызван метод, а также переданный в качестве параметра итератор, и использовать только возвращённый итератор. Использование старых итераторов не определено, может быть изменено и может привести к изменениям в новом итераторе.
def zipAll[B](that: Iterator[B], thisElem: A, thatElem: B): Iterator[(A, B)]
Создаёт итератор, образованный из этого и другого итератора, комбинируя соответствующие элементы в пары. Если один из двух итераторов короче другого, используются заполнители для расширения более короткого итератора до длины более длинного.
- 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
- Примечание
Переиспользование: После вызова этого метода, следует удалить итератор, на котором был вызван метод, и использовать только возвращённый итератор. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новом итераторе.
def →[B](y: B): (StreamIterator[A], B)
- Неявный
- Этот член добавляется неявным преобразованием из StreamIterator[A] в ArrowAssoc[StreamIterator[A]] при помощи метода ArrowAssoc в scala.Predef.
- Definition Classes
- ArrowAssoc
Члены-значения с затемненным неявным значением
def filter(p: (A) ⇒ Boolean): TraversableOnce[A]
- Неявный
- Этот член добавлен с помощью неявного преобразования из StreamIterator[A] в MonadOps[A] при выполнении метода MonadOps в scala.collection.TraversableOnce.
- Затемнение
- Этот неявный унаследованный член затемняется одним или несколькими членами в этом классе.
Для доступа к этому члену можно использовать привязку типа:(streamIterator: MonadOps[A]).filter(p)
- Классы определений
- MonadOps
def flatMap[B](f: (A) ⇒ GenTraversableOnce[B]): TraversableOnce[B]
- Неявный
- Этот член добавлен с помощью неявного преобразования из StreamIterator[A] в MonadOps[A] при выполнении метода MonadOps в scala.collection.TraversableOnce.
- Затемнение
- Этот неявный унаследованный член затемняется одним или несколькими членами в этом классе.
Для доступа к этому члену можно использовать привязку типа:(streamIterator: MonadOps[A]).flatMap(f)
- Классы определений
- MonadOps
def map[B](f: (A) ⇒ B): TraversableOnce[B]
- Неявный
- Этот член добавлен с помощью неявного преобразования из StreamIterator[A] в MonadOps[A] при выполнении метода MonadOps в scala.collection.TraversableOnce.
- Затемнение
- Этот неявный унаследованный член затемняется одним или несколькими членами в этом классе.
Для доступа к этому члену можно использовать привязку типа:(streamIterator: MonadOps[A]).map(f)
- Классы определений
- MonadOps
def withFilter(p: (A) ⇒ Boolean): Iterator[A]
- Неявный
- Этот член добавлен с помощью неявного преобразования из StreamIterator[A] в MonadOps[A] при выполнении метода MonadOps в scala.collection.TraversableOnce.
- Затемнение
- Этот неявный унаследованный член затемняется одним или несколькими членами в этом классе.
Для доступа к этому члену можно использовать привязку типа:(streamIterator: 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/StreamIterator.html
Специализированная, чрезвычайно ленивая реализация итератора потока, позволяющая итерировать настолько лениво, насколько это требуется при прохождении хвоста.