Spec-Zone.ru › Scala 3.1

Класс scala.io.BufferedSource

Исходный код

класс BufferedSource(inputStream: InputStream, bufferSize: Int)(implicit val codec: Codec) extends Source

Этот объект предоставляет удобные методы для создания итерируемого представления файла-источника.

Надтипы
класс Source
интерфейс Closeable
интерфейс AutoCloseable
интерфейс Iterator[Char]
интерфейс IterableOnceOps[Char, Iterator, Iterator[Char]]
интерфейс IterableOnce[Char]
класс Object
интерфейс Matchable
класс Any

Классы

Source
класс BufferedLineIterator extends AbstractIterator[String] with Iterator[String]

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

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

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

Типичные применения могут быть реализованы через методы grouped и sliding.

Наследованный от Iterator

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

Наследованный от Source

Source
объект NoPositioner extends Positioner

Наследованный от Source

Source@nowarn("cat=deprecation")
класс Positioner(encoder: Position)

Наследованный от Source

Source@nowarn("cat=deprecation")
объект RelaxedPosition

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

Наследованный от Source

Source
объект RelaxedPositioner extends Positioner

Наследованный от Source

Конструкторы

Source
конструктор this(inputStream: InputStream)(implicit codec: Codec)

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

Source
переопределенный метод addString(sb: StringBuilder, start: String, sep: String, end: String): StringBuilder

Эффективно добавляет оставшиеся данные.

Примечание: этот метод может временно загрузить весь буфер в память.

Определения классов IterableOnceOps

Source
метод bufferedReader(): BufferedReader

Source
переопределенный метод getLines(): Iterator[String]

Определения классов Source

Source
метод reader(): InputStreamReader

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

Source@inline
final метод ++[B >: Char](xs: => IterableOnce[B]): Iterator[B]

Наследованный от Iterator

Source@inline
final метод addString(b: StringBuilder): StringBuilder

Добавляет все элементы этой коллекции в строковый буфер. Записанный текст состоит из строковых представлений (согласно методу toString) всех элементов этой коллекции без разделителя.

Пример:

scala> val a = List(1,2,3,4)
a: List[Int] = List(1, 2, 3, 4)

scala> val b = new StringBuilder()
b: StringBuilder =

scala> val h = a.addString(b)
h: StringBuilder = 1234
Параметры значения
b

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

Возвращает

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

Наследованный от IterableOnceOps

Source@inline
final метод addString(b: StringBuilder, sep: String): StringBuilder

Добавляет все элементы этой коллекции в строковый буфер, используя разделитель. Записанный текст состоит из строковых представлений (согласно методу toString) всех элементов этой коллекции, разделенных строкой sep.

Пример:

scala> val a = List(1,2,3,4)
a: List[Int] = List(1, 2, 3, 4)

scala> val b = new StringBuilder()
b: StringBuilder =

scala> a.addString(b, ", ")
res0: StringBuilder = 1, 2, 3, 4
Параметры значения
b

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

sep

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

Возвращает

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

Наследованный от IterableOnceOps

Source
метод buffered: BufferedIterator[Char]

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

Возвращает

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

См. также

scala.collection.BufferedIterator

Примечание

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

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

Source
def ch: Char

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

Source
def close(): Unit

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

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

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

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

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

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

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

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

Параметры
pf

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

Возвращает

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

Пример

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

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

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

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

Source
def contains(elem: Any): Boolean

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

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

Параметры
elem

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

Возвращает

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

Примечание

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

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

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

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

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

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

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

тип элементов массива.

Параметры
len

максимальное количество копируемых элементов.

start

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

xs

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

Возвращает

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

Примечание

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

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

Source@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 значениями этой коллекции.

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

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

тип элементов массива.

Параметры
start

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

xs

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

Возвращает

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

Примечание

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

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

Source@deprecatedOverriding("This should always forward to the 3-arg version of this method", since = "2.13.4")
def copyToArray[B >: Char](xs: Array[B]): Int

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

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

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

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

тип элементов массива.

Параметры
xs

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

Возвращает

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

Примечание

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

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

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

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

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

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

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

Параметры
p

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

that

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

Возвращает

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

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

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

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

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

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

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

Возвращает

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

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

Источник
def distinct: Iterator[Символ]

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

Возвращает

итератор с уникальными элементами

Примечание

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

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

Источник
def distinctBy[B](f: Символ => B): Iterator[Символ]

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

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

тип элементов после преобразования функцией f

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

