Spec-Zone.ru › Scala 2.13 Library

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

класс MatchIterator extends AbstractIterator[String] with Iterator[String] with MatchData

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

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

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

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

Тип объекта
MatchIterator
Источник
Regex.scala
См. также

java.util.regex.Matcher

Линейные супертипы
MatchData, AbstractIterator[String], collection.Iterator[String], IterableOnceOps[String, collection.Iterator, collection.Iterator[String]], collection.IterableOnce[String], AnyRef, Any

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

новый MatchIterator(source: CharSequence, regex: Regex, groupNames: Seq[String])

Типы членов

класс GroupedIterator[B >: A] extends AbstractIterator[immutable.Seq[B]]

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

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

Определяющие классы
Iterator

Члены-значения

final def !=(arg0: Any): Boolean

Проверка двух объектов на неравенство.

возвращает

true если !(this == that), иначе false.

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

final def ##(): Int

Эквивалентно x.hashCode за исключением упакованных числовых типов и null. Для числовых типов возвращает значение хэша, согласованное с равенством значений: если два экземпляра типа значения сравниваются как true, то ## вернёт одно и то же значение хэша для каждого из них. Для null возвращает хэш-код, где null.hashCode вызывает NullPointerException.

возвращает

значение хэша, согласованное с ==

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

def +(other: String): String

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

final def ++[B >: String](xs: => collection.IterableOnce[B]): collection.Iterator[B]

Классы-определения
Iterator
Аннотации
@inline()

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

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

final def ==(arg0: Any): Boolean

Выражение x == that эквивалентно if (x eq null) that eq null else x.equals(that).

возвращает

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

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

final def addString(b: collection.mutable.StringBuilder): collection.mutable.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: collection.mutable.StringBuilder, sep: String): collection.mutable.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
Аннотации
@inline()

def addString(b: collection.mutable.StringBuilder, start: String, sep: String, end: String): collection.mutable.StringBuilder

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

Пример:

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

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

scala> a.addString(b , "List(" , ", " , ")")
res5: StringBuilder = List(1, 2, 3, 4)
b

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

start

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

sep

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

end

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

returns

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

Definition Classes
IterableOnceOps

def after(i: Int): CharSequence

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

Definition Classes
MatchData

def after: CharSequence

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

Definition Classes
MatchData

final def asInstanceOf[T0]: T0

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

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

returns

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

Definition Classes
Any
Exceptions thrown

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

def before(i: Int): CharSequence

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

Definition Classes
MatchData

def before: CharSequence

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

Definition Classes
MatchData

def buffered: collection.BufferedIterator[String]

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

returns

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

Definition Classes
Iterator
Note

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

See also

scala.collection.BufferedIterator

def clone(): AnyRef

Создаёт копию получаемого объекта.

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

returns

копия получаемого объекта.

Attributes
protected[java.lang]
Definition Classes
AnyRef
Annotations
@throws(classOf[java.lang.CloneNotSupportedException]) @native()
Note

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

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

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

B

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

pf

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

returns

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

Definition Classes
Iterator → IterableOnceOps
Note

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

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

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

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

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

pf

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

returns

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

Definition Classes
IterableOnceOps
Пример:

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

def concat[B >: String](xs: => collection.IterableOnce[B]): collection.Iterator[B]

Definition Classes
Iterator

def contains(elem: Any): Boolean

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

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

elem

элемент для проверки.

returns

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

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

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

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

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

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

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

B

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

xs

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

start

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

len

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

returns

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

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

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

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

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

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

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

B

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

xs

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

start

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

returns

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

Definition Classes
IterableOnceOps

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

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

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

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

B

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

xs

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

returns

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

Definition Classes
IterableOnceOps

def corresponds[B](that: collection.IterableOnce[B])(p: (String, B) => Boolean): Boolean

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

B

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

that

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

p

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

returns

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

Definition Classes
IterableOnceOps

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

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

p

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

returns

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

Definition Classes
IterableOnceOps

def distinct: collection.Iterator[String]

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

returns

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

