Spec-Zone.ru › Scala 3.1

Класс scala.util.matching.MatchIterator

Исходный код

class MatchIterator(val source: CharSequence, val regex: Regex, val _groupNames: Seq[String]) extends AbstractIterator[String] with Iterator[String] with MatchData

Класс для итерации по последовательности совпадений с регулярным выражением.

Это итератор, возвращающий совпавшие строки.

Запросы о данных совпадения относятся к текущему состоянию внутреннего совпадающего объекта, который продвигает вызов hasNext или next.

Когда совпадения исчерпаны, запросы о данных совпадения приведут к исключению java.lang.IllegalStateException.

См. также

java.util.regex.Matcher

Супертипы
Трейт MatchData
Класс AbstractIterator[String]
Трейт Iterator[String]
Трейт IterableOnceOps[String, Iterator, Iterator[String]]
Трейт IterableOnce[String]
Класс Object
Трейт Matchable
Класс Any
Тип самого себя
MatchIterator

Наследуемые классы

Исходный код
class GroupedIterator[B >: A](self: Iterator[B], size: Int, step: Int) extends AbstractIterator[Seq[B]]

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

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

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

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

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

Индекс последнего совпавшего символа.

Исходный код
def end(i: Int): Int

Индекс, следующий за последним совпавшим символом в группе i.

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

Количество подгрупп.

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

Возвращает true, если next найдёт совпадение. В качестве побочного эффекта, если необходимо, продвигает внутренний совпадающий объект; запросы о текущих данных совпадения относятся к внутреннему совпадающему объекту.

Исходный код
def matchData: Iterator[Match]

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

Исходный код
def next(): String

Следующая совпавшая подстрока source. В качестве побочного эффекта, если необходимо, продвигает внутренний совпадающий объект.

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

Индекс первого совпавшего символа.

Исходный код
def start(i: Int): Int

Индекс первого совпавшего символа в группе i.

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

Сообщает об отсутствии элементов.

Определяющие классы MatchData -> Iterator -> Any

Наследуемые методы

Исходный код@inline
final def ++[B >: String](xs: => IterableOnce[B]): Iterator[B]

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

Исходный код@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
Параметры значения
b

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

Возвращает

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

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

Исходный код@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
Параметры значения
b

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

sep

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

Возвращает

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

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

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

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

end

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

sep

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

start

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

Возвращает

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

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

Исходный код
def after(i: Int): CharSequence

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

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

Исходный код
def after: CharSequence

Возвращает последовательность символов после последнего символа совпадения, или null , если ничего не было найдено.

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

Исходный код
def before(i: Int): CharSequence

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

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

Исходный код
def before: CharSequence

Последовательность символов перед первым символом совпадения, или null , если ничего не было найдено.

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

Исходный код
def buffered: BufferedIterator[String]

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

Возвращает

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

См. также

scala.collection.BufferedIterator

Примечание

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

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

Исходный код
def collect[B](pf: PartialFunction[String, B]): Iterator[B]

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

Исходный код
def collectFirst[B](pf: PartialFunction[String, B]): Option[B]

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

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

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

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

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

Возвращает

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

Пример

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

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

Исходный код
def concat[B >: String](xs: => IterableOnce[B]): Iterator[B]

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

Исходный код
def contains(elem: Any): Boolean

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

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

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

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

Возвращает

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

Примечание

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

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

Исходный код
def copyToArray[B >: String](xs: Array[B], start: Int, len: Int): Int

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

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

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

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

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

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

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

start

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

xs

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

Возвращает

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

Примечание

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

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

Исходный код@deprecatedOverriding("This should always forward to the 3-arg version of this method", since = "2.13.4")
def copyToArray[B >: String](xs: Array[B], start: Int): Int

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

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

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

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

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

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

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

xs

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

Возвращает

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

Примечание

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

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

Исходный код@deprecatedOverriding("This should always forward to the 3-arg version of this method", since = "2.13.4")
def copyToArray[B >: String](xs: Array[B]): Int

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

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

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

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

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

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

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

Возвращает

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

Примечание

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

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

Источник
def corresponds[B](that: IterableOnce[B])(p: (String, B) => Boolean): Boolean

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

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

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

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

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

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

that

другой набор

Возвращает

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

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

Источник
def count(p: String => Boolean): Int

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

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

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

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