Преобразующая функция, результат которой используется для определения уникальности каждого элемента

Возвращает

итератор с уникальными элементами

Примечание

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

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

Источник
def drop(n: Целое число): Iterator[Символ]

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

Источник
def dropWhile(p: Символ => Булево): Iterator[Символ]

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

Источник
def duplicate: (Iterator[Символ], Iterator[Символ])

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

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

Возвращает

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

Примечание

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

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

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

Источник
def exists(p: Символ => Булево): Булево

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

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

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

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

Возвращает

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

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

Источник
def filter(p: Символ => Булево): Iterator[Символ]

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

Источник
def filterNot(p: Символ => Булево): Iterator[Символ]

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

Источник
def find(p: Символ => Булево): Option[Символ]

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

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

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

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

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

Возвращает

значение типа option, содержащее первый элемент в наборе, удовлетворяющий p, или None в противном случае.

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

Источник
def flatMap[B](f: Символ => IterableOnce[B]): Iterator[B]

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

Источник
def flatten[B](implicit ev: Символ => IterableOnce[B]): Iterator[B]

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

Источник
def fold[A1 >: Символ](z: A1)(op: (A1, A1) => A1): A1

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

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

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

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

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

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

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

z

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

Возвращает

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

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

Источник
def foldLeft[B](z: B)(op: (B, Символ) => B): B

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

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

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

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

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

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

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

z

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

Возвращает

результат вставки op между последовательными элементами этого набора, слева направо с начальным значением z слева: op(...op(z, x1), x2, ..., xn) где x1, ..., xn являются элементами этого набора. Возвращает z если этот набор пустой.

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

Исходный код
def foldRight[B](z: B)(op: (Char, B) => B): B

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

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

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

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

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

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

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

z

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

Возвращает

результат вставки op между последовательными элементами этого набора, справа налево с начальным значением z справа: op(x1, op(x2, ... op(xn, z)...)) где x1, ..., xn являются элементами этого набора. Возвращает z если этот набор пустой.

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

Исходный код
def forall(p: Char => Boolean): Boolean

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

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

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

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

Возвращает

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

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

Исходный код
def foreach[U](f: Char => U): Unit

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

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

Исходный код
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 hasNext: Boolean

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

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

Исходный код
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

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

Исходный код @deprecatedOverriding("isEmpty is defined as !hasNext; override hasNext instead", "2.13.0")
override def isEmpty: Boolean

Классы-предки Iterator -> IterableOnceOps
Унаследовано от Iterator

Исходный код
def isTraversableAgain: Boolean

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

Возвращает

true если многократное прохождение возможно, false в противном случае.

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

Исходный код @inline
final def iterator: Iterator[Char]

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

Исходный код
def knownSize: Int

Возвращает

Количество элементов в этом наборе, если его можно вычислить без затрат, -1 в противном случае. Без затрат обычно означает: Не требуется проход по набору.

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

Исходный код @inline
final def length: Int

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

Исходный код
def map[B](f: Char => B): Iterator[B]

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

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

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

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

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

Тип, по которому определено упорядочение.

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

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

Возвращает

наибольший элемент этой коллекции по отношению к упорядочению ord.

Исключения
UnsupportedOperationException

если эта коллекция пуста.

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

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

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

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

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

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

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

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

f

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

Возвращает

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

Исключения
UnsupportedOperationException

если эта коллекция пуста.

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

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

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

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

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

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

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

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

f

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

Возвращает

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

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

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

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

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

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

Тип, по которому определено упорядочение.

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

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

Возвращает

значение в виде опции, содержащей наибольший элемент этой коллекции по отношению к упорядочению ord.

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

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

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

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

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

Тип, по которому определено упорядочение.

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

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

Возвращает

наименьший элемент этой коллекции по отношению к упорядочению ord.

Исключения
UnsupportedOperationException

если эта коллекция пуста.

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

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

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

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

class="attributes">
Параметры типа
B

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

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

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

f

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

Возвращает

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

Исключения
UnsupportedOperationException

если эта коллекция пуста.

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

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

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

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

class="attributes">
Параметры типа
B

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

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

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

f

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

Возвращает

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

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

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

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

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

class="attributes">
Параметры типа
B

Тип, по которому определяется порядок.

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

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

Возвращает

значение опциона, содержащего наименьший элемент этой коллекции по отношению к порядку ord.

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

Source@inline
final def mkString: String

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

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

class="attributes">
Возвращает

