Класс scala.io.Source

абстрактный класс Source extends Iterator[Char] с Closeable

Итерируемое представление исходных данных. Может быть сброшено с помощью необязательного метода reset.

Подклассы должны предоставить базовый итератор.

Обработку ошибок можно настроить, переопределив метод report.

Текущий вход ch, позиция pos и метод получения следующего символа next делегируют работу позиционеру.

По умолчанию позиционер кодирует номера строк и столбцов в позиции, передаваемой методу report. Это поведение можно изменить, предоставив пользовательского позиционера с помощью withPositioning.

Классы

Source

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

Source

объект NoPositioner extends Positioner

Source@nowarn("cat=deprecation")

класс Positioner(encoder: Position)

Source@nowarn("cat=deprecation")

объект RelaxedPosition

Реализация Position, которая игнорирует ошибки в позициях.

Source

объект RelaxedPositioner extends Positioner

Наследованные классы

Source

класс GroupedIterator[B >: A](self: Iterator[B], size: Int, step: Int) extends AbstractIterator[Seq[B]]

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

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

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

Source

def ch: Char

Source

def close(): Unit

Метод close() закрывает базовый ресурс.

Source

def getLines(): Iterator[String]

Возвращает итератор, который возвращает строки (НЕ включая символ(ы) новой строки). Он будет обрабатывать любой из \r\n, \r или \n как разделитель строк (самый длинный совпадение) - если вам нужно более точное поведение, вы можете напрямую подклассировать Source#LineIterator.

Source

def hasNext: Boolean

Возвращает true если у этого источника есть дополнительные символы.

Source

def next(): Char

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

Source

def pos: Int

Source

def report(pos: Int, msg: String, out: PrintStream): Unit

Source

def reportError(pos: Int, msg: String, out: PrintStream): Unit

Выводит сообщение об ошибке в выходной поток out.

Source

def reportWarning(pos: Int, msg: String, out: PrintStream): Unit

Source

def reset(): Source

Метод reset() создает новую копию этого Source.

Source

def withClose(f: () => Unit): Source

Source

def withDescription(text: String): Source

Source

def withPositioning(on: Boolean): Source

Изменить или отключить позиционер.

Source

def withPositioning(pos: Positioner): Source

Source

def withReset(f: () => Source): Source

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

Источник@inline

final def ++[B >: Char](xs: => IterableOnce[B]): Iterator[B]

Источник@inline

final 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

Источник@inline

final 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

Источник

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)

Источник

def buffered: BufferedIterator[Char]

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

Источник

def collect[B](pf: PartialFunction[Char, B]): Iterator[B]

Источник

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

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

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

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

Источник

def concat[B >: Char](xs: => IterableOnce[B]): Iterator[B]

Источник

def contains(elem: Any): Boolean

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

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

Источник

def copyToArray[B >: Char](xs: Array[B], start: Int, len: Int): Int

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

Заполняет указанный массив xs начиная с индекса start максимум len элементами этой коллекции.

Копирование прекратится, когда будут скопированы все элементы этой коллекции, или будет достигнут конец массива, или len элементов будут скопированы.

Источник@deprecatedOverriding("This should always forward to the 3-arg version of this method", since = "2.13.4")

def copyToArray[B >: Char](xs: Array[B], start: Int): Int

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

Заполняет указанный массив xs начиная с индекса start значениями этой коллекции.

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

Источник@deprecatedOverriding("Это всегда должно перенаправляться на версию этого метода с 3 аргументами", since = "2.13.4")

def copyToArray[B >: Char](xs: Array[B]): Int

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

Заполняет заданный массив xs начиная с индекса start значениями из этого набора.

Копирование завершится, когда будут скопированы все элементы этого набора или будет достигнут конец массива.

Источник

def corresponds[B](that: IterableOnce[B])(p: (Char, B) => Boolean): Boolean

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

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

Источник

def count(p: Char => Boolean): Int

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

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

Источник

def distinct: Iterator[Char]

Создает новый итератор из этого итератора без дублирующих элементов.

Источник

def distinctBy[B](f: Char => B): Iterator[Char]

Создаёт новый итератор из этого итератора без дубликатов элементов, определённых по == после применения преобразования f.

Источник

def drop(n: Int): Iterator[Char]

Источник

def dropWhile(p: Char => Boolean): Iterator[Char]

Источник

def duplicate: (Iterator[Char], Iterator[Char])

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

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

Источник

def exists(p: Char => Boolean): Boolean

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

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

Источник

def filter(p: Char => Boolean): Iterator[Char]

Источник

