Класс scala.io.Source
Компаньон объект Source
абстрактный класс Source extends Итератор[Символ] with Closeable
Конструкторы экземпляров
new Source()
Типовые члены
класс GroupedIterator[B >: A] extends AbstractIterator[Seq[B]] with Iterator[Seq[B]]
Гибкий итератор для преобразования Iterator[A] в Iterator[Seq[A]], с настраиваемым размером последовательности, шагом и стратегией для обработки элементов, которые не помещаются равномерно.
Типичные применения могут быть реализованы с помощью методов grouped и sliding.
- Определения классов
- Iterator
класс LineIterator extends AbstractIterator[String] with Iterator[String]
класс Positioner 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
- Неявный
- Этот член добавлен неявным преобразованием из Source в any2stringadd[Source] через метод any2stringadd в scala.Predef.
- Определяющие классы
- any2stringadd
def ++(that: ⇒ collection.Iterator[Char]): collection.Iterator[Char]
Конкатенация этого итератора с другим.
- that
другой итератор
- возвращает
новый итератор, который сначала выдает значения, производимые этим итератором, а затем значения, производимые итератором
that.
- Определяющие классы
- Iterator
def ->[B](y: B): (Source, B)
- Неявный
- Этот член добавлен неявным преобразованием из Source в ArrowAssoc[Source] через метод ArrowAssoc в scala.Predef.
- Определяющие классы
- ArrowAssoc
- Аннотации
- @inline()
def /:[B](z: B)(op: (B, Char) ⇒ 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: (Char, 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
строка-построитель, в которую добавляются элементы.
- 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, Char) ⇒ 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
- Исключения
ClassCastException, если объект-получатель не является экземпляром стирания типаT0.
def buffered: collection.BufferedIterator[Char]
Создает буферизованный итератор из этого итератора.
- returns
буферизованный итератор, генерирующий те же значения, что и этот итератор.
- Definition Classes
- Iterator
- Примечание
Переиспользование: после вызова этого метода следует удалить итератор, на котором он был вызван, и использовать только тот, который был возвращен. Использование старого итератора не определено, может измениться и может привести к изменениям в новом итераторе тоже.
- См. также
def ch: Char
def clone(): AnyRef
Создайте копию объекта-получателя.
По умолчанию реализация метода clone зависит от платформы.
- возвращает
копию объекта-получателя.
def close(): Unit
Метод close() закрывает базовый ресурс.
- Определяющие классы
- Source → Closeable → AutoCloseable
def collect[B](pf: PartialFunction[Char, B]): collection.Iterator[B]
Создаёт итератор, преобразуя значения, производимые этим итератором, с помощью частичной функции, отбрасывая те значения, для которых частичная функция не определена.
- pf
частичная функция, которая фильтрует и отображает итератор.
- возвращает
новый итератор, который возвращает каждое значение
x, производимое этим итератором, для которогоpfопределена - изображениеpf(x).
- Определяющие классы
- Iterator
- Аннотации
- @migration
- Миграция
(Изменено в версии 2.8.0)
collectизменилось. Предыдущее поведение можно воспроизвести с помощьюtoSeq.- Примечание
Переиспользование: После вызова этого метода следует удалить итератор, на котором он был вызван, и использовать только итератор, который был возвращён. Использование старого итератора не определено, может измениться и может привести к изменениям в новом итераторе также.
def collectFirst[B](pf: PartialFunction[Char, B]): Option[B]
Находит первый элемент в перебираемом объекте или итераторе, для которого заданная частичная функция определена, и применяет частичную функцию к нему.
Примечание: может не завершиться для коллекций бесконечного размера.
Примечание: может возвращать разные результаты для разных запусков, если только тип базовой коллекции не упорядочен.
- 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[Char], 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 >: Char](dest: Buffer[B]): Unit
Копирует все элементы этого перечислимого или итератора в буфер.
Примечание: не завершится для коллекций бесконечного размера.
- dest
Буфер, в который копируются элементы.
- Definition Classes
- TraversableOnce
def corresponds[B](that: GenTraversableOnce[B])(p: (Char, B) ⇒ Boolean): Boolean
Проверяет, соответствует ли каждый элемент этого итератора соответствующему элементу другой коллекции, удовлетворяя предикату теста.
- B
тип элементов
that- that
другая коллекция
- p
предикат теста, который связывает элементы из обеих коллекций
- returns
trueесли обе коллекции имеют одинаковую длину иp(x, y)являетсяtrueдля всех соответствующих элементовxэтого итератора иythat, в противном случаеfalse
- Definition Classes
- Iterator
def count(p: (Char) ⇒ Boolean): Int
Подсчитывает количество элементов в перечислимом или итераторе, которые удовлетворяют предикату.
- p
предикат, используемый для проверки элементов.
- returns
количество элементов, удовлетворяющих предикату
p.
- Definition Classes
- TraversableOnce → GenTraversableOnce
var descr: String
def drop(n: Int): collection.Iterator[Char]
Перемещает этот итератор мимо первых n элементов или длины итератора, что меньше.
- n
количество элементов для удаления
- returns
итератор, который генерирует все значения текущего итератора, кроме первых
nзначений.
- Definition Classes
- Iterator
- Note
Переиспользование: после вызова этого метода следует удалить вызываемый итератор и использовать только возвращенный итератор. Использование старого итератора неопределенно, может быть изменено и может привести к изменениям в новом итераторе.
def dropWhile(p: (Char) ⇒ Boolean): collection.Iterator[Char]
Пропускает самую длинную последовательность элементов этого итератора, которые удовлетворяют заданному предикату p, и возвращает итератор оставшихся элементов.
- p
предикат, используемый для пропуска элементов.
- returns
итератор, состоящий из оставшихся элементов
- Definition Classes
- Iterator
- Note
Переиспользование: после вызова этого метода следует удалить вызываемый итератор и использовать только возвращенный итератор. Использование старого итератора неопределенно, может быть изменено и может привести к изменениям в новом итераторе.
def duplicate: (collection.Iterator[Char], collection.Iterator[Char])
Создает два новых итератора, которые оба итерируются по тем же элементам, что и этот итератор (в том же порядке). Дублирующие итераторы считаются равными, если они расположены на одном элементе.
Учитывая, что большинство методов итераторов сделают исходный итератор непригодным для дальнейшего использования, этот метод обеспечивает надежный способ вызова нескольких таких методов на итераторе.
- returns
пара итераторов
- Definition Classes
- Iterator
- Note
-
Реализация может выделять временное хранилище для элементов, проитерированных одним итератором, но еще не другим.
,Переиспользование: после вызова этого метода следует удалить вызываемый итератор и использовать только возвращенные итераторы. Использование старого итератора неопределенно, может быть изменено и может привести к изменениям в новых итераторах.
def ensuring(cond: (Source) ⇒ Boolean, msg: ⇒ Any): Source
- Implicit
- Этот член добавлен неявным преобразованием от Source к Ensuring[Source] выполненным методом Ensuring в scala.Predef.
- Definition Classes
- Ensuring
def ensuring(cond: (Source) ⇒ Boolean): Source
- Implicit
- Этот член добавлен неявным преобразованием от Source к Ensuring[Source] выполненным методом Ensuring в scala.Predef.
- Definition Classes
- Ensuring
def ensuring(cond: Boolean, msg: ⇒ Any): Source
- Неявный
- Этот член добавлен неявным преобразованием из Source в Ensuring[Source] с помощью метода Ensuring в scala.Predef.
- Классы определения
- Ensuring
def ensuring(cond: Boolean): Source
- Неявный
- Этот член добавлен неявным преобразованием из Source в Ensuring[Source] с помощью метода Ensuring в scala.Predef.
- Классы определения
- Ensuring
final def eq(arg0: AnyRef): Boolean
Проверяет, является ли аргумент (that) ссылкой на объект-приёмник (this).
Метод eq реализует отношение эквивалентности на непустых экземплярах AnyRef, и имеет три дополнительных свойства:
-
Он согласован: для любых непустых экземпляров
x и y типа AnyRef, многократные вызовы x.eq(y) последовательно возвращают true или последовательно возвращают false. Для любого непустого экземпляра x типа AnyRef, x.eq(null) и null.eq(x) возвращают false.
null.eq(null) возвращает true. При переопределении методов equals или hashCode важно обеспечить согласованность их поведения с равенством ссылок. Поэтому, если два объекта являются ссылками друг на друга (o1 eq o2), они должны быть равны друг другу (o1 == o2) и должны иметь одинаковое значение хэша (o1.hashCode == o2.hashCode).
- возвращает
trueесли аргумент является ссылкой на объект-приёмник;falseв противном случае.
- Классы определения
- AnyRef
def equals(arg0: Any): Boolean
Метод равенства для ссылочных типов. По умолчанию делегирует вызов к eq.
См. также equals в scala.Any.
- возвращает
trueесли объект-приёмник эквивалентен аргументу;falseв противном случае.
- Классы определения
- AnyRef → Any
def exists(p: (Char) ⇒ Boolean): Boolean
Проверяет, выполняется ли предикат для некоторых значений, производимых этим итератором.
Примечание: может не завершиться для бесконечных итераторов.
- p
предикат для проверки элементов.
- возвращает
trueесли заданный предикатpвыполняется для некоторых значений, производимых этим итератором, в противном случаеfalse.
- Классы определения
- Iterator → TraversableOnce → GenTraversableOnce
- Примечание
Переиспользование: После вызова этого метода итератор, на котором он был вызван, следует удалить. Использование его в дальнейшем неопределённо и может быть изменено.
def filter(p: (Char) ⇒ Boolean): collection.Iterator[Char]
Возвращает итератор по всем элементам этого итератора, удовлетворяющим предикату p. Порядок элементов сохраняется.
- p
предикат для проверки значений.
- возвращает
итератор, который генерирует те значения этого итератора, которые удовлетворяют предикату
p.
- Классы определения
- Iterator
- Примечание
Переиспользование: После вызова этого метода исходный итератор следует удалить, и использовать только возвращённый итератор. Использование исходного итератора неопределённо, может быть изменено и может привести к изменениям в новом итераторе.
def filterNot(p: (Char) ⇒ Boolean): collection.Iterator[Char]
Создаёт итератор по всем элементам этого итератора, которые не удовлетворяют предикату p.
- p
предикат для проверки значений.
- возвращает
итератор, который генерирует те значения этого итератора, которые не удовлетворяют предикату
p.
- Классы определения
- Iterator
- Примечание
Переиспользование: После вызова этого метода исходный итератор следует удалить, и использовать только возвращённый итератор. Использование исходного итератора неопределённо, может быть изменено и может привести к изменениям в новом итераторе.
def finalize(): Unit
Вызывается сборщиком мусора для объекта-приёмника, когда больше нет ссылок на объект.
Детали вызова метода finalize, а также взаимодействие между finalize и нелокальными возвратами и исключениями зависят от платформы.
- Атрибуты
- protected[lang]
- Классы определения
- AnyRef
- Аннотации
- @throws( classOf[java.lang.Throwable] )
- Примечание
не специфицировано SLS как член AnyRef
def find(p: (Char) ⇒ Boolean): Option[Char]
Находит первое значение, производимое итератором, удовлетворяющее предикату, если таковое имеется.
Примечание: может не завершиться для бесконечных итераторов.
- p
предикат, используемый для проверки значений.
- returns
значение типа Option, содержащее первое значение, производимое итератором, удовлетворяющее предикату
p, илиNone, если такого значения не существует.
- Definition Classes
- Iterator → TraversableOnce → GenTraversableOnce
- Note
Переиспользование: после вызова этого метода итератор, на котором он был вызван, следует удалить. Его использование не определено и может измениться.
def flatMap[B](f: (Char) ⇒ GenTraversableOnce[B]): collection.Iterator[B]
Создает новый итератор, применяя функцию ко всем значениям, производимым этим итератором, и конкатенируя результаты.
- f
функция для применения к каждому элементу.
- returns
итератор, полученный в результате применения заданной функции, возвращающей итератор
f, к каждому значению, производимому этим итератором, и конкатенации результатов.
- Definition Classes
- Iterator
- Note
Переиспользование: после вызова этого метода итератор, на котором он был вызван, следует удалить, и использовать только возвращённый итератор. Использование старого итератора не определено, может измениться и может привести к изменениям в новом итераторе.
def fold[A1 >: Char](z: A1)(op: (A1, A1) ⇒ A1): A1
Производит свёртку элементов этого итератора или коллекции с использованием указанного ассоциативного бинарного оператора.
Порядок выполнения операций над элементами не определён и может быть недетерминированным.
Примечание: не завершится для бесконечных коллекций.
- A1
параметр типа для бинарного оператора, супертип
A.- z
нейтральный элемент для операции свёртки; может быть добавлен к результату произвольное количество раз и не должен изменять результат (например,
Nilдля конкатенации списков, 0 для сложения или 1 для умножения).- op
бинарный оператор, который должен быть ассоциативным.
- returns
результат применения оператора свёртки
opмежду всеми элементами иz, илиzесли эта коллекция или итератор пуста.
- Definition Classes
- TraversableOnce → GenTraversableOnce
def foldLeft[B](z: B)(op: (B, Char) ⇒ 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: (Char, 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: (Char) ⇒ Boolean): Boolean
Проверяет, выполняется ли предикат для всех значений, производимых этим итератором.
Примечание: может не завершиться для бесконечных итераторов.
- p
предикат, используемый для проверки элементов.
- returns
trueесли заданный предикатpвыполняется для всех значений, производимых этим итератором, в противном случаеfalse.
- Definition Classes
- Iterator → TraversableOnce → GenTraversableOnce
- Note
Переиспользование: после вызова этого метода итератор, на котором он был вызван, следует удалить. Его использование не определено и может измениться.
def foreach(f: (Char) ⇒ Unit): Unit
Применяет функцию f ко всем значениям, произведённым этим итератором.
- f
функция, которая применяется для побочного эффекта к каждому элементу. Результат функции
fигнорируется.
- Классы определений
- Iterator → TraversableOnce → GenTraversableOnce
def formatted(fmtstr: String): String
Возвращает строку, отформатированную в соответствии с заданной format строкой. Форматные строки аналогичны String.format (@см. java.lang.String.format).
- Неявный
- Этот член добавлен неявным преобразованием из Source в StringFormat[Source] с помощью метода StringFormat в scala.Predef.
- Классы определений
- StringFormat
- Аннотации
- @inline()
final def getClass(): Class[_]
Возвращает представление runtime-класса объекта.
- возвращает
объект класса, соответствующий runtime-типу получателя.
def getLines(): Iterator[String]
Возвращает итератор, возвращающий строки (без символа(ов) новой строки). Он будет обрабатывать любой из \r\n, \r или \n в качестве разделителя строки (наибольшее совпадение) — если вам нужна более точная обработка, вы можете напрямую наследовать Source#LineIterator.
def grouped[B >: Char](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
- Классы определений
- Iterator
- Примечание
Повторное использование: После вызова этого метода следует удалить вызываемый итератор и использовать только возвращённый итератор. Использование старого итератора не определено, может измениться и может привести к изменениям в новом итераторе.
def hasDefiniteSize: Boolean
Проверяет, имеет ли этот итератор известный размер.
- возвращает
trueдля пустых итераторов,falseв противном случае.
- Классы определений
- Iterator → TraversableOnce → GenTraversableOnce
- Примечание
Повторное использование: итератор остаётся допустимым для дальнейшего использования независимо от возвращаемого результата.
def hasNext: Boolean
Возвращает true если этот источник имеет больше символов.
- возвращает
trueесли последующий вызовnextвернёт элемент,falseв противном случае.
def hashCode(): Int
Метод hashCode для ссылочных типов. См. hashCode в scala.Any.
- возвращает
значение хеш-кода для этого объекта.
def indexOf[B >: Char](elem: B, from: Int): Int
Возвращает индекс первого вхождения указанного объекта в этом итерируемом объекте после или на определённом стартовом индексе.
Примечание: может не завершиться для бесконечных итераторов.
- elem
элемент для поиска.
- from
начальный индекс
- возвращает
индекс
>= fromпервого вхожденияelemв значения, производимые этим итератором, или -1, если такой элемент не существует до достижения конца итератора.
- Классы определений
- Iterator
- Примечание
Повторное использование: После вызова этого метода следует удалить вызываемый итератор. Его использование не определено и может измениться.
def indexOf[B >: Char](elem: B): Int
Возвращает индекс первого вхождения указанного объекта в этом итерируемом объекте.
Примечание: может не завершиться для бесконечных итераторов.
- elem
элемент для поиска.
- возвращает
индекс первого вхождения
elemв значения, производимые этим итератором, или -1, если такой элемент не существует до достижения конца итератора.
- Классы определений
- Iterator
- Примечание
Повторное использование: После вызова этого метода следует удалить вызываемый итератор. Его использование не определено и может измениться.
def indexWhere(p: (Char) ⇒ Boolean, from: Int): Int
Возвращает индекс первого произведённого значения, удовлетворяющего предикату, или -1, после или на определённом начальном индексе.
Примечание: может не завершаться для бесконечных итераторов.
- p
предикат для проверки значений
- from
начальный индекс
- returns
индекс
>= fromпервого произведённого значения, удовлетворяющегоp, или -1, если такого элемента не существует до достижения конца итератора.
- Definition Classes
- Iterator
- Note
Переиспользование: После вызова этого метода необходимо удалить итератор, на котором он был вызван. Его дальнейшее использование неопределено и может измениться.
def indexWhere(p: (Char) ⇒ 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 isTraversableAgain: Boolean
Проверяет, можно ли многократно пройти по этому итератору.
- returns
false
- Definition Classes
- Iterator → GenTraversableOnce
- Note
Переиспользование: Итератор остаётся допустимым для дальнейшего использования, независимо от возвращаемого результата.
def length: Int
Возвращает количество элементов в этом итераторе.
Примечание: не будет завершаться для бесконечных итераторов.
- Definition Classes
- Iterator
- Note
Переиспользование: После вызова этого метода необходимо удалить итератор, на котором он был вызван. Его дальнейшее использование неопределено и может измениться.
def map[B](f: (Char) ⇒ B): collection.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
Находит наименьший элемент.
- возвращает
наименьший элемент этого итерируемого объекта или итератора
- Определяющие классы
- TraversableOnce → GenTraversableOnce
- Исключения
UnsupportedOperationException, если этот итерируемый объект или итератор пустой.
def minBy[B](f: (A) ⇒ B): A
Находит первый элемент, который даёт наименьшее значение, измеряемое функцией f.
- B
Тип результата функции f.
- f
Функция измерения.
- возвращает
первый элемент этого итерируемого объекта или итератора с наименьшим значением, измеряемым функцией f.
- Определяющие классы
- TraversableOnce → GenTraversableOnce
- Исключения
UnsupportedOperationExceptionесли этот итерируемый объект или итератор пустой.
def mkString: String
Отображает все элементы этого итерируемого объекта или итератора в строке.
- возвращает
строковое представление этого итерируемого объекта или итератора. В результирующей строке строковые представления (относительно метода
toString) всех элементов этого итерируемого объекта или итератора следуют друг за другом без разделительной строки.
- Определяющие классы
- TraversableOnce → GenTraversableOnce
def mkString(sep: String): String
Отображает все элементы этого итерируемого объекта или итератора в строке, используя разделительную строку.
- sep
разделительная строка.
- возвращает
строковое представление этого итерируемого объекта или итератора. В результирующей строке строковые представления (относительно метода
toString) всех элементов этого итерируемого объекта или итератора разделяются строкойsep.
- Определяющие классы
- TraversableOnce → GenTraversableOnce
List(1, 2, 3).mkString("|") = "1|2|3"
def mkString(start: String, sep: String, end: String): String
Отображает все элементы этого итерируемого объекта или итератора в строке, используя начальную, конечную и разделительные строки.
- start
начальная строка.
- sep
разделительная строка.
- end
конечная строка.
- возвращает
строковое представление этого итерируемого объекта или итератора. Результирующая строка начинается со строки
startи заканчивается строкойend. Внутри, строковые представления (относительно методаtoString) всех элементов этого итерируемого объекта или итератора разделяются строкойsep.
- Определяющие классы
- TraversableOnce → GenTraversableOnce
List(1, 2, 3).mkString("(", "; ", ")") = "(1; 2; 3)"
final def ne(arg0: AnyRef): Boolean
Эквивалентно !(this eq that).
- возвращает
trueесли аргумент не ссылка на объект-приемник;falseв противном случае.
- Определяющие классы
- AnyRef
var nerrors: Int
def next(): Char
Возвращает следующий символ.
- возвращает
следующий элемент этого итератора, если
hasNextявляетсяtrue, в противном случае поведение не определено.
def nonEmpty: Boolean
Проверяет, не пуст ли итерируемый объект или итератор.
- возвращает
trueесли итерируемый объект или итератор содержит хотя бы один элемент,falseв противном случае.
- Определяющие классы
- TraversableOnce → GenTraversableOnce
final def notify(): Unit
Разбуживает один поток, ожидающий монитор объекта-приемника.
- Определяющие классы
- AnyRef
- Аннотации
- @native()
- Примечание
не указано SLS в качестве члена AnyRef
final def notifyAll(): Unit
Разбуживает все потоки, ожидающие монитор объекта-приемника.
- Определяющие классы
- AnyRef
- Аннотации
- @native()
- Примечание
не указано SLS в качестве члена AnyRef
var nwarnings: Int
def padTo(len: Int, elem: Char): collection.Iterator[Char]
Добавляет элементы до достижения заданной длины.
- len
целевая длина
- elem
значение для дополнения
- returns
новый итератор, содержащий все значения текущего итератора, дополненные минимальным количеством вхождений
elem, чтобы общее количество значений было не меньшеlen.
- Definition Classes
- Iterator
def partition(p: (Char) ⇒ Boolean): (collection.Iterator[Char], collection.Iterator[Char])
Разделяет текущий итератор на два итератора в соответствии с предикатом.
- p
предикат для разделения
- returns
пара итераторов: итератор, удовлетворяющий предикату
p, и итератор, который не удовлетворяет. Относительный порядок элементов в полученных итераторах такой же, как и в исходном итераторе.
- Definition Classes
- Iterator
- Примечание
Переиспользование: после вызова этого метода следует удалить исходный итератор, а использовать только возвращённые итераторы. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новых итераторах.
def patch[B >: Char](from: Int, patchElems: collection.Iterator[B], replaced: Int): collection.Iterator[B]
Возвращает текущий итератор с изменёнными значениями.
Замена по отрицательным индексам эквивалентна замене с начала. Замена по индексам, равным или большим длины исходного итератора, добавляет вставка в конец. Если заменяемых значений больше, чем фактически существует, избыточные значения игнорируются.
- from
Индекс начала замены
- patchElems
Итератор значений замены
- replaced
Количество значений в исходном итераторе, которые заменяются вставкой.
- Definition Classes
- Iterator
- Примечание
Переиспользование: после вызова этого метода нужно удалить исходный итератор, а также переданный в качестве параметра итератор, и использовать только возвращенный итератор. Использование старых итераторов не определено, может быть изменено и может привести к изменениям в новом итераторе.
def pos: Int
def product: A
Перемножает элементы коллекции.
- returns
произведение всех элементов в этом перечислимом или итераторе чисел типа
Int. ВместоInt, может быть использован любой другой типTс неявнымNumeric[T]имплементацией в качестве типа элементов перечислимого или итератора и как типа результатаproduct. Примеры таких типов:Long,Float,Double,BigInt.
- Definition Classes
- TraversableOnce → GenTraversableOnce
def reduce[A1 >: Char](op: (A1, A1) ⇒ A1): A1
Редукция элементов этого перечислимого или итератора с использованием заданного ассоциативного бинарного оператора.
Порядок выполнения операций над элементами не определён и может быть не детерминированным.
- A1
Тип параметр для бинарного оператора, супертип
A.- op
Ассоциативный бинарный оператор.
- returns
Результат применения оператора reduce
opмежду всеми элементами, если перечислимое или итератор не пусто.
- Definition Classes
- TraversableOnce → GenTraversableOnce
- Исключения
UnsupportedOperationException, если это перечислимое или итератор пусто.
def reduceLeft[B >: Char](op: (B, Char) ⇒ 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 >: Char](op: (B, Char) ⇒ B): Option[B]
Необязательно применяет бинарный оператор ко всем элементам этого перечислимого объекта или итератора, слева направо.
Примечание: не будет завершаться для коллекций бесконечного размера.
Примечание: может возвращать разные результаты для разных запусков, если тип базовой коллекции не упорядочен, или оператор не ассоциативен и не коммутативен.
- B
тип результата бинарного оператора.
- op
бинарный оператор.
- returns
значение опционального типа, содержащее результат
reduceLeft(op), если этот перечислимый объект или итератор не пуст;None, в противном случае.
- Definition Classes
- TraversableOnce → GenTraversableOnce
def reduceOption[A1 >: Char](op: (A1, A1) ⇒ A1): Option[A1]
Вычисляет результирующий элемент элементов этого перечислимого объекта или итератора, если таковые имеются, с использованием указанного ассоциативного бинарного оператора.
Порядок выполнения операций над элементами не определен и может быть недетерминированным.
- A1
Параметр типа для бинарного оператора, являющийся супертипом
A.- op
Бинарный оператор, который должен быть ассоциативным.
- returns
Значение опционального типа, содержащее результат применения оператора reduce
opмежду всеми элементами, если коллекция не пуста, иNoneв противном случае.
- Definition Classes
- TraversableOnce → GenTraversableOnce
def reduceRight[B >: Char](op: (Char, 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 >: Char](op: (Char, B) ⇒ B): Option[B]
Необязательно применяет бинарный оператор ко всем элементам этого перечислимого объекта или итератора, справа налево.
Примечание: не будет завершаться для коллекций бесконечного размера.
Примечание: может возвращать разные результаты для разных запусков, если тип базовой коллекции не упорядочен, или оператор не ассоциативен и не коммутативен.
- B
тип результата бинарного оператора.
- op
бинарный оператор.
- returns
значение опционального типа, содержащее результат
reduceRight(op), если этот перечислимый объект или итератор не пуст;None, в противном случае.
- Definition Classes
- TraversableOnce → GenTraversableOnce
def report(pos: Int, msg: String, out: PrintStream): Unit
- pos
позиция в исходном коде (строка/колонка)
- msg
сообщение об ошибке для вывода
- out
PrintStream для вывода
def reportError(pos: Int, msg: String, out: PrintStream = Console.err): Unit
Сообщает об ошибке в выходной поток out.
- pos
позиция в исходном коде (строка/колонка)
- msg
сообщение об ошибке для вывода
- out
PrintStream для вывода (необязательный параметр: по умолчанию
Console.err)
def reportWarning(pos: Int, msg: String, out: PrintStream = Console.out): Unit
- pos
позиция в исходном коде (строка/колонка)
- msg
сообщение об ошибке для вывода
- out
PrintStream для вывода (необязательный параметр: по умолчанию
Console.out)
def reset(): Source
def reversed: List[Char]
- Attributes
- protected[this]
- Definition Classes
- TraversableOnce
def sameElements(that: collection.Iterator[_]): Boolean
Проверяет, генерирует ли другой итератор те же значения, что и этот.
Примечание: не завершит работу для бесконечных итераторов.
- that
другой итератор
- returns
true, если оба итератора генерируют одни и те же элементы в том же порядке,falseв противном случае.
- Definition Classes
- Iterator
- Note
Использование: после вызова этого метода необходимо удалить итератор, на котором он был вызван, а также переданный в качестве параметра. Использование старых итераторов не определено и может быть изменено.
def scanLeft[B](z: B)(op: (B, Char) ⇒ B): collection.Iterator[B]
Возвращает коллекцию, содержащую кумулятивные результаты применения оператора слева направо, включая начальное значение.
Примечание: не завершит работу для бесконечных итераторов.
Примечание: может возвращать разные результаты для разных запусков, если тип базовой коллекции не упорядочен.
- B
тип элементов в результирующей коллекции
- z
начальное значение
- op
бинарный оператор, применяемый к промежуточному результату и элементу
- returns
итератор с промежуточными результатами
- Definition Classes
- Iterator
- Note
Использование: после вызова этого метода необходимо удалить итератор, на котором он был вызван, а также использовать только возвращённый итератор. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новом итераторе.
def scanRight[B](z: B)(op: (Char, B) ⇒ B): collection.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: collection.Iterator[Char]
Версия этой коллекции со всеми операциями, реализованными последовательно (т.е. в однопоточном режиме).
Этот метод возвращает ссылку на эту коллекцию. В параллельных коллекциях он переопределяется, чтобы вернуть последовательную реализацию этой коллекции. В обоих случаях сложность составляет 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[Char]
Создает итератор, возвращающий интервал значений, производимых этим итератором.
- from
индекс первого элемента в этом итераторе, который является частью среза. Если отрицательный, срез начинается с нуля.
- until
индекс первого элемента, следующего за срезом. Если отрицательный, срез пустой.
- returns
итератор, который продвигает этот итератор мимо первых
fromэлементов, используяdrop, и затем беретuntil - fromэлементов, используяtake.
- Definition Classes
- Iterator
- Note
Использование: после вызова этого метода необходимо удалить итератор, на котором он был вызван, а также использовать только возвращённый итератор. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новом итераторе.
def sliceIterator(from: Int, until: Int): collection.Iterator[Char]
Создаёт необязательно ограниченный срез, неограниченный, если until отрицателен.
- Attributes
- protected
- Definition Classes
- Iterator
def sliding[B >: Char](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
- Примечание
Переиспользование: после вызова этого метода следует удалить вызываемый итератор и использовать только возвращённый итератор. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новом итераторе.
def span(p: (Char) ⇒ Boolean): (collection.Iterator[Char], collection.Iterator[Char])
Разделяет этот итератор на пару префикс/суффикс в соответствии с предикатом.
- p
предикат проверки
- returns
пара итераторов, состоящих из самого длинного префикса этого итератора, чьи элементы удовлетворяют
p, и остальной части итератора.
- Definition Classes
- Iterator
- Примечание
Переиспользование: после вызова этого метода следует удалить вызываемый итератор и использовать только возвращённые итераторы. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новых итераторах.
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): collection.Iterator[Char]
Выбирает первые n значений этого итератора.
- n
количество значений для взятия
- returns
итератор, генерирующий только первые
nзначения этого итератора, или весь итератор, если он генерирует меньше, чемnзначений.
- Definition Classes
- Iterator
- Примечание
Переиспользование: после вызова этого метода следует удалить вызываемый итератор и использовать только возвращённый итератор. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новом итераторе.
def takeWhile(p: (Char) ⇒ Boolean): collection.Iterator[Char]
Берет самый длинный префикс значений, производимых этим итератором, который удовлетворяет предикату.
- p
Предикат, используемый для проверки элементов.
- returns
Итератор, возвращающий значения, производимые этим итератором, до тех пор, пока этот итератор не произведёт значение, которое не удовлетворяет предикату
p.
- Definition Classes
- Iterator
- Примечание
Переиспользование: после вызова этого метода следует удалить вызываемый итератор и использовать только возвращённый итератор. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новом итераторе.
def to[Col[_]]: Col[A]
Преобразует этот перечислимый или итератор в другой путём копирования всех элементов.
Примечание: не будет завершаться для бесконечных итераторов.
- Col
Тип коллекции для построения.
- returns
новая коллекция, содержащая все элементы этого перечислимого или итератора.
- Definition Classes
- TraversableOnce → GenTraversableOnce
def toArray: Array[A]
Преобразует этот перечислимый или итератор в массив.
Примечание: не будет завершаться для бесконечных итераторов.
- returns
массив, содержащий все элементы этого перечислимого или итератора. Должна быть доступна
ClassTagдля типа элемента этого перечислимого или итератора.
- Definition Classes
- TraversableOnce → GenTraversableOnce
def toBuffer[B >: Char]: Buffer[B]
Использует содержимое этого перечислимого или итератора для создания нового изменяемого буфера.
Примечание: не будет завершаться для бесконечно больших коллекций.
- returns
буфер, содержащий все элементы этого перечислимого или итератора.
- Definition Classes
- TraversableOnce → GenTraversableOnce
def toIndexedSeq: collection.immutable.IndexedSeq[Char]
Преобразует этот итерируемый объект или итератор в индексированную последовательность.
Примечание: не будет завершаться для коллекций бесконечного размера.
- returns
индексированная последовательность, содержащая все элементы этого итерируемого объекта или итератора.
- Definition Classes
- TraversableOnce → GenTraversableOnce
def toIterable: collection.Iterable[Char]
Преобразует этот итерируемый объект или итератор в итерируемую коллекцию. Обратите внимание, что выбор целевого Iterable является ленивым в этой реализации по умолчанию, так как этот TraversableOnce может быть ленивым и невычисленным (т. е. это может быть итератор, который можно проходить только один раз).
Примечание: не будет завершаться для коллекций бесконечного размера.
- returns
итерируемая
Iterable, содержащая все элементы этого итерируемого объекта или итератора.
- Definition Classes
- TraversableOnce → GenTraversableOnce
def toIterator: collection.Iterator[Char]
Возвращает итератор по элементам в этом итерируемом объекте или итераторе. Вернет тот же итератор, если этот экземпляр уже является итератором.
Примечание: не будет завершаться для бесконечных итераторов.
- returns
итератор, содержащий все элементы этого итерируемого объекта или итератора.
- Definition Classes
- Iterator → GenTraversableOnce
def toList: List[Char]
Преобразует этот итерируемый объект или итератор в список.
Примечание: не будет завершаться для коллекций бесконечного размера.
- returns
список, содержащий все элементы этого итерируемого объекта или итератора.
- Definition Classes
- TraversableOnce → GenTraversableOnce
def toMap[T, U]: Map[T, U]
Преобразует этот итерируемый объект или итератор в карту. Этот метод недоступен, если элементы не являются членами Tuple2, каждый ((T, U)) становится парой ключ-значение в карте. Повторяющиеся ключи будут перезаписаны более поздними ключами: если это неупорядоченная коллекция, то какой ключ находится в результирующей карте, не определено.
Примечание: не будет завершаться для бесконечных итераторов.
- returns
карта типа
immutable.Map[T, U], содержащая все пары ключ/значение типа(T, U)этого итерируемого объекта или итератора.
- Definition Classes
- TraversableOnce → GenTraversableOnce
def toSeq: collection.Seq[Char]
Преобразует этот итерируемый объект или итератор в последовательность. Как и toIterable, он ленивый в этой реализации по умолчанию, так как этот TraversableOnce может быть ленивым и невычисленным.
Примечание: не будет завершаться для коллекций бесконечного размера.
- returns
последовательность, содержащая все элементы этого итерируемого объекта или итератора.
- Definition Classes
- TraversableOnce → GenTraversableOnce
def toSet[B >: Char]: Set[B]
Преобразует этот итерируемый объект или итератор в множество.
Примечание: не будет завершаться для коллекций бесконечного размера.
- returns
множество, содержащее все элементы этого итерируемого объекта или итератора.
- Definition Classes
- TraversableOnce → GenTraversableOnce
def toStream: collection.immutable.Stream[Char]
Преобразует этот итерируемый объект или итератор в поток.
- returns
поток, содержащий все элементы этого итерируемого объекта или итератора.
- Definition Classes
- Iterator → GenTraversableOnce
def toString(): String
Преобразует этот итератор в строку.
- returns
"<iterator>"является ли итератор пустым.
def toTraversable: collection.Traversable[Char]
Преобразует этот итерируемый объект или итератор в неуказанный итерируемый объект. Вернет ту же коллекцию, если этот экземпляр уже является итерируемым объектом.
Примечание: не будет завершаться для бесконечных итераторов.
- returns
итерируемый объект, содержащий все элементы этого итерируемого объекта или итератора.
- Definition Classes
- Iterator → TraversableOnce → GenTraversableOnce
def toVector: Vector[Char]
Преобразует этот итерируемый объект или итератор в вектор.
Примечание: не завершится для коллекций бесконечного размера.
- 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 withClose(f: () ⇒ Unit): Source.this.type
def withDescription(text: String): Source.this.type
def withFilter(p: (Char) ⇒ Boolean): collection.Iterator[Char]
Создаёт итератор по всем элементам этого итератора, удовлетворяющим предикату p. Порядок элементов сохраняется.
Примечание: withFilter эквивалентно filter для итераторов. Оно существует для того, чтобы выражения for с фильтрами работали над итераторами.
- p
предикат, используемый для проверки значений.
- returns
итератор, который производит те значения из этого итератора, которые удовлетворяют предикату
p.
- Definition Classes
- Iterator
- Note
Переиспользование: после вызова этого метода следует отказаться от итератора, на котором он был вызван, и использовать только итератор, который был возвращён. Использование старого итератора не определено, может измениться и может привести к изменениям в новом итераторе тоже.
def withPositioning(pos: Positioner): Source.this.type
def withPositioning(on: Boolean): Source.this.type
def withReset(f: () ⇒ Source): Source.this.type
def zip[B](that: collection.Iterator[B]): collection.Iterator[(Char, B)]
Создаёт итератор, образованный из этого итератора и другого итератора путём объединения соответствующих значений в пары. Если один из двух итераторов длиннее другого, его оставшиеся элементы игнорируются.
- that
Итератор, предоставляющий вторую половину каждой пары результатов
- returns
новый итератор, содержащий пары, состоящие из соответствующих элементов этого итератора и
that. Количество элементов, возвращаемых новым итератором, равно минимуму из количества элементов, возвращаемых этим итератором иthat.
- Definition Classes
- Iterator
- Note
Переиспользование: после вызова этого метода следует отказаться от итератора, на котором он был вызван, а также от переданного в качестве параметра, и использовать только итератор, который был возвращён. Использование старых итераторов не определено, может измениться и может привести к изменениям в новом итераторе тоже.
def zipAll[B](that: collection.Iterator[B], thisElem: Char, thatElem: B): collection.Iterator[(Char, B)]
Создаёт итератор, образованный из этого итератора и другого итератора путём объединения соответствующих элементов в пары. Если один из двух итераторов короче другого, для расширения более короткого итератора до длины более длинного используются плацехолдеры.
- that
итератор
thatможет иметь разную длину по сравнению с итератором «self».- thisElem
элемент
thisElemиспользуется для заполнения результирующего итератора, если итератор «self» корочеthat- thatElem
элемент
thatElemиспользуется для заполнения результирующего итератора, еслиthatкороче итератора «self»- returns
новый итератор, содержащий пары, состоящие из соответствующих значений этого итератора и
that. Длина возвращаемого итератора равна максимуму из длин этого итератора иthat.
- Definition Classes
- Iterator
def zipWithIndex: collection.Iterator[(Char, Int)]
Создаёт итератор, который сопоставляет каждый элемент, создаваемый этим итератором, с его индексом, начиная с 0.
- returns
новый итератор, содержащий пары, состоящие из соответствующих элементов этого итератора и их индексов.
- Definition Classes
- Iterator
- Примечание
Переиспользование: после вызова этого метода следует удалить итератор, на котором он был вызван, и использовать только возвращённый итератор. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новом итераторе тоже.
def →[B](y: B): (Source, B)
- Неявный
- Этот член добавлен неявным преобразованием из Source в ArrowAssoc[Source] через метод ArrowAssoc в scala.Predef.
- Definition Classes
- ArrowAssoc
object NoPositioner extends Positioner
object RelaxedPosition extends Position
object RelaxedPositioner extends Positioner
Члены-значения, скрытые неявными преобразованиями
def filter(p: (Символ) ⇒ Boolean): collection.TraversableOnce[Символ]
- Неявный
- Этот член добавлен неявным преобразованием из Source в MonadOps[Символ] через метод MonadOps в scala.collection.TraversableOnce.
- Скрытие
- Этот неявно унаследованный член скрыт одним или несколькими членами в этом классе.
Для доступа к этому члену можно использовать приведение типа:(source: MonadOps[Char]).filter(p)
- Definition Classes
- MonadOps
def flatMap[B](f: (Символ) ⇒ GenTraversableOnce[B]): collection.TraversableOnce[B]
- Неявный
- Этот член добавлен неявным преобразованием из Source в MonadOps[Символ] через метод MonadOps в scala.collection.TraversableOnce.
- Скрытие
- Этот неявно унаследованный член скрыт одним или несколькими членами в этом классе.
Для доступа к этому члену можно использовать приведение типа:(source: MonadOps[Char]).flatMap(f)
- Definition Classes
- MonadOps
def map[B](f: (Символ) ⇒ B): collection.TraversableOnce[B]
- Неявный
- Этот член добавлен неявным преобразованием из Source в MonadOps[Символ] через метод MonadOps в scala.collection.TraversableOnce.
- Скрытие
- Этот неявно унаследованный член скрыт одним или несколькими членами в этом классе.
Для доступа к этому члену можно использовать приведение типа:(source: MonadOps[Char]).map(f)
- Definition Classes
- MonadOps
def withFilter(p: (Символ) ⇒ Boolean): collection.Iterator[Символ]
- Неявный
- Этот член добавлен неявным преобразованием из Source в MonadOps[Символ] через метод MonadOps в scala.collection.TraversableOnce.
- Скрытие
- Этот неявно унаследованный член скрыт одним или несколькими членами в этом классе.
Для доступа к этому члену можно использовать приведение типа:(source: MonadOps[Char]).withFilter(p)
- Definition Classes
- 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.html
Итерируемое представление исходных данных. Может быть перезапущено с помощью необязательного метода reset.
Подклассы должны предоставить базовый итератор.
Обработка ошибок может быть настраиваемой путём переопределения метода report.
Текущий входной символ ch и позиция pos, а также метод получения следующего символа next делегируют обработку позиционеру.
По умолчанию позиционер кодирует номера строки и колонки в позиции, передаваемой в метод report. Это поведение можно изменить, указав собственный позиционер.