Definition Classes
Iterator
Note

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

def distinctBy[B](f: (String) => B): collection.Iterator[String]

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

B

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

f

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

returns

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

Definition Classes
Iterator
Note

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

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

Выбирает все элементы, кроме первых n.

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

n

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

returns

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

Definition Classes
Iterator → IterableOnceOps
Note

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

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

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

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

p

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

returns

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

Definition Classes
Iterator → IterableOnceOps
Note

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

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

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

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

returns

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

Definition Classes
Iterator
Note

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

,

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

def end(i: Int): Int

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

Definition Classes
MatchIterator → MatchData

def end: Int

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

Definition Classes
MatchIterator → MatchData

def ensuring(cond: (MatchIterator) => Boolean, msg: => Any): MatchIterator

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

def ensuring(cond: (MatchIterator) => Boolean): MatchIterator

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

def ensuring(cond: Boolean, msg: => Any): MatchIterator

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

def ensuring(cond: Boolean): MatchIterator

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

final def eq(arg0: AnyRef): Boolean

Проверяет, является ли аргумент (that) ссылкой на объект-приёмник (this).

Метод eq реализует отношение эквивалентности на непустых экземплярах AnyRef, и имеет три дополнительных свойства:

    Он согласован: для любых непустых экземпляров x и y типа AnyRef, многократные вызовы x.eq(y) последовательно возвращают true или последовательно возвращают false. Для любого непустого экземпляра x типа AnyRef, x.eq(null) и null.eq(x) возвращают false. null.eq(null) возвращает true.

При переопределении методов equals или hashCode важно гарантировать, что их поведение согласуется с равенством ссылок. Поэтому, если два объекта являются ссылками друг на друга (o1 eq o2), они должны быть равны друг другу (o1 == o2) и они должны хэшироваться к одному значению (o1.hashCode == o2.hashCode).

returns

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

Definition Classes
AnyRef

def equals(arg0: AnyRef): Boolean

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

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

returns

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

Definition Classes
AnyRef → Any

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

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

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

p

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

returns

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

Definition Classes
IterableOnceOps

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

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

p

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

returns

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

Definition Classes
Iterator → IterableOnceOps

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

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

returns

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

Definition Classes
Iterator → IterableOnceOps

def finalize(): Unit

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

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

Attributes
protected[java.lang]
Definition Classes
AnyRef
Annotations
@throws(classOf[java.lang.Throwable])
Note

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

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

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

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

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

p

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

returns

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

Definition Classes
IterableOnceOps

def flatMap[B](f: (String) => collection.IterableOnce[B]): collection.Iterator[B]

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

Например:

def getWords(lines: Seq[String]): Seq[String] = lines flatMap (line => line split "\\W+")

Тип результирующей коллекции определяется статическим типом итератора. Это иногда может привести к неожиданным результатам. Например:

// lettersOf will return a Seq[Char] of likely repeated letters, instead of a Set
def lettersOf(words: Seq[String]) = words flatMap (word => word.toSet)

// lettersOf will return a Set[Char], not a Seq
def lettersOf(words: Seq[String]) = words.toSet flatMap ((word: String) => word.toSeq)

// xs will be an Iterable[Int]
val xs = Map("a" -> List(11,111), "b" -> List(22,222)).flatMap(_._2)

// ys will be a Map[Int, Int]
val ys = Map("a" -> List(1 -> 11,1 -> 111), "b" -> List(2 -> 22,2 -> 222)).flatMap(_._2)
B

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

f

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

returns

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

Definition Classes
Iterator → IterableOnceOps
Note

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

def flatten[B](implicit ev: (String) => collection.IterableOnce[B]): collection.Iterator[B]

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

Тип результирующей коллекции определяется типом итератора. Например:

val xs = List(
           Set(1, 2, 3),
           Set(1, 2, 3)
         ).flatten
// xs == List(1, 2, 3, 1, 2, 3)

val ys = Set(
           List(1, 2, 3),
           List(3, 2, 1)
         ).flatten
// ys == Set(1, 2, 3)
B