def filterNot(p: Char => Boolean): Iterator[Char]

Источник

def find(p: Char => Boolean): Option[Char]

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

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

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

Источник

def flatMap[B](f: Char => IterableOnce[B]): Iterator[B]

Источник

def flatten[B](implicit ev: Char => IterableOnce[B]): Iterator[B]

Источник

def fold[A1 >: Char](z: A1)(op: (A1, A1) => A1): A1

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

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

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

Источник

def foldLeft[B](z: B)(op: (B, Char) => B): B

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

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

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

Источник

def foldRight[B](z: B)(op: (Char, B) => B): B

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

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

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

Источник

def forall(p: Char => Boolean): Boolean

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

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

Источник

def foreach[U](f: Char => U): Unit

Применяет f к каждому элементу для его побочных эффектов. Примечание: [U] параметр необходим для помощи в инференции типов scalac.

Источник

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

Источник

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

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

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

Источник

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

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

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

Источник

def indexWhere(p: Char => Boolean, from: Int): Int

Source@deprecatedOverriding("isEmpty is defined as !hasNext; override hasNext instead", "2.13.0")

override def isEmpty: Boolean

Source

def isTraversableAgain: Boolean

Проверяет, можно ли многократно пройти по этому набору. Всегда истинно для Iterables и ложно для Iterators, если не переопределено.

Source@inline

final def iterator: Iterator[Char]

Source

def knownSize: Int

Source@inline

final def length: Int

Source

def map[B](f: Char => B): Iterator[B]

Source

def max[B >: Char](implicit ord: Ordering[B]): Char

Находит максимальный элемент.

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

Source

def maxBy[B](f: Char => B)(implicit cmp: Ordering[B]): Char

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

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

Исходный код

def maxByOption[B](f: Char => B)(implicit cmp: Ordering[B]): Option[Char]

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

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

Исходный код

def maxOption[B >: Char](implicit ord: Ordering[B]): Option[Char]

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

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

Исходный код

def min[B >: Char](implicit ord: Ordering[B]): Char

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

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

Исходный код

def minBy[B](f: Char => B)(implicit cmp: Ordering[B]): Char

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

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

Исходный код

def minByOption[B](f: Char => B)(implicit cmp: Ordering[B]): Option[Char]

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

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

Источник

def minOption[B >: Char](implicit ord: Ordering[B]): Option[Char]

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

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

Источник@inline

final def mkString: String

Отображает все элементы этого набора в строке.

Делегирует addString, который можно переопределить.

Источник@inline

final def mkString(sep: String): String

Отображает все элементы этого набора в строке с использованием разделительной строки.

Делегирует addString, который можно переопределить.

Источник

final def mkString(start: String, sep: String, end: String): String

Отображает все элементы этого набора в строке с использованием начальной, конечной и разделительной строк.

Делегирует addString, который можно переопределить.

Источник

def nextOption(): Option[Char]

Оборачивает значение next() в тип Option.

Источник@deprecatedOverriding("nonEmpty is defined as !isEmpty; override isEmpty instead", "2.13.0")

def nonEmpty: Boolean

Проверяет, не пуст ли набор.

Источник

def padTo[B >: Char](len: Int, elem: B): Iterator[B]

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

Источник

def partition(p: Char => Boolean): (Iterator[Char], Iterator[Char])

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

Источник

def patch[B >: Char](from: Int, patchElems: Iterator[B], replaced: Int): Iterator[B]

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

Источник

def product[B >: Char](implicit num: Numeric[B]): B

Перемножает элементы этого набора.

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

Источник

def reduce[B >: Char](op: (B, B) => B): B

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

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

Источник

def reduceLeft[B >: Char](op: (B, Char) => B): B

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

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

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

Источник

def reduceLeftOption[B >: Char](op: (B, Char) => B): Option[B]

Возможно применить бинарный оператор ко всем элементам этого набора слева направо.

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

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

Источник

def reduceOption[B >: Char](op: (B, B) => B): Option[B]

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

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

Источник

def reduceRight[B >: Char](op: (Char, B) => B): B

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

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

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

Источник

def reduceRightOption[B >: Char](op: (Char, B) => B): Option[B]

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

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

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

Источник

protected def reversed: Iterable[Char]

Источник

def sameElements[B >: Char](that: IterableOnce[B]): Boolean

Проверяет, равны ли соответствующие элементы данного итерируемого набора (в отношении ==) элементам этого итератора.

Источник

def scanLeft[B](z: B)(op: (B, Char) => B): Iterator[B]

Источник

def size: Int