Возвращает

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

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

Источник
def distinct: Iterator[String]

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

Возвращает

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

Примечание

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

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

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

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

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

тип элементов после преобразования f

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

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

Возвращает

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

Примечание

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

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

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

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

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

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

Источник
def duplicate: (Iterator[String], Iterator[String])

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

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

Возвращает

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

Примечание

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

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

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

Источник
def exists(p: String => Boolean): Boolean

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

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

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

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

Возвращает

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

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

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

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

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

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

Источник
def find(p: String => Boolean): Option[String]

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

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

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

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

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

Возвращает

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

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

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

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

Исходный код
def flatten[B](implicit ev: String => IterableOnce[B]): Iterator[B]

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

Исходный код
def fold[A1 >: String](z: A1)(op: (A1, A1) => A1): A1

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

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

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

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

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

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

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

z

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

Возвращаемое значение

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

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

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

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

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

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

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

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

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

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

z

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

Возвращаемое значение

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

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

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

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

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

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

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

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

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

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

z

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

Возвращаемое значение

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

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

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

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

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

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

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

Возвращаемое значение

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

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

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

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

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

Исходный код
def group(id: String): String

Возвращает группу с заданным именем.

Использует явные имена групп при их предоставлении; в противном случае запрашивает у базовой реализации имена встроенных именованных групп. Не все платформы поддерживают встроенные именованные группы.

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

Имя группы

Возвращаемое значение

Запрашиваемая группа

Исключения
IllegalArgumentException

если запрашиваемого имени группы не определено

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

Исходный код
def group(i: Int): String

Совпавший строковый фрагмент в группе i, или null если ничего не совпало.

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

Исходный код
def grouped[B >: String](size: Int): GroupedIterator[B]

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

// Returns List(List(1, 2, 3), List(4, 5, 6), List(7)))
(1 to 7).iterator.grouped(3).toList
// Returns List(List(1, 2, 3), List(4, 5, 6))
(1 to 7).iterator.grouped(3).withPartial(false).toList
// Returns List(List(1, 2, 3), List(4, 5, 6), List(7, 20, 25)
// Illustrating that withPadding's argument is by-name.
val it2 = Iterator.iterate(20)(_ + 5)
(1 to 7).iterator.grouped(3).withPadding(it2.next).toList
Примечание

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

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

Исходный код
def indexOf[B >: String](elem: B, from: Int): Int

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

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

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

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

from

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

Возвращаемое значение

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

Примечание

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

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

Исходный код
def indexOf[B >: String](elem: B): Int

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

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

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

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

Возвращает

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

Примечание

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

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

Источник
def indexWhere(p: String => 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[String]

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

Источник
def knownSize: Int

Возвращает

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

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

Источник@inline
final def length: Int

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

Источник
def map[B](f: String => B): Iterator[B]

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

Источник
def matched: String

Совпавший строка, или null если ничего не совпало.

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

Источник
def max[B >: String](implicit ord: Ordering[B]): String

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

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

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

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

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

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

Возвращает

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

Исключения
UnsupportedOperationException

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

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

Источник
def maxBy[B](f: String => B)(implicit cmp: Ordering[B]): String

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

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

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

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

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

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

f

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

Возвращает

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

Исключения
UnsupportedOperationException

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

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

Источник
def maxByOption[B](f: String => B)(implicit cmp: Ordering[B]): Option[String]

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

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

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

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

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

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

f

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

Возвращает

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

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

Источник
def maxOption[B >: String](implicit ord: Ordering[B]): Option[String]

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

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

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

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

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

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

Возвращает

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

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

Источник
def min[B >: String](implicit ord: Ordering[B]): String

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

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

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

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

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

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

Возвращает

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

Исключения
UnsupportedOperationException

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

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

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

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

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

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

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

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

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

f

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

Возвращает

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

Исключения
UnsupportedOperationException

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

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

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

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

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

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

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

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

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

f

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

Возвращает

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

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

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

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

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

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

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

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

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

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

sep

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

start

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

Возвращает

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

Пример

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

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

Исходный код
def nextOption(): Option[String]

Оборачивает значение 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 >: String](len: Int, elem: B): Iterator[B]

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

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

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

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

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

len

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

Возвращает

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

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

Исходный код
def partition(p: String => Boolean): (Iterator[String], Iterator[String])

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

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

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

