Spec-Zone.ru › Scala 2.12 Library

Класс scala.io.Source.LineIterator

класс LineIterator extends AbstractIterator[String] with Iterator[String]

Источник
Source.scala
Линейные супертипы

Конструкторы экземпляров

новый LineIterator()

Типовые члены

класс GroupedIterator[B >: A] extends AbstractIterator[Seq[B]] with Iterator[Seq[B]]

Гибкий итератор для преобразования Iterator[A] в Iterator[Seq[A]], с настраиваемым размером последовательности, шагом и стратегией обработки элементов, которые не укладываются ровно.

Типичные применения можно достичь с помощью методов grouped и sliding.

Определяющие классы
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

def +(other: String): String

Неявный
Этот член добавляется с помощью неявного преобразования из LineIterator в any2stringadd[LineIterator] с помощью метода any2stringadd в scala.Predef.
Definition Classes
any2stringadd

def ++(that: ⇒ collection.Iterator[String]): collection.Iterator[String]

[пример использования]

Конкатенация этого итератора с другим.

that

другой итератор

returns

новый итератор, который сначала возвращает значения, производимые этим итератором, а затем — значения, производимые итератором that.

Definition Classes
Iterator
Полная сигнатура

def ->[B](y: B): (LineIterator, B)

Неявный
Этот член добавляется с помощью неявного преобразования из LineIterator в ArrowAssoc[LineIterator] с помощью метода ArrowAssoc в scala.Predef.
Definition Classes
ArrowAssoc
Аннотации
@inline()