Размер этого набора.

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

Source

def slice(from: Int, until: Int): Iterator[Символ]

Source

def sliding[B >: Символ](size: Int, step: Int): GroupedIterator[B]

Возвращает итератор, представляющий «скользящее окно» этого итератора. Первый аргумент — размер окна, а второй аргумент step — на сколько сдвигать окно на каждой итерации. step по умолчанию равно 1.

Возвращаемый GroupedIterator может быть настроен на заполнение частичного результата до размера size или подавление частичного результата полностью.

Примеры использования:

// Returns List(ArraySeq(1, 2, 3), ArraySeq(2, 3, 4), ArraySeq(3, 4, 5))
(1 to 5).iterator.sliding(3).toList
// Returns List(ArraySeq(1, 2, 3, 4), ArraySeq(4, 5))
(1 to 5).iterator.sliding(4, 3).toList
// Returns List(ArraySeq(1, 2, 3, 4))
(1 to 5).iterator.sliding(4, 3).withPartial(false).toList
// Returns List(ArraySeq(1, 2, 3, 4), ArraySeq(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

Source

def span(p: Символ => Boolean): (Iterator[Символ], Iterator[Символ])

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

Примечание: c span p эквивалентно (но, возможно, более эффективно, чем) (c takeWhile p, c dropWhile p), при условии, что вычисление предиката p не вызывает побочных эффектов.

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

Source

def splitAt(n: Int): (Iterator[Символ], Iterator[Символ])

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

Примечание: c splitAt n эквивалентно (но, возможно, более эффективно, чем) (c take n, c drop n).

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

Source

def stepper[S <: Stepper[_]](implicit shape: StepperShape[Символ, S]): S

Возвращает scala.collection.Stepper для элементов этой коллекции.

Stepper позволяет создавать Java-поток для обработки коллекции, см. scala.jdk.StreamConverters. Для коллекций, содержащих примитивные значения, Stepper может использоваться как итератор, который не упаковывает элементы.

Неявный параметр scala.collection.StepperShape определяет тип возвращаемого Stepper в соответствии с типом элемента этой коллекции.

• Для коллекций Int, Short, Byte или Char, возвращается scala.collection.IntStepper

• Для коллекций Double или Float, возвращается scala.collection.DoubleStepper

• Для коллекций Long возвращается scala.collection.LongStepper

• Для любого другого типа элемента возвращается scala.collection.AnyStepper

Обратите внимание, что этот метод переопределён в подклассах, а тип возвращаемого значения уточнён до S with EfficientSplit, например, scala.collection.IndexedSeqOps.stepper. Для Stepper, помеченных scala.collection.Stepper.EfficientSplit, преобразователи в scala.jdk.StreamConverters позволяют создавать параллельные потоки, в то время как обычные Stepper могут быть преобразованы только в последовательные потоки.

Source

def sum[B >: Символ](implicit num: Numeric[B]): B

Суммирует элементы этой коллекции.

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

Source

def take(n: Int): Iterator[Символ]

Source

def takeWhile(p: Символ => Boolean): Iterator[Символ]

Source

override def tapEach[U](f: Символ => U): Iterator[Символ]

Source

def to[C1](factory: Factory[Символ, C1]): C1

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

xs.to(List) xs.to(ArrayBuffer) xs.to(BitSet) // для xs: Iterable[Int]

Source

def toArray[B >: Символ : ClassTag]: Массив[B]

Преобразование коллекции в массив.

Примечание реализации: НЕ вызывать Array.from из этого метода.

Source@inline

final def toBuffer[B >: Символ]: Буфер[B]

Источник

def toIndexedSeq: IndexedSeq[Символ]

Источник

def toList: Список[Символ]

Источник

def toMap[K, V](implicit ev: Символ <:< (K, V)): Карта[K, V]

Источник

def toSeq: Последовательность[Символ]

Источник

def toSet[B >: Символ]: Множество[B]

Источник

override def toString: String

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

Источник

def toVector: Вектор[Символ]

Источник

def withFilter(p: Символ => Boolean): Iterator[Символ]

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

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

Источник

def zip[B](that: IterableOnce[B]): Iterator[(Символ, B)]

Источник

def zipAll[A1 >: Символ, B](that: IterableOnce[B], thisElem: A1, thatElem: B): Iterator[(A1, B)]

Источник

def zipWithIndex: Iterator[(Символ, Целое число)]

Конкретные поля

Источник

var descr: Строка

Описание этого источника, по умолчанию пустое

Источник

var nerrors: Целое число

Источник

var nwarnings: Целое число