Возвращает

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

Примечание

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

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

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

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

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

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

patchElems

Итератор значений патча

replaced

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

Примечание

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

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

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

Производит произведение элементов этой коллекции.

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

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

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

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

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

Возвращаемое значение

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

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

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

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

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

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

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

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

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

Возвращаемое значение

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

Исключения
UnsupportedOperationException

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

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

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

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

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

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

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

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

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

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

Возвращаемое значение

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

Исключения
UnsupportedOperationException

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

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

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

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

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

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

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

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

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

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

Возвращает

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

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

Источник
def reduceOption[B >: String](op: (B, B) => B): Option[B]

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

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

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

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

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

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

Возвращает

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

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

Источник
def reduceRight[B >: String](op: (String, B) => B): B

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

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

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

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

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

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

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

Возвращает

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

Исключения
UnsupportedOperationException

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

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

Источник
def reduceRightOption[B >: String](op: (String, B) => B): Option[B]

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

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

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

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

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

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

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

Возвращает

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

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

Источник
protected def reversed: Iterable[String]

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

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

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

Type parameters
B

тип элементов коллекции that.

Value parameters
that

коллекция для сравнения

Returns

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

Inherited from Iterator

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

Inherited from Iterator

Source
def size: Int

Размер этой коллекции.

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

Returns

количество элементов в этой коллекции.

Inherited from IterableOnceOps

Source
def slice(from: Int, until: Int): Iterator[String]

Inherited from Iterator

Source
def sliding[B >: String](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
Value parameters
size

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

step

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

Returns

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

Примечание

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

Inherited from Iterator

Source
def span(p: String => Boolean): (Iterator[String], Iterator[String])

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

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

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

Примечание

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

Inherited from Iterator

Source
def splitAt(n: Int): (Iterator[String], Iterator[String])

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

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

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

Value parameters
n

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

Returns

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

Inherited from IterableOnceOps

Source
def stepper[S <: Stepper[_]](implicit shape: StepperShape[String, 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 можно преобразовать только в последовательные потоки.

Inherited from IterableOnce

Source
def subgroups: List[String]

Все группы захвата, то есть не включая группу(0).

Inherited from MatchData

Source
def sum[B >: String](implicit num: Numeric[B]): B

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

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

Type parameters
B

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

Value parameters
num

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

Returns

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

Inherited from IterableOnceOps

Source
def take(n: Int): Iterator[String]

Inherited from Iterator

Source
def takeWhile(p: String => Boolean): Iterator[String]

Inherited from Iterator

Source
override def tapEach[U](f: String => U): Iterator[String]

Definition Classes Iterator -> IterableOnceOps
Inherited from Iterator

Source
def to[C1](factory: Factory[String, C1]): C1

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

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

Inherited from IterableOnceOps

Source
def toArray[B >: String : ClassTag]: Array[B]

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

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

Inherited from IterableOnceOps

Source@inline
final def toBuffer[B >: String]: Buffer[B]

Inherited from IterableOnceOps

Source
def toIndexedSeq: IndexedSeq[String]

Inherited from IterableOnceOps

Source
def toList: List[String]

Inherited from IterableOnceOps

Source
def toMap[K, V](implicit ev: String <:< (K, V)): Map[K, V]

Inherited from IterableOnceOps

Source
def toSeq: Seq[String]

Возвращает

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

Inherited from IterableOnceOps

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

Inherited from IterableOnceOps

Source
def toVector: Vector[String]

Inherited from IterableOnceOps

Source
def withFilter(p: String => Boolean): Iterator[String]

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

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

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

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

Возвращает

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

Примечание

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

Inherited from Iterator

Source
def zip[B](that: IterableOnce[B]): Iterator[(String, B)]

Inherited from Iterator

Source
def zipAll[A1 >: String, B](that: IterableOnce[B], thisElem: A1, thatElem: B): Iterator[(A1, B)]

Inherited from Iterator

Source
def zipWithIndex: Iterator[(String, Int)]

Inherited from Iterator

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

Source
val regex: Regex

Source
val source: CharSequence

© 2002-2022 EPFL, with contributions from Lightbend.
Licensed under the Apache License, Version 2.0.
https://scala-lang.org/api/3.1.1/scala/util/matching/Regex$$MatchIterator.html

Spec-Zone.ru

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