строковое представление этой коллекции. В результирующей строке строковые представления (с помощью метода toString) всех элементов этой коллекции следуют друг за другом без разделителя.

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

Source@inline
final def mkString(sep: String): String

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

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

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

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

Возвращает

строковое представление этого набора. В результирующей строке строковые представления (относительно метода toString) всех элементов этого набора разделены строкой sep.

Пример

List(1, 2, 3).mkString("|") = "1|2|3"

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

Источник
final def mkString(start: String, sep: String, end: String): String

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

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

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

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

sep

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

start

начальная строка.

Возвращает

строковое представление этого набора. Результирующая строка начинается со строки start и заканчивается строкой end. Внутри строковые представления (относительно метода toString) всех элементов этого набора разделены строкой sep.

Пример

List(1, 2, 3).mkString("(", "; ", ")") = "(1; 2; 3)"

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

Источник
def next(): Char

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

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

Источник
def nextOption(): Option[Char]

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

Возвращает

Some(next) если следующий элемент существует, None в противном случае.

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

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

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

Возвращает

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

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

Источник
def padTo[B >: Char](len: Int, elem: B): Iterator[B]

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

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

тип элемента возвращаемого итератора.

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

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

len

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

Возвращает

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

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

Источник
def partition(p: Char => Boolean): (Iterator[Char], Iterator[Char])

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

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

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

Возвращает

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

Примечание

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

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

Исходный код
def patch[B >: Char](from: Int, patchElems: Iterator[B], replaced: Int): Iterator[B]

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

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

Начальный индекс для замены

patchElems

Итератор значений замены

replaced

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

Примечание

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

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

Исходный код
def pos: Int

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

Исходный код
def product[B >: Char](implicit num: Numeric[B]): B

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

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

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

тип результата оператора *.

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

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

Возвращает

произведение всех элементов этой коллекции относительно оператора * в num.

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

Исходный код
def reduce[B >: Char](op: (B, B) => B): B

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

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

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

параметр типа для бинарного оператора, являющийся супертипом A.

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

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

Возвращает

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

Исключения
UnsupportedOperationException

если эта коллекция пуста.

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

Исходный код
def reduceLeft[B >: Char](op: (B, Char) => B): B

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

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

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

Тип параметров
B

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

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

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

Возвращает

результат вставки op между последовательными элементами этого набора, слева направо: op( op( ... op(x1, x2) ..., xn-1), xn) где x1, ..., xn — элементы этого набора.

Выбрасывает
UnsupportedOperationException

если этот набор пуст.

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

Исходный код
def reduceLeftOption[B >: Char](op: (B, Char) => B): Option[B]

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

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

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

Тип параметров
B

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

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

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

Возвращает

значение-опцию, содержащую результат reduceLeft(op) если этот набор не пуст, None в противном случае.

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

Исходный код
def reduceOption[B >: Char](op: (B, B) => B): Option[B]

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

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

Тип параметров
B

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

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

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

Возвращает

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

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

Исходный код
def reduceRight[B >: Char](op: (Char, B) => B): B

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

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

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

Тип параметров
B

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

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

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

Возвращает

результат вставки op между последовательными элементами этого набора, справа налево: op(x1, op(x2, ..., op(xn-1, xn)...)) где x1, ..., xn — элементы этого набора.

Выбрасывает
UnsupportedOperationException

если этот набор пуст.

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

Исходный код
def reduceRightOption[B >: Char](op: (Char, B) => B): Option[B]

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

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

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

Тип параметров
B

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

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

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

Возвращает

значение-опцию, содержащую результат reduceRight(op) если этот набор не пуст, None в противном случае.

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

Исходный код
def report(pos: Int, msg: String, out: PrintStream): Unit

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

сообщение об ошибке для отчета

out

PrintStream для использования

pos

позиция источника (строка/столбец)

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

Исходный код
def reportError(pos: Int, msg: String, out: PrintStream): Unit

Сообщает сообщение об ошибке в поток вывода out.

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

сообщение об ошибке для отчета

out

PrintStream для использования (необязательно: по умолчанию Console.err)

pos

позиция источника (строка/столбец)

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

Исходный код
def reportWarning(pos: Int, msg: String, out: PrintStream): Unit

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

сообщение об ошибке для отчета

out

PrintStream для использования (необязательно: по умолчанию Console.out)

pos

позиция источника (строка/столбец)

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

Исходный код
def reset(): Source

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

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

Исходный код
protected def reversed: Iterable[Char]

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