тип элементов каждой коллекции.

returns

новый итератор, полученный путём конкатенации всех итераторов элементов.

Definition Classes
Iterator → IterableOnceOps
Note

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

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

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

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

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

A1

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

z

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

op

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

returns

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

Definition Classes
IterableOnceOps

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

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

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

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

B

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

z

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

op

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

returns

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

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

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

Definition Classes
IterableOnceOps

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

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

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

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

B

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

z

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

op

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

returns

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

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

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

Definition Classes
IterableOnceOps

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

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

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

p

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

returns

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

Definition Classes
IterableOnceOps

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

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

Definition Classes
IterableOnceOps

def formatted(fmtstr: String): String

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

Implicit
Этот член добавлен неявным преобразованием из MatchIterator в StringFormat[MatchIterator] через метод StringFormat в scala.Predef.
Definition Classes
StringFormat
Annotations
@inline()

final def getClass(): Class[_ <: AnyRef]

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

returns

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

Definition Classes
AnyRef → Any
Annotations
@native()

def group(id: String): String

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

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

id

Имя группы

returns

Запрошенная группа

Definition Classes
MatchData
Исключения

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

def group(i: Int): String

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

Definition Classes
MatchData

def groupCount: Int

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

Definition Classes
MatchIterator → MatchData

val groupNames: Seq[String]

Имена групп, или пустой список, если они не определены.

Definition Classes
MatchIterator → 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
Definition Classes
Iterator
Примечание

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

def hasNext: Boolean

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

returns

true если следующий элемент существует, false в противном случае

Definition Classes
MatchIterator → Iterator

def hashCode(): Int

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

returns

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

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

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

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

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

elem

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

from

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

returns

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

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

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

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

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

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

elem

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

returns

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

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

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

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

Definition Classes
Iterator

def isEmpty: Boolean

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

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

returns

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

Definition Classes
Iterator → IterableOnceOps
Annotations
@deprecatedOverriding("isEmpty is defined as !hasNext; override hasNext instead", "2.13.0")

final def isInstanceOf[T0]: Boolean

Проверка, является ли динамический тип объекта-получателя T0.

Обратите внимание, что результат проверки зависит от правил стирания типов Scala. Следовательно, выражение 1.isInstanceOf[String] вернёт false, а выражение List(1).isInstanceOf[List[String]] вернёт true. В последнем примере, поскольку тип аргумента стирается во время компиляции, проверить, содержатся ли элементы списка указанного типа, невозможно.

returns

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

Definition Classes
Any

def isTraversableAgain: Boolean

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

returns

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

Definition Classes
IterableOnceOps

final def iterator: collection.Iterator[String]

Итератор может быть использован только один раз

Definition Classes
Iterator → IterableOnce
Annotations
@inline()

def knownSize: Int

returns

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

Definition Classes
IterableOnce

final def length: Int

Definition Classes
Iterator
Annotations
@inline()

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

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

B

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

f

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

returns

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

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

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

def matchData: Iterator[Match]

def matched: String

Совпавший строковый шаблон или null при отсутствии совпадения.

Definition Classes
MatchData

val matcher: Matcher

В основном, оборачивает платформенный Matcher.

Attributes
protected[scala.util.matching.Regex]
Definition Classes
MatchIterator → MatchData

def max[B >: String](implicit ord: math.Ordering[B]): String

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

B

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

ord

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

returns

наибольший элемент данного множества относительно упорядочения ord.

Definition Classes
IterableOnceOps
Исключения

UnsupportedOperationException, если множество пусто.

def maxBy[B](f: (String) => B)(implicit cmp: math.Ordering[B]): String

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

B

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

f

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

cmp

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

returns

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

Definition Classes
IterableOnceOps
Exceptions thrown

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

def maxByOption[B](f: (String) => B)(implicit cmp: math.Ordering[B]): Option[String]

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

B

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

f

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

cmp

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

returns

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

Definition Classes
IterableOnceOps

def maxOption[B >: String](implicit ord: math.Ordering[B]): Option[String]

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