def /:[B](z: B)(op: (B, String) ⇒ 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

бинарный оператор.

returns

результат вставки op между последовательными элементами этого перебираемого или итератора слева направо с начальным значением z слева:

op(...op(op(z, x_1), x_2), ..., x_n)

где x1, ..., xn — это элементы этого перебираемого или итератора.

Definition Classes
TraversableOnce → GenTraversableOnce

def :\[B](z: B)(op: (String, 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

бинарный оператор

returns

результат вставки op между последовательными элементами этого перебираемого или итератора справа налево с начальным значением z справа:

op(x_1, op(x_2, ... op(x_n, z)...))

где x1, ..., xn — это элементы этого перебираемого или итератора.

Definition Classes
TraversableOnce → GenTraversableOnce

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

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

строковый буфер, в который добавляются элементы.

returns

строковый буфер b, в который были добавлены элементы.

Definition Classes
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

строка-разделитель.

returns

строковый буфер b, в который были добавлены элементы.

Definition Classes
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

конечная строка.

returns

строковый буфер b, в который были добавлены элементы.

Definition Classes
TraversableOnce

def aggregate[B](z: ⇒ B)(seqop: (B, String) ⇒ 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

ассоциативный оператор, используемый для объединения результатов из разных частей

Definition Classes
TraversableOnce → GenTraversableOnce

final def asInstanceOf[T0]: T0

Преобразует получаемый объект к типу T0.

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

returns

получаемый объект.

Definition Classes
Any
Exceptions thrown

ClassCastException, если получаемый объект не является экземпляром стирания типа T0.

def buffered: collection.BufferedIterator[String]

Создает буферизованный итератор из этого итератора.

returns

буферизованный итератор, производящий те же значения, что и этот итератор.

Definition Classes
Iterator
Note

Переиспользование: после вызова этого метода, следует отбросить вызываемый на нем итератор, и использовать только возвращенный итератор. Использование старого итератора является неопределенным, может быть изменено, и может привести к изменениям в новом итераторе.

See also

scala.collection.BufferedIterator

def clone(): AnyRef

Создайте копию объекта-приёмника.

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

возвращает

копию объекта-приёмника.

Атрибуты
protected[lang]
Определяющие классы
AnyRef
Аннотации
@throws( ... ) @native()
Примечание

не определён SLS как член AnyRef

def collect[B](pf: PartialFunction[String, B]): collection.Iterator[B]

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

pf

частичная функция, которая фильтрует и отображает итератор.

возвращает

новый итератор, который возвращает каждое значение x , производимое этим итератором, для которого pf определена, изображение pf(x).

Определяющие классы
Iterator
Аннотации
@migration
Миграция

(Изменено в версии 2.8.0) collect изменилось. Предыдущее поведение можно воспроизвести с помощью toSeq.

Примечание

Повторное использование: После вызова этого метода следует удалить итератор, на котором он был вызван, и использовать только итератор, который был возвращен. Использование старого итератора не определено, может измениться, и может привести к изменениям в новом итераторе.

def collectFirst[B](pf: PartialFunction[String, B]): Option[B]

Находит первый элемент traversable или итератора, для которого заданная частичная функция определена, и применяет частичную функцию к нему.

Примечание: может не завершаться для коллекций бесконечного размера.

Примечание: может возвращать разные результаты для разных запусков, если тип базовой коллекции не упорядочен.

pf

частичная функция

возвращает

значение типа Option, содержащее результат применения pf к первому значению, для которого она определена, или None , если такого значения не существует.

Определяющие классы
TraversableOnce
Пример:

    Seq("a", 1, 5L).collectFirst({ case x: Int => x*10 }) = Some(10)

def contains(elem: Any): Boolean

Проверяет, содержит ли этот итератор заданное значение в качестве элемента.

Примечание: может не завершаться для бесконечных итераторов.

elem

тестируемый элемент.

возвращает

true , если этот итератор производит некоторое значение, которое равно (как определено ==) elem, false в противном случае.

Определяющие классы
Iterator
Примечание

Повторное использование: После вызова этого метода следует удалить итератор, на котором он был вызван. Использование его не определено и может измениться.

def copyToArray(xs: Array[String], start: Int, len: Int): Unit

[use case]

Копирует выбранные значения, производимые этим итератором, в массив. Заполняет заданный массив xs , начиная с индекса start , не более чем len значениями, производимыми этим итератором. Копирование остановится, как только будет достигнут конец текущего итератора, или конец массива, или len элементов были скопированы.

Примечание: не завершится для бесконечных итераторов.

xs

массив для заполнения.

start

начальный индекс.

len

максимальное количество элементов для копирования.

Определяющие классы
Iterator → TraversableOnce → GenTraversableOnce
Полная подпись

def copyToArray(xs: Array[A]): Unit

[use case]

Копирует элементы этого traversable или итератора в массив. Заполняет заданный массив xs значениями этого traversable или итератора. Копирование остановится, как только будет достигнут конец текущего traversable или итератора, или конец целевого массива.

Примечание: не завершится для бесконечных итераторов.

xs

массив для заполнения.

Определяющие классы
TraversableOnce → GenTraversableOnce
Полная подпись

def copyToArray(xs: Array[A], start: Int): Unit

[use case]

Копирует элементы этого traversable или итератора в массив. Заполняет заданный массив xs значениями этого traversable или итератора, начиная с индекса start. Копирование остановится, как только будет достигнут конец текущего traversable или итератора, или конец целевого массива.

Примечание: не завершится для бесконечных итераторов.

xs

массив для заполнения.

start

начальный индекс.

Определяющие классы
TraversableOnce → GenTraversableOnce
Полная подпись

def copyToBuffer[B >: String](dest: Buffer[B]): Unit

Копирует все элементы этого итерируемого объекта или итератора в буфер.

Примечание: не завершается для коллекций бесконечного размера.

dest

Буфер, в который копируются элементы.

Definition Classes
TraversableOnce

def corresponds[B](that: GenTraversableOnce[B])(p: (String, B) ⇒ Boolean): Boolean

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

B

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

that

другая коллекция

p

предикат проверки, который связывает элементы из обеих коллекций

returns

true если обе коллекции имеют одинаковую длину и p(x, y) равно true для всех соответствующих элементов x этого итератора и y из that, в противном случае false

Definition Classes
Iterator

def count(p: (String) ⇒ Boolean): Int

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

p

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

returns

количество элементов, удовлетворяющих предикату p.

Definition Classes
TraversableOnce → GenTraversableOnce

def drop(n: Int): collection.Iterator[String]

Передвигает этот итератор мимо первых n элементов или длины итератора, что меньше.

n

количество элементов для пропуска

returns

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

Definition Classes
Iterator
Note

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

def dropWhile(p: (String) ⇒ Boolean): collection.Iterator[String]

Пропускает самую длинную последовательность элементов этого итератора, удовлетворяющих заданному предикату p, и возвращает итератор оставшихся элементов.

p

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

returns

итератор, состоящий из оставшихся элементов

Definition Classes
Iterator
Note

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

def duplicate: (collection.Iterator[String], collection.Iterator[String])

Создаёт два новых итератора, которые оба итерируются по тем же элементам, что и этот итератор (в том же порядке). Дублированные итераторы считаются равными, если они находятся на одном элементе.

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

returns

пара итераторов

Definition Classes
Iterator
Note

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

,

Переиспользование: После вызова этого метода следует отбросить итератор, на котором он был вызван, и использовать только возвращённые итераторы. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новых итераторах.

def ensuring(cond: (LineIterator) ⇒ Boolean, msg: ⇒ Any): LineIterator

Implicit
Этот член добавлен неявным преобразованием из LineIterator в Ensuring[LineIterator] через метод Ensuring в scala.Predef.
Definition Classes
Ensuring

def ensuring(cond: (LineIterator) ⇒ Boolean): LineIterator

Implicit
Этот член добавлен неявным преобразованием из LineIterator в Ensuring[LineIterator] через метод Ensuring в scala.Predef.
Definition Classes
Ensuring

def ensuring(cond: Boolean, msg: ⇒ Any): LineIterator

Неявный
Этот член добавлен неявным преобразованием из LineIterator в Ensuring[LineIterator] с помощью метода Ensuring в scala.Predef.
Классы определения
Ensuring

def ensuring(cond: Boolean): LineIterator

Неявный
Этот член добавлен неявным преобразованием из LineIterator в Ensuring[LineIterator] с помощью метода Ensuring в scala.Predef.
Классы определения
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).

возвращает

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

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

def equals(arg0: Any): Boolean

Метод равенства для ссылочных типов. По умолчанию делегирует вызов методу eq.

См. также equals в scala.Any.

возвращает

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

Классы определения
AnyRef → Any

def exists(p: (String) ⇒ Boolean): Boolean

Проверяет, выполняется ли предикат для некоторых значений, производимых этим итератором.

Примечание: может не завершиться для бесконечных итераторов.

p

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

возвращает

true если данный предикат p выполняется для некоторых значений, производимых этим итератором, в противном случае false.

Классы определения
Iterator → TraversableOnce → GenTraversableOnce
Примечание

Повторное использование: После вызова этого метода необходимо удалить итератор, на котором он был вызван. Использование его является неопределенным и может быть изменено.

def filter(p: (String) ⇒ Boolean): collection.Iterator[String]

Возвращает итератор по всем элементам этого итератора, удовлетворяющим предикату p. Порядок элементов сохраняется.

p

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

возвращает

итератор, который производит те значения этого итератора, которые удовлетворяют предикату p.

Классы определения
Iterator
Примечание

Повторное использование: после вызова этого метода следует удалить вызываемый итератор и использовать только возвращенный. Использование старого итератора неопределено, может быть изменено и может привести к изменениям в новом итераторе.

def filterNot(p: (String) ⇒ Boolean): collection.Iterator[String]

Создает итератор по всем элементам этого итератора, которые не удовлетворяют предикату p.

p

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

возвращает

итератор, который производит те значения этого итератора, которые не удовлетворяют предикату p.

Классы определения
Iterator
Примечание

Повторное использование: после вызова этого метода следует удалить вызываемый итератор и использовать только возвращенный. Использование старого итератора неопределено, может быть изменено и может привести к изменениям в новом итераторе.

def finalize(): Unit

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

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

Атрибуты
protected[lang]
Классы определения
AnyRef
Аннотации
@throws( classOf[java.lang.Throwable] )
Примечание

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

def find(p: (String) ⇒ Boolean): Option[String]

Находит первое значение, производимое итератором, удовлетворяющее предикату, если таковое имеется.

Примечание: может не завершиться для бесконечных итераторов.

p

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

returns

значение типа Option, содержащее первое значение, производимое итератором, которое удовлетворяет предикату p, или None, если таковое не существует.

Definition Classes
Iterator → TraversableOnce → GenTraversableOnce
Note

Переиспользование: после вызова этого метода итератор, на котором он был вызван, следует отбросить. Использование его не определено и может измениться.

def flatMap[B](f: (String) ⇒ GenTraversableOnce[B]): collection.Iterator[B]

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

f

функция, применяемая к каждому элементу.

returns

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

Definition Classes
Iterator
Note

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

def fold[A1 >: String](z: A1)(op: (A1, A1) ⇒ A1): A1

Складывает элементы этого перебираемого объекта или итератора с использованием заданного ассоциативного бинарного оператора.

Порядок выполнения операций над элементами не определён и может быть не детерминированным.

Примечание: не завершится для бесконечно больших коллекций.

A1

параметр типа для бинарного оператора, надтип A.

z

нейтральный элемент для операции fold; может быть добавлен к результату произвольное количество раз, и не должен изменять результат (например, Nil для конкатенации списков, 0 для сложения или 1 для умножения).

op

бинарный оператор, который должен быть ассоциативным.

returns

результат применения оператора fold op между всеми элементами и z, или z если этот перебираемый объект или итератор пуст.

Definition Classes
TraversableOnce → GenTraversableOnce

def foldLeft[B](z: B)(op: (B, String) ⇒ B): B

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

Примечание: не завершится для бесконечно больших коллекций.

Примечание: может возвращать разные результаты для разных запусков, если тип коллекции не упорядочен или оператор не ассоциативен и коммутативен.

B

тип результата бинарного оператора.

z

начальное значение.

op

бинарный оператор.

returns

результат вставки op между последовательными элементами этого перебираемого объекта или итератора, слева направо с начальным значением z слева:

op(...op(z, x_1), x_2, ..., x_n)

где x1, ..., xn - это элементы этого перебираемого объекта или итератора. Возвращает z если этот перебираемый объект или итератор пуст.

Definition Classes
TraversableOnce → GenTraversableOnce

def foldRight[B](z: B)(op: (String, B) ⇒ B): B

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

Примечание: не завершится для бесконечно больших коллекций.

Примечание: может возвращать разные результаты для разных запусков, если тип коллекции не упорядочен или оператор не ассоциативен и коммутативен.

B

тип результата бинарного оператора.

z

начальное значение.

op

бинарный оператор.

returns

результат вставки op между последовательными элементами этого перебираемого объекта или итератора, справа налево с начальным значением z справа:

op(x_1, op(x_2, ... op(x_n, z)...))

где x1, ..., xn - это элементы этого перебираемого объекта или итератора. Возвращает z если этот перебираемый объект или итератор пуст.

Definition Classes
TraversableOnce → GenTraversableOnce

def forall(p: (String) ⇒ Boolean): Boolean

Проверяет, выполняется ли предикат для всех значений, производимых этим итератором.

Примечание: может не завершиться для бесконечных итераторов.

p

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

returns

true если заданный предикат p выполняется для всех значений, производимых этим итератором, в противном случае false.

Definition Classes
Iterator → TraversableOnce → GenTraversableOnce
Note

Переиспользование: После вызова этого метода итератор, на котором он был вызван, следует отбросить. Использование его не определено и может измениться.

def foreach(f: (String) ⇒ Unit): Unit

[use case]

Применяет функцию f ко всем значениям, производимым этим итератором.

f

функция, которая применяется для побочного эффекта к каждому элементу. Результат функции f игнорируется.

Definition Classes
Iterator → TraversableOnce → GenTraversableOnce
Полная сигнатура

def formatted(fmtstr: String): String

Возвращает строку, отформатированную в соответствии с заданной format строкой. Строки формата аналогичны строкам String.format (@см. java.lang.String.format).

Неявный
Этот член добавлен неявным преобразованием из LineIterator в StringFormat[LineIterator] выполненным методом StringFormat в scala.Predef.
Definition Classes
StringFormat
Аннотации
@inline()

final def getClass(): Class[_]

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

возвращает

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

Definition Classes
AnyRef → Any
Аннотации
@native()

def getc(): Boolean

def grouped[B >: String](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
LineIterator → Iterator
Примечание

Переиспользование: Итератор остаётся допустимым для дальнейшего использования независимо от возвращаемого результата.

def hashCode(): Int

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

возвращает

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

Definition Classes
AnyRef → Any
Аннотации
@native()

def indexOf[B >: String](elem: B, from: Int): Int

Возвращает индекс первого вхождения указанного объекта в этом итерируемом объекте после или на некотором начальном индексе.

Примечание: может не завершиться для бесконечных итераторов.

elem

элемент для поиска.

from

начальный индекс

возвращает

индекс >= from первого вхождения elem в значениях, производимых этим итератором, или -1, если такой элемент не существует до достижения конца итератора.

Definition Classes
Iterator
Примечание

Переиспользование: После вызова этого метода следует удалить итератор, на котором он был вызван. Использование его не определено и может измениться.

def indexOf[B >: String](elem: B): Int

Возвращает индекс первого вхождения указанного объекта в этом итерируемом объекте.

Примечание: может не завершиться для бесконечных итераторов.

elem

элемент для поиска.

возвращает

индекс первого вхождения elem в значениях, производимых этим итератором, или -1, если такой элемент не существует до достижения конца итератора.

Definition Classes
Iterator
Примечание

Переиспользование: После вызова этого метода следует удалить итератор, на котором он был вызван. Использование его не определено и может измениться.

def indexWhere(p: (String) ⇒ Boolean, from: Int): Int

Возвращает индекс первого произведённого значения, удовлетворяющего предикату, или -1, после или на некотором начальном индексе.

Примечание: может не завершиться для бесконечных итераторов.

p

предикат для проверки значений

from

начальный индекс

returns

индекс >= from первого произведённого значения, удовлетворяющего p, или -1, если такого элемента не существует до тех пор, пока не будет достигнут конец итератора.

Definition Classes
Iterator
Note

Переиспользование: После вызова этого метода следует удалить итератор, на котором он был вызван. Его использование не определено и может быть изменено.

def indexWhere(p: (String) ⇒ Boolean): Int

Возвращает индекс первого произведённого значения, удовлетворяющего предикату, или -1.

Примечание: может не завершиться для бесконечных итераторов.

p

предикат для проверки значений

returns

индекс первого произведённого значения, удовлетворяющего p, или -1, если такого элемента не существует до тех пор, пока не будет достигнут конец итератора.

Definition Classes
Iterator
Note

Переиспользование: После вызова этого метода следует удалить итератор, на котором он был вызван. Его использование не определено и может быть изменено.

def isEmpty: Boolean

Проверяет, является ли этот итератор пустым.

returns

true если hasNext ложно, 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 isNewline(ch: Char): Boolean

def isTraversableAgain: Boolean

Проверка, может ли этот итератор быть повторно пройден.

returns

false

Definition Classes
Iterator → GenTraversableOnce
Note

Переиспользование: Итератор остаётся допустимым для дальнейшего использования независимо от возвращаемого результата.

lazy val iter: BufferedIterator[Char]

def length: Int

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

Примечание: не завершится для бесконечных итераторов.

Definition Classes
Iterator
Note

Переиспользование: После вызова этого метода следует удалить итератор, на котором он был вызван. Его использование не определено и может быть изменено.

def map[B](f: (String) ⇒ B): collection.Iterator[B]

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

f

функция преобразования

returns

новый итератор, который преобразует каждое значение, производимое этим итератором, путём применения функции f к нему.

Definition Classes
Iterator
Note

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

def max: A

[use case]

Находит наибольший элемент.

returns

наибольший элемент этого перечислимого объекта или итератора.

Definition Classes
TraversableOnce → GenTraversableOnce
Полная сигнатура
Исключения

UnsupportedOperationException, если этот перечислимый объект или итератор пуст.

def maxBy[B](f: (A) ⇒ B): A

[use case]

Находит первый элемент, который даёт наибольшее значение, измеренное функцией f.

B

Тип результата функции f.

f

Функция измерения.

returns

первый элемент этого перечислимого объекта или итератора с наибольшим значением, измеренным функцией f.

Definition Classes
TraversableOnce → GenTraversableOnce
Полная сигнатура
Исключения

UnsupportedOperationException, если этот перечислимый объект или итератор пуст.

def min: A

[use case]

Находит наименьший элемент.

returns

наименьший элемент этого обходчика или итератора

Definition Classes
TraversableOnce → GenTraversableOnce
Полная сигнатура
Исключения

UnsupportedOperationException, если этот обходчик или итератор пуст.

def minBy[B](f: (A) ⇒ B): A

[use case]

Находит первый элемент, который дает наименьшее значение, измеренное функцией 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(): String

Возвращает следующий элемент этого итератора.

returns

следующий элемент этого итератора, если hasNext является true, в противном случае - неопределенное поведение.

Definition Classes
LineIterator → 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: String): collection.Iterator[String]

[use case]

Добавляет значения элементов в этот итератор до тех пор, пока не будет достигнута заданная целевая длина.

len

целевая длина

elem

значение для дополнения

returns

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

Definition Classes
Iterator
Полная сигнатура

def partition(p: (String) ⇒ Boolean): (collection.Iterator[String], collection.Iterator[String])

Разделяет этот итератор на два итератора в соответствии с предикатом.

p

предикат для разделения

returns

пара итераторов: итератор, удовлетворяющий предикату p, и итератор, который этому предикату не удовлетворяет. Относительный порядок элементов в результирующих итераторах такой же, как в исходном итераторе.

Definition Classes
Iterator
Примечание

Переиспользование: после вызова этого метода, следует удалить итератор, на котором он был вызван, а использовать только возвращённые итераторы. Использование старого итератора является неопределённым, может быть изменено и может привести к изменениям в новых итераторах.

def patch[B >: String](from: Int, patchElems: collection.Iterator[B], replaced: Int): collection.Iterator[B]

Возвращает этот итератор с изменёнными значениями. Замена в отрицательных индексах эквивалентна замене, начинающейся с 0. Замена в индексах, равных или больших длине исходного итератора, добавляет исправление в конец. Если заменено больше значений, чем существует, избыток игнорируется.

from

Начальный индекс, с которого начинается замена

patchElems

Итератор значений исправления

replaced

Количество значений в исходном итераторе, которые заменяются исправление.

Definition Classes
Iterator
Примечание

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

def product: A

[use case]

Перемножает элементы этой коллекции.

returns

произведение всех элементов в этом перебираемом объекте или итераторе чисел типа Int. Вместо Int, может использоваться любой другой тип T с неявной реализацией Numeric[T] как типа элементов перебираемого объекта или итератора и как типа результата product. Примерами таких типов являются: Long, Float, Double, BigInt.

Definition Classes
TraversableOnce → GenTraversableOnce
Полная сигнатура

def reduce[A1 >: String](op: (A1, A1) ⇒ A1): A1

Применяет заданный ассоциативный бинарный оператор ко всем элементам этого перебираемого объекта или итератора.

Порядок выполнения операций над элементами не определён и может быть не детерминированным.

A1

Тип параметра для бинарного оператора, надтипом A.

op

Бинарный оператор, который должен быть ассоциативным.

returns

Результат применения оператора op между всеми элементами, если перебираемый объект или итератор не пустой.

Definition Classes
TraversableOnce → GenTraversableOnce
Исключения

UnsupportedOperationException если этот перебираемый объект или итератор пустой.

def reduceLeft[B >: String](op: (B, String) ⇒ 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 >: String](op: (B, String) ⇒ B): Option[B]

Необязательно применяет бинарный оператор ко всем элементам этого итерируемого объекта или итератора, слева направо.

Примечание: не будет завершаться для коллекций бесконечного размера.

Примечание: может возвращать разные результаты для разных запусков, если тип базовой коллекции не упорядочен или оператор не ассоциативен и коммутативен.

B

тип результата бинарного оператора.

op

бинарный оператор.

returns

значение типа Option, содержащее результат reduceLeft(op), если этот итерируемый объект или итератор не пуст, None в противном случае.

Definition Classes
TraversableOnce → GenTraversableOnce

def reduceOption[A1 >: String](op: (A1, A1) ⇒ A1): Option[A1]

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

Порядок выполнения операций над элементами не определен и может быть не детерминированным.

A1

Параметр типа для бинарного оператора, супертип A.

op

Бинарный оператор, который должен быть ассоциативным.

returns

Значение типа Option, содержащее результат применения оператора reduce op между всеми элементами, если коллекция не пустая, и None в противном случае.

Definition Classes
TraversableOnce → GenTraversableOnce

def reduceRight[B >: String](op: (String, 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
Исключения

UnsupportedOperationException если этот итерируемый объект или итератор пуст.

def reduceRightOption[B >: String](op: (String, B) ⇒ B): Option[B]

Необязательно применяет бинарный оператор ко всем элементам этого итерируемого объекта или итератора, справа налево.

Примечание: не будет завершаться для коллекций бесконечного размера.

Примечание: может возвращать разные результаты для разных запусков, если тип базовой коллекции упорядочен или оператор ассоциативен и коммутативен.

B

тип результата бинарного оператора.

op

бинарный оператор.

returns

значение типа Option, содержащее результат reduceRight(op) если этот итерируемый объект или итератор не пуст, None в противном случае.

Definition Classes
TraversableOnce → GenTraversableOnce

def reversed: List[String]

Атрибуты
protected[this]
Definition Classes
TraversableOnce

def sameElements(that: collection.Iterator[_]): Boolean

Проверяет, генерирует ли другой итератор те же значения, что и этот.

Примечание: не будет завершаться для бесконечных итераторов.

that

другой итератор

returns

true, если оба итератора генерируют те же элементы в том же порядке, false в противном случае.

Definition Classes
Iterator
Примечание

Повторное использование: После вызова этого метода следует удалить итератор, на котором он был вызван, а также тот, который был передан в качестве параметра. Использование старых итераторов неопределено и может измениться.

def scanLeft[B](z: B)(op: (B, String) ⇒ B): collection.Iterator[B]

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

Примечание: не будет завершаться для бесконечных итераторов.

Примечание: может возвращать разные результаты для разных запусков, если базовый тип коллекции упорядочен.

B

тип элементов в результирующей коллекции

z

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

op

бинарный оператор, применяемый к промежуточному результату и элементу

returns

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

Definition Classes
Iterator
Примечание

Повторное использование: После вызова этого метода следует удалить итератор, на котором он был вызван, и использовать только возвращенный итератор. Использование старого итератора неопределено, может измениться и может привести к изменениям в новом итераторе.

def scanRight[B](z: B)(op: (String, B) ⇒ B): collection.Iterator[B]

Производит коллекцию, содержащую кумулятивные результаты применения оператора справа налево. Голова коллекции — это последний кумулятивный результат.

Примечание: не завершится для бесконечных итераторов.

Примечание: может возвращать разные результаты при разных запусках, если тип базовой коллекции не упорядочен.

B

тип элементов в результирующей коллекции

z

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

op

бинарный оператор, применяемый к промежуточному результату и элементу

returns

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

Definition Classes
Iterator
Пример:
    Iterator(1, 2, 3, 4).scanRight(0)(_ + _).toList == List(10, 9, 7, 4, 0)
Note

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

def seq: collection.Iterator[String]

Вариант этой коллекции со всеми операциями, реализованными последовательно (т.е. в однопоточном режиме).

Этот метод возвращает ссылку на эту коллекцию. В параллельных коллекциях он переопределён для возврата последовательной реализации этой коллекции. В обоих случаях сложность составляет 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): collection.Iterator[String]

Создаёт итератор, возвращающий интервал значений, производимых этим итератором.

from

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

until

индекс первого элемента, следующего за срезом. Если отрицательный, срез пуст.

returns

итератор, который продвигает этот итератор мимо первых from элементов с помощью drop, и затем берёт until - from элементов, используя take.

Definition Classes
Iterator
Note

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

def sliceIterator(from: Int, until: Int): collection.Iterator[String]

Создаёт необязательно ограниченный срез, неограниченный, если until отрицательный.

Attributes
protected
Definition Classes
Iterator

def sliding[B >: String](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: (String) ⇒ Boolean): (collection.Iterator[String], collection.Iterator[String])

Разделяет этот итератор на пару префикс/суффикс в соответствии с предикатом.

p

предикат проверки

returns

пара итераторов, состоящая из самого длинного префикса этого итератора, элементы которого удовлетворяют p, и остальной части итератора.

Definition Classes
Iterator
Note

Переиспользование: После вызова этого метода следует удалить вызвавший его итератор и использовать только возвращенные итераторы. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новых итераторах.

def sum: A

[use case]

Суммирует элементы этого набора.

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): collection.Iterator[String]

Выбирает первые n значений этого итератора.

n

количество значений для выбора

returns

итератор, производящий только первые n значений этого итератора, или весь итератор, если он производит меньше n значений.

Definition Classes
Iterator
Note

Переиспользование: После вызова этого метода следует удалить вызвавший его итератор и использовать только возвращенный итератор. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новом итераторе.

def takeWhile(p: (String) ⇒ Boolean): collection.Iterator[String]

Извлекает самый длинный префикс значений, производимых этим итератором, которые удовлетворяют предикату.

p

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

returns

Итератор, возвращающий значения, производимые этим итератором, до тех пор, пока этот итератор не произведёт значение, которое не удовлетворяет предикату p.

Definition Classes
Iterator
Note

Переиспользование: После вызова этого метода следует удалить вызвавший его итератор и использовать только возвращенный итератор. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новом итераторе.

def to[Col[_]]: Col[A]

[use case]

Преобразует этот итерируемый объект или итератор в другой, копируя все элементы.

Примечание: не завершится для бесконечных итераторов.

Col

Тип коллекции, которую необходимо создать.

returns

новая коллекция, содержащая все элементы этого итерируемого объекта или итератора.

Definition Classes
TraversableOnce → GenTraversableOnce
Полная сигнатура

def toArray: Array[A]

[use case]

Преобразует этот итерируемый объект или итератор в массив.

Примечание: не завершится для бесконечных итераторов.

returns

массив, содержащий все элементы этого итерируемого объекта или итератора. Для типа элемента этого итерируемого объекта или итератора должна быть доступна ClassTag.

Definition Classes
TraversableOnce → GenTraversableOnce
Полная сигнатура

def toBuffer[B >: String]: Buffer[B]

Использует содержимое этого итерируемого объекта или итератора для создания нового изменяемого буфера.

Примечание: не завершится для бесконечных коллекций.

returns

буфер, содержащий все элементы этого итерируемого объекта или итератора.

Definition Classes
TraversableOnce → GenTraversableOnce

def toIndexedSeq: collection.immutable.IndexedSeq[String]

Преобразует этот итерируемый объект или итератор в индексированную последовательность.

Примечание: не завершится для бесконечных коллекций.

returns

индексированная последовательность, содержащая все элементы этого итерируемого объекта или итератора.

Definition Classes
TraversableOnce → GenTraversableOnce

def toIterable: collection.Iterable[String]

Преобразует этот итерируемый объект или итератор в коллекцию, которая может быть итерирована. Обратите внимание, что выбор целевого типа Iterable в этой реализации по умолчанию является ленивым, так как этот TraversableOnce может быть ленивым и не вычисленным (т. е. это может быть итератор, который можно пройти только один раз).

Примечание: не будет завершаться для коллекций бесконечного размера.

returns

объект Iterable, содержащий все элементы этого итерируемого объекта или итератора.

Definition Classes
TraversableOnce → GenTraversableOnce

def toIterator: collection.Iterator[String]

Возвращает итератор по элементам в этом итерируемом объекте или итераторе. Вернет тот же итератор, если этот экземпляр уже является итератором.

Примечание: не будет завершаться для бесконечных итераторов.

returns

итератор, содержащий все элементы этого итерируемого объекта или итератора.

Definition Classes
Iterator → GenTraversableOnce

def toList: List[String]

Преобразует этот итерируемый объект или итератор в список.

Примечание: не будет завершаться для коллекций бесконечного размера.

returns

список, содержащий все элементы этого итерируемого объекта или итератора.

Definition Classes
TraversableOnce → GenTraversableOnce

def toMap[T, U]: Map[T, U]

[use case]

Преобразует этот итерируемый объект или итератор в карту. Этот метод недоступен, если элементы не являются членами Tuple2, при этом каждый ((T, U)) становится парой ключ-значение в карте. Повторные ключи будут перезаписаны последующими ключами: если это неупорядоченная коллекция, ключ, который находится в результирующей карте, не определен.

Примечание: не будет завершаться для бесконечных итераторов.

returns

карта типа immutable.Map[T, U], содержащая все пары ключ/значение типа (T, U) этого итерируемого объекта или итератора.

Definition Classes
TraversableOnce → GenTraversableOnce
Полная подпись

def toSeq: collection.Seq[String]

Преобразует этот итерируемый объект или итератор в последовательность. Как и toIterable, эта функция является ленивой в этой реализации по умолчанию, так как этот TraversableOnce может быть ленивым и не вычисленным.

Примечание: не будет завершаться для коллекций бесконечного размера.

returns

последовательность, содержащая все элементы этого итерируемого объекта или итератора.

Definition Classes
TraversableOnce → GenTraversableOnce

def toSet[B >: String]: Set[B]

Преобразует этот итерируемый объект или итератор в множество.

Примечание: не будет завершаться для коллекций бесконечного размера.

returns

множество, содержащее все элементы этого итерируемого объекта или итератора.

Definition Classes
TraversableOnce → GenTraversableOnce

def toStream: collection.immutable.Stream[String]

Преобразует этот итерируемый объект или итератор в поток.

returns

поток, содержащий все элементы этого итерируемого объекта или итератора.

Definition Classes
Iterator → GenTraversableOnce

def toString(): String

Преобразует этот итератор в строку.

returns

"<iterator>" пуст ли итератор или нет.

Definition Classes
Iterator → AnyRef → Any
Note

Переиспользование: Итератор остается действительным для дальнейшего использования, независимо от возвращаемого результата.

def toTraversable: collection.Traversable[String]

Преобразует этот итерируемый объект или итератор в неопределенный итерируемый объект. Вернет ту же коллекцию, если этот экземпляр уже является итерируемым объектом.

Примечание: не будет завершаться для бесконечных итераторов.

returns

итерируемый объект, содержащий все элементы этого итерируемого объекта или итератора.

Definition Classes
Iterator → TraversableOnce → GenTraversableOnce

def toVector: Vector[String]

Преобразует этот итерируемый объект или итератор в вектор.

Примечание: не будет завершаться для коллекций бесконечного размера.

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

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

def withFilter(p: (String) ⇒ Boolean): collection.Iterator[String]

Создаёт итератор над всеми элементами этого итератора, удовлетворяющими предикату p. Порядок элементов сохраняется.

Примечание: withFilter эквивалентно filter для итераторов. Оно существует для того, чтобы выражения for с фильтрами работали над итераторами.

p

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

returns

итератор, который генерирует те значения из этого итератора, которые удовлетворяют предикату p.

Definition Classes
Iterator
Примечание

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

def zip[B](that: collection.Iterator[B]): collection.Iterator[(String, B)]

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

that

Итератор, предоставляющий вторую половину каждой пары результатов

returns

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

Definition Classes
Iterator
Примечание

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

def zipAll[B](that: collection.Iterator[B], thisElem: String, thatElem: B): collection.Iterator[(String, B)]

[use case]

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

that

итератор that может иметь разную длину по сравнению с текущим итератором.

thisElem

элемент thisElem используется для заполнения результирующего итератора, если текущий итератор короче that

thatElem

элемент thatElem используется для заполнения результирующего итератора, если that короче текущего итератора

returns

новый итератор, содержащий пары, состоящие из соответствующих значений этого итератора и that. Длина возвращаемого итератора равна максимальной из длин этого итератора и that. Если текущий итератор короче that, thisElem значения используются для дополнения результата. Если that короче текущего итератора, thatElem значения используются для дополнения результата.

Definition Classes
Iterator
Полная сигнатура

def zipWithIndex: collection.Iterator[(String, Int)]

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

returns

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

Definition Classes
Iterator
Примечание

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

def →[B](y: B): (LineIterator, B)

Неявный
Этот член добавлен неявным преобразованием из LineIterator в ArrowAssoc[LineIterator] выполненное методом ArrowAssoc в scala.Predef.
Definition Classes
ArrowAssoc

Затенённые неявные члены значения

def filter(p: (String) ⇒ Boolean): collection.TraversableOnce[String]

Неявный
Этот член добавлен неявным преобразованием из LineIterator в MonadOps[String] с помощью метода MonadOps в scala.collection.TraversableOnce.
Затенение
Этот неявно унаследованный член затенено одним или несколькими членами в этом классе.
Для доступа к этому члену можно использовать приведение типов:
(lineIterator: MonadOps[String]).filter(p)
Классы определений
MonadOps

def flatMap[B](f: (String) ⇒ GenTraversableOnce[B]): collection.TraversableOnce[B]

Неявный
Этот член добавлен неявным преобразованием из LineIterator в MonadOps[String] с помощью метода MonadOps в scala.collection.TraversableOnce.
Затенение
Этот неявно унаследованный член затенено одним или несколькими членами в этом классе.
Для доступа к этому члену можно использовать приведение типов:
(lineIterator: MonadOps[String]).flatMap(f)
Классы определений
MonadOps

def map[B](f: (String) ⇒ B): collection.TraversableOnce[B]

Неявный
Этот член добавлен неявным преобразованием из LineIterator в MonadOps[String] с помощью метода MonadOps в scala.collection.TraversableOnce.
Затенение
Этот неявно унаследованный член затенено одним или несколькими членами в этом классе.
Для доступа к этому члену можно использовать приведение типов:
(lineIterator: MonadOps[String]).map(f)
Классы определений
MonadOps

def withFilter(p: (String) ⇒ Boolean): collection.Iterator[String]

Неявный
Этот член добавлен неявным преобразованием из LineIterator в MonadOps[String] с помощью метода MonadOps в scala.collection.TraversableOnce.
Затенение
Этот неявно унаследованный член затенено одним или несколькими членами в этом классе.
Для доступа к этому члену можно использовать приведение типов:
(lineIterator: MonadOps[String]).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/io/Source$LineIterator.html

Spec-Zone.ru

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