Исходный код
def sameElements[B >: Char](that: IterableOnce[B]): Boolean

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

Тип параметров
B

тип элементов набора that.

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

набор для сравнения

Возвращает

true если оба набора содержат одинаковые элементы в том же порядке, false в противном случае. <ошибка в анотации inheritdoc>

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

Исходный код
def scanLeft[B](z: B)(op: (B, Char) => B): Iterator[B]

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

Исходный код
def size: Int

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

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

Возвращает

количество элементов в этом наборе.

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

Источник
def slice(from: Int, until: Int): Iterator[Char]

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

Источник
def sliding[B >: Char](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
Параметры значения
size

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

step

расстояние между первыми элементами последовательных групп

Возвращает

А GroupedIterator генерирующий Seq[B] с размером size, за исключением последнего элемента (который может быть единственным), который будет усечен, если оставшихся элементов для группировки меньше, чем size. Это поведение можно настроить.

Примечание

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

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

Источник
def span(p: Char => Boolean): (Iterator[Char], Iterator[Char])

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

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

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

Примечание

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

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

Источник
def splitAt(n: Int): (Iterator[Char], Iterator[Char])

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

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

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

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

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

Возвращает

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

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

Источник
def stepper[S <: Stepper[_]](implicit shape: StepperShape[Char, 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. Для Steppers, помеченных scala.collection.Stepper.EfficientSplit, преобразователи в scala.jdk.StreamConverters позволяют создавать параллельные потоки, в то время как обычные Steppers можно преобразовывать только в последовательные потоки.

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

Источник
def sum[B >: Char](implicit num: Numeric[B]): B

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

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

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

тип результата оператора +.

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

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

Возвращает

сумма всех элементов этой коллекции по отношению к оператору + в num.

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

Источник
def take(n: Int): Iterator[Char]

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

Источник
def takeWhile(p: Char => Boolean): Iterator[Char]

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

Источник
override def tapEach[U](f: Char => U): Iterator[Char]

Классы определений Iterator -> IterableOnceOps
Унаследовано от Iterator

Источник
def to[C1](factory: Factory[Char, C1]): C1

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

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

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

Источник
def toArray[B >: Char : ClassTag]: Array[B]

Преобразовать коллекцию в массив.

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

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

Исходный код@inline
final def toBuffer[B >: Символ]: Буфер[B]

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

Исходный код
def toIndexedSeq: Индексированная последовательность[Символ]

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

Исходный код
def toList: Список[Символ]

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

Исходный код
def toMap[K, V](implicit ev: Символ <:< (K, V)): Карта[K, V]

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

Исходный код
def toSeq: Последовательность[Символ]

Возвращает

Это коллекция в виде Seq[A]. Это эквивалентно to(Seq), но может быть быстрее.

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

Исходный код
def toSet[B >: Символ]: Множество[B]

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

Исходный код
override def toString: String

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

Возвращает

"<iterator>"

Примечание

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

Классы определений Iterator -> Any
Унаследовано от Iterator

Исходный код
def toVector: Вектор[Символ]

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

Исходный код
def withClose(f: () => Единица): BufferedSource

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

Исходный код
def withDescription(text: Строка): BufferedSource

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

Исходный код
def withFilter(p: Символ => Булево): Итератор[Символ]

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

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

Параметры
p

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

Возвращает

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

Примечание

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

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

Исходный код
def withPositioning(pos: Positioner): BufferedSource

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

Исходный код
def withPositioning(on: Булево): BufferedSource

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

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

Исходный код
def withReset(f: () => Source): BufferedSource

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

Исходный код
def zip[B](that: IterableOnce[B]): Итератор[(Символ, B)]

Унаследовано от Итератор

Исходный код
def zipAll[A1 >: Символ, B](that: IterableOnce[B], thisElem: A1, thatElem: B): Итератор[(A1, B)]

Унаследовано от Итератор

Исходный код
def zipWithIndex: Итератор[(Символ, Целое число)]

Унаследовано от Итератор

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

Исходный код
override val iter: Итератор[Символ]

Унаследованные поля

Исходный код
var descr: Строка

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

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

Исходный код
var nerrors: Целое число

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

Исходный код
var nwarnings: Целое число

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

Неявные значения

Исходный код
implicit val codec: Кодек

© 2002-2022 EPFL, with contributions from Lightbend.
Licensed under the Apache License, Version 2.0.
https://scala-lang.org/api/3.1.1/scala/io/BufferedSource.html

Spec-Zone.ru

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