B

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

ord

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

returns

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

Definition Classes
IterableOnceOps

def min[B >: String](implicit ord: math.Ordering[B]): String

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

B

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

ord

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

returns

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

Definition Classes
IterableOnceOps
Exceptions thrown

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

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

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

B

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

f

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

cmp

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

returns

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

Definition Classes
IterableOnceOps
Exceptions thrown

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

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

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

B

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

f

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

cmp

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

returns

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

Definition Classes
IterableOnceOps

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

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

B

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

ord

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

returns

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

Определяющие классы
IterableOnceOps

final def mkString: String

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

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

returns

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

Определяющие классы
IterableOnceOps
Аннотации
@inline()

final def mkString(sep: String): String

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

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

sep

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

returns

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

Определяющие классы
IterableOnceOps
Аннотации
@inline()
Example:

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

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

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

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

start

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

sep

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

end

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

returns

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

Определяющие классы
IterableOnceOps
Example:

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

final def ne(arg0: AnyRef): Boolean

Эквивалентно !(this eq that).

returns

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

Определяющие классы
AnyRef

def next(): String

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

returns

следующий элемент.

Определяющие классы
MatchIterator → Iterator

def nextOption(): Option[String]

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

returns

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

Определяющие классы
Iterator

def nonEmpty: Boolean

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

returns

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

Определяющие классы
IterableOnceOps
Аннотации
@deprecatedOverriding("nonEmpty is defined as !isEmpty; override isEmpty instead", "2.13.0")

final def notify(): Unit

Будит один поток, ожидающий на мониторе принимающего объекта.

Определяющие классы
AnyRef
Аннотации
@native()
Примечание

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

final def notifyAll(): Unit

Разбуждает все потоки, ожидающие монитора объекта-получателя.

Классы определения
AnyRef
Аннотации
@native()
Примечание

не указано SLS в качестве члена AnyRef

def padTo[B >: String](len: Int, elem: B): collection.Iterator[B]

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

B

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

len

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

elem

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

возвращает

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

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

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

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

p

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

возвращает

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

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

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

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

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

from

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

patchElems

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

replaced

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

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

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

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

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

B

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

num

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

возвращает

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

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

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

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

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

B

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

op

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

возвращает

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

Классы определения
IterableOnceOps
Исключения

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

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

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

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

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

B

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

op

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

returns

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

op( op( ... op(x_1, x_2) ..., x_{n-1}), x_n)

где x1, ..., xn — элементы этой коллекции.

Определяющие классы
IterableOnceOps
Выбрасываемые исключения

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

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

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

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

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

B

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

op

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

returns

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

Определяющие классы
IterableOnceOps

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

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

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

B

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

op

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

returns

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

Определяющие классы
IterableOnceOps

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

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

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

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

B

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

op

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

returns

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

op(x_1, op(x_2, ..., op(x_{n-1}, x_n)...))

где x1, ..., xn — элементы этой коллекции.

Определяющие классы
IterableOnceOps
Выбрасываемые исключения

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

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

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

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

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

B

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

op

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

returns

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

Определяющие классы
IterableOnceOps

val regex: Regex

def reversed: collection.Iterable[String]

Атрибуты
protected
Определяющие классы
IterableOnceOps

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

Определяющие классы
Iterator

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

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

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

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

B

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

z

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

op

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

returns

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

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

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

def size: Int

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

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

returns

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

Определяющие классы
IterableOnceOps

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

Выбирает интервал элементов. Возвращаемый итератор состоит из всех элементов x которые удовлетворяют инварианту:

from <= indexOf(x) < until

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

from

наименьший индекс для включения из этого итератора.

until

наименьший индекс для ИСКЛЮЧЕНИЯ из этого итератора.

returns

итератор, содержащий элементы больше или равные индексу from до (но не включая) индекс until этого итератора.

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

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

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

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

Атрибуты
protected
Определяющие классы
Iterator

def sliding[B >: String](size: Int, step: Int = 1): GroupedIterator[B]

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

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

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

// Returns List(List(1, 2, 3), List(2, 3, 4), List(3, 4, 5))
(1 to 5).iterator.sliding(3).toList
// Returns List(List(1, 2, 3, 4), List(4, 5))
(1 to 5).iterator.sliding(4, 3).toList
// Returns List(List(1, 2, 3, 4))
(1 to 5).iterator.sliding(4, 3).withPartial(false).toList
// Returns List(List(1, 2, 3, 4), List(4, 5, 20, 25))
// Illustrating that withPadding's argument is by-name.
val it2 = Iterator.iterate(20)(_ + 5)
(1 to 5).iterator.sliding(4, 3).withPadding(it2.next).toList
returns

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

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

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

val source: CharSequence

Источник, из которого произошло совпадение

Определяющие классы
MatchIterator → MatchData

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

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

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

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

p

тестовый предикат

returns

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

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

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

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

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

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

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

n

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

returns

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

Definition Classes
IterableOnceOps
Note

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

def start(i: Int): Int

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

Definition Classes
MatchIterator → MatchData

def start: Int

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

Definition Classes
MatchIterator → MatchData

def stepper[S <: Stepper[_]](implicit shape: StepperShape[String, S]): S

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

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

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

    Для коллекций Int, Short, Byte или Char, возвращается IntStepperДля коллекций Double или Float, возвращается DoubleStepperДля коллекций Long, возвращается LongStepperДля любого другого типа элементов, возвращается AnyStepper

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

Definition Classes
IterableOnce

def subgroups: List[String]

Все группирующие группы, т.е. не включая group(0).

Definition Classes
MatchData

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

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

B

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

num

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

returns

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

Definition Classes
IterableOnceOps

final def synchronized[T0](arg0: => T0): T0

Definition Classes
AnyRef

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

Выбирает первые n элементов.

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

n

количество элементов, которые нужно взять из этого итератора.

returns

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

Definition Classes
Iterator → IterableOnceOps
Note

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

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

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

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

p

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

returns

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

Definition Classes
Iterator → IterableOnceOps
Note

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

def tapEach[U](f: (String) => U): collection.Iterator[String]

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

U

тип возвращаемого значения f

f

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

returns

Такая же логическая коллекция, как и эта

Definition Classes
Iterator → IterableOnceOps

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

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

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

Definition Classes
IterableOnceOps

def toArray[B >: String](implicit arg0: ClassTag[B]): Array[B]

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

Definition Classes
IterableOnceOps

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

Definition Classes
IterableOnceOps
Annotations
@inline()

def toIndexedSeq: collection.immutable.IndexedSeq[String]

Definition Classes
IterableOnceOps

def toList: collection.immutable.List[String]

Definition Classes
IterableOnceOps

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

Definition Classes
IterableOnceOps

def toSeq: collection.immutable.Seq[String]

возвращает

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

Классы определений
IterableOnceOps

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

Классы определений
IterableOnceOps

def toString(): String

Отчёт об пустоте.

возвращает

строковое представление объекта.

Классы определений
MatchIterator → MatchData → Iterator → AnyRef → Any

def toVector: collection.immutable.Vector[String]

Классы определений
IterableOnceOps

final def wait(): Unit

Классы определений
AnyRef
Аннотации
@throws(classOf[java.lang.InterruptedException])

final def wait(arg0: Long, arg1: Int): Unit

Классы определений
AnyRef
Аннотации
@throws(classOf[java.lang.InterruptedException])

final def wait(arg0: Long): Unit

Классы определений
AnyRef
Аннотации
@throws(classOf[java.lang.InterruptedException]) @native()

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

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

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

p

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

возвращает

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

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

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

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

Классы определений
Iterator

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

Классы определений
Iterator

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

Комбинирует этот итератор со своими индексами.

возвращает

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

Классы определений
Iterator → IterableOnceOps
Пример:

    List("a", "b", "c").zipWithIndex == List(("a", 0), ("b", 1), ("c", 2))

Примечание

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

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

Spec-Zone.ru

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