Spec-Zone.ru › Scala 2.12 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

Линейные супертипы

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

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

Типовые члены

класс GroupedIterator[B >: A] extends AbstractIterator[Seq[B]] with Iterator[Seq[B]]

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

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

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

Значения членов

final def !=(arg0: Any): Boolean

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

возвращает

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

Definition Classes
AnyRef → Any

final def ##(): Int

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

возвращает

значение хэша, соответствующее ==

Definition Classes
AnyRef → Any

def +(other: String): String

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

def ++(that: ⇒ collection.Iterator[String]): collection.Iterator[String]

[Случай использования]

Конкатенация этого итератора с другим.

that

другой итератор

возвращает

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

Definition Classes
Iterator
Полная подпись

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

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

def /:[B](z: B)(op: (B, String) ⇒ B): B

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

Примечание: /: — это альтернативная запись для foldLeft; z /: xs эквивалентно xs foldLeft z.

Примеры:

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

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

scala> val b = (5 /: a)(_+_)
b: Int = 15

scala> val c = (5 /: a)((x,y) => x + y)
c: Int = 15

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

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

B

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

z

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

op

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

возвращает

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

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

где x1, ..., xn — элементы этого перебираемого объекта или итератора.

Definition Classes
TraversableOnce → GenTraversableOnce

def :\[B](z: B)(op: (String, B) ⇒ B): B

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

Примечание: :\ — это альтернативная запись для foldRight; xs :\ z эквивалентно xs foldRight z.

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

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

Примеры:

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

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

scala> val b = (a :\ 5)(_+_)
b: Int = 15

scala> val c = (a :\ 5)((x,y) => x + y)
c: Int = 15
B

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

z

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

op

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

возвращает

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

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

где x1, ..., xn — элементы этого перебираемого объекта или итератора.

Definition Classes
TraversableOnce → GenTraversableOnce

final def ==(arg0: Any): Boolean

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

возвращает

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

Definition Classes
AnyRef → Any

def addString(b: StringBuilder): StringBuilder

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

Пример:

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

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

scala> val h = a.addString(b)
h: StringBuilder = 1234
b

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

returns

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

Definition Classes
TraversableOnce

def addString(b: StringBuilder, sep: String): StringBuilder

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

Пример:

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

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

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

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

sep

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

returns

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

Definition Classes
TraversableOnce

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

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

Пример:

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

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

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

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

start

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

sep

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

end

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

returns

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

Definition Classes
TraversableOnce

def after(i: Int): CharSequence

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

Definition Classes
MatchData

def after: CharSequence

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

Definition Classes
MatchData

def aggregate[B](z: ⇒ B)(seqop: (B, String) ⇒ B, combop: (B, B) ⇒ B): B

Агрегирует результаты применения оператора к последующим элементам.

Это более общий вид fold и reduce. Он похож на foldLeft в том, что результат не обязан быть супертипом типа элемента. Кроме того, он позволяет обрабатывать параллельные коллекции частями, а затем объединять промежуточные результаты.

aggregate разбивает итерируемый объект или итератор на разделы и обрабатывает каждый раздел последовательно, применяя seqop, начиная с z (как foldLeft). Эти промежуточные результаты затем объединяются с помощью combop (как fold). Реализация этой операции может работать с произвольным количеством разделов коллекции (даже с 1), поэтому combop может быть вызвана произвольное количество раз (даже 0).

В качестве примера рассмотрим суммирование целочисленных значений списка символов. Начальное значение суммы равно 0. Во-первых, seqop преобразует каждый входной символ в Int и добавляет его к сумме (раздела). Затем, combop просто нужно суммировать промежуточные результаты разделов:

List('a', 'b', 'c').aggregate(0)({ (sum, ch) => sum + ch.toInt }, { (p1, p2) => p1 + p2 })
B

тип накапливаемых результатов

z

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

seqop

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

combop

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

Definition Classes
TraversableOnce → GenTraversableOnce

final def asInstanceOf[T0]: T0

Приводит объект-получатель к типу T0.

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

returns

объект-получатель.

Definition Classes
Any
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[lang]
Definition Classes
AnyRef
Annotations
@throws( ... ) @native()
Note

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

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

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

pf

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

returns

новый итератор, который генерирует каждое значение x, произведённое этим итератором, для которого pf определена отображаемое pf(x).

Definition Classes
Iterator
Annotations
@migration
Migration

(Изменено в версии 2.8.0) collect изменился. Предыдущее поведение можно воспроизвести с помощью toSeq.

Note

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

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

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

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

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

pf

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

returns

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

Definition Classes
TraversableOnce
Пример:

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

def contains(elem: Any): Boolean

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

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

elem

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

returns

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

Definition Classes
Iterator
Note

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

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

[use case]

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

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

xs

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

start

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

len

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

Definition Classes
Iterator → TraversableOnce → GenTraversableOnce
Полная подпись

def copyToArray(xs: Array[A]): Unit

[use case]

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

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

xs

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

Definition Classes
TraversableOnce → GenTraversableOnce
Полная сигнатура

def copyToArray(xs: Array[A], start: Int): Unit

[use case]

Копирует элементы этого итерируемого объекта или итератора в массив. Заполняет заданный массив xs значениями этого итерируемого объекта или итератора, начиная с индекса start. Копирование прекращается, как только достигается конец текущего итерируемого объекта или итератора, или конец целевого массива.

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

xs

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

start

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

Definition Classes
TraversableOnce → GenTraversableOnce
Полная сигнатура

def copyToBuffer[B >: String](dest: Buffer[B]): Unit

Копирует все элементы этого итерируемого объекта или итератора в буфер.

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

dest

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

Definition Classes
TraversableOnce

def corresponds[B](that: GenTraversableOnce[B])(p: (String, B) ⇒ Boolean): Boolean

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

B

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

that

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

p

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

возвращает

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

Definition Classes
Iterator

def count(p: (String) ⇒ Boolean): Int

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

p

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

возвращает

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

Definition Classes
TraversableOnce → GenTraversableOnce

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

Перемещает этот итератор мимо первых n элементов или длины итератора, что меньше.

n

количество элементов для удаления

возвращает

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

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

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

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

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

p

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

возвращает

итератор, состоящий из оставшихся элементов

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

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

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

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

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

возвращает

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

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

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

,

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

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
This member is added by an implicit conversion from MatchIterator to Ensuring[MatchIterator] performed by method Ensuring in scala.Predef.
Definition Classes
Ensuring

def ensuring(cond: (MatchIterator) ⇒ Boolean): MatchIterator

Implicit
This member is added by an implicit conversion from MatchIterator to Ensuring[MatchIterator] performed by method Ensuring in scala.Predef.
Definition Classes
Ensuring

def ensuring(cond: Boolean, msg: ⇒ Any): MatchIterator

Implicit
This member is added by an implicit conversion from MatchIterator to Ensuring[MatchIterator] performed by method Ensuring in scala.Predef.
Definition Classes
Ensuring

def ensuring(cond: Boolean): MatchIterator

Implicit
This member is added by an implicit conversion from MatchIterator to Ensuring[MatchIterator] performed by method Ensuring in 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: Any): 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
Iterator → TraversableOnce → GenTraversableOnce
Note

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

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

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

p

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

returns

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

Definition Classes
Iterator
Note

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

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

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

p

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

returns

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

Definition Classes
Iterator
Note

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

def finalize(): Unit

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

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

Attributes
protected[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
Iterator → TraversableOnce → GenTraversableOnce
Note

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

def flatMap[B](f: (String) ⇒ GenTraversableOnce[B]): collection.Iterator[B]

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

f

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

returns

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

Definition Classes
Iterator
Note

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

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

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

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

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

A1

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

z

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

op

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

returns

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

Definition Classes
TraversableOnce → GenTraversableOnce

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

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

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

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

B

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

z

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

op

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

returns

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

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

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

Definition Classes
TraversableOnce → GenTraversableOnce

def foldRight[B](z: B)(op: (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
TraversableOnce → GenTraversableOnce

def forall(p: (String) ⇒ Boolean): Boolean

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

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

p

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

returns

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

Definition Classes
Iterator → TraversableOnce → GenTraversableOnce
Note

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

def foreach(f: (String) ⇒ Unit): Unit

[use case]

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

f

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

Definition Classes
Iterator → TraversableOnce → GenTraversableOnce
Полная сигнатура

def formatted(fmtstr: String): String

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

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

final def getClass(): Class[_]

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

returns

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

Definition Classes
AnyRef → Any
Аннотации
@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
Note

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

def hasDefiniteSize: Boolean

Проверяет, имеет ли этот итератор известный размер.

returns

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

Definition Classes
Iterator → TraversableOnce → GenTraversableOnce
Note

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

def hasNext: Boolean

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

returns

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

Definition Classes
MatchIterator → Iterator

def hashCode(): Int

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

returns

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

Definition Classes
AnyRef → Any
Annotations
@native()

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

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

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

elem

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

from

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

returns

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

Definition Classes
Iterator
Note

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

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

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

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

elem

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

returns

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

Definition Classes
Iterator
Note

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

def indexWhere(p: (String) ⇒ Boolean, from: Int): Int

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

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

p

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

from

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

returns

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

Definition Classes
Iterator
Note

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

def indexWhere(p: (String) ⇒ Boolean): Int

Возвращает индекс первого произведенного значения, удовлетворяющего предикату, или -1.

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

p

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

returns

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

Definition Classes
Iterator
Note

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

def isEmpty: Boolean

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

returns

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

Definition Classes
Iterator → TraversableOnce → GenTraversableOnce
Note

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

final def isInstanceOf[T0]: Boolean

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

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

returns

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

Definition Classes
Any

def isTraversableAgain: Boolean

Проверяет, можно ли повторно пройти по этому итератору.

returns

false

Definition Classes
Iterator → GenTraversableOnce
Note

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

def length: Int

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

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

Definition Classes
Iterator
Note

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

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

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

f

функция преобразования

returns

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

Definition Classes
Iterator
Note

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

def matchData: Iterator[Match]

def matched: String

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

Definition Classes
MatchData

val matcher: Matcher

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

Attributes
protected[Regex]
Definition Classes
MatchIterator → MatchData

def max: A

[use case]

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

returns

наибольший элемент этого перебираемого объекта или итератора.

Definition Classes
TraversableOnce → GenTraversableOnce
Полная подпись
Исключения

UnsupportedOperationException, если этот перебираемый объект или итератор пуст.

def maxBy[B](f: (A) ⇒ B): A

[use case]

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

B

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

f

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

returns

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

Definition Classes
TraversableOnce → GenTraversableOnce
Полная подпись
Исключения

UnsupportedOperationException, если этот перебираемый объект или итератор пуст.

def min: A

[use case]

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

returns

наименьший элемент этого перебираемого объекта или итератора

Definition Classes
TraversableOnce → GenTraversableOnce
Полная подпись
Исключения

UnsupportedOperationException, если этот перебираемый объект или итератор пуст.

def minBy[B](f: (A) ⇒ B): A

[use case]

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

B

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

f

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

returns

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

Definition Classes
TraversableOnce → GenTraversableOnce
Полная подпись
Исключения

UnsupportedOperationException, если этот перебираемый объект или итератор пуст.

def mkString: String

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

returns

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

Definition Classes
TraversableOnce → GenTraversableOnce

def mkString(sep: String): String

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

sep

разделитель.

returns

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

Definition Classes
TraversableOnce → GenTraversableOnce
Пример:

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

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

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

start

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

sep

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

end

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

returns

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

Definition Classes
TraversableOnce → GenTraversableOnce
Пример:

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

final def ne(arg0: AnyRef): Boolean

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

returns

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

Definition Classes
AnyRef

def next(): String

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

returns

следующий элемент этого итератора, если hasNext является true; в противном случае поведение не определено.

Definition Classes
MatchIterator → Iterator

def nonEmpty: Boolean

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

returns

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

Definition Classes
TraversableOnce → GenTraversableOnce

final def notify(): Unit

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

Definition Classes
AnyRef
Annotations
@native()
Note

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

final def notifyAll(): Unit

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

Definition Classes
AnyRef
Annotations
@native()
Note

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

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

[use case]

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

len

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

elem

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

returns

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

Definition Classes
Iterator
Полная сигнатура

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

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

p

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

returns

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

Definition Classes
Iterator
Note

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

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

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

from

Начальный индекс для патчинга

patchElems

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

replaced

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

Definition Classes
Iterator
Note

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

def product: A

[use case]

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

returns

произведение всех элементов в этой коллекции или итераторе чисел типа Int. Вместо Int, может быть использован любой другой тип T с неявной Numeric[T] реализацией, который может быть использован как тип элемента коллекции или итератора и как тип результата product. Примерами таких типов являются: Long, Float, Double, BigInt.

Definition Classes
TraversableOnce → GenTraversableOnce
Full Signature

def reduce[A1 >: String](op: (A1, A1) ⇒ A1): A1

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

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

A1

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

op

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

returns

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

Definition Classes
TraversableOnce → GenTraversableOnce
Exceptions thrown

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 - это элементы этой коллекции или итератора.

Definition Classes
TraversableOnce
Exceptions thrown

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

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

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

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

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

B

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

op

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

returns

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

Definition Classes
TraversableOnce → GenTraversableOnce

def reduceOption[A1 >: String](op: (A1, A1) ⇒ A1): Option[A1]

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

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

A1

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

op

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

returns

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

Definition Classes
TraversableOnce → GenTraversableOnce

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 - элементы этого перебираемого объекта или итератора.

Definition Classes
TraversableOnce → GenTraversableOnce
Исключения

UnsupportedOperationException если этот перебираемый объект или итератор пустой.

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

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

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

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

B

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

op

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

returns

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

Definition Classes
TraversableOnce → GenTraversableOnce

val regex: Regex

def reversed: List[String]

Attributes
protected[this]
Definition Classes
TraversableOnce

def sameElements(that: collection.Iterator[_]): Boolean

Проверяет, генерирует ли другой итератор те же значения, что и этот.

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

that

другой итератор

returns

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

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

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

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

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

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

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

B

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

z

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

op

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

returns

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

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

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

def scanRight[B](z: B)(op: (String, B) ⇒ B): collection.Iterator[B]

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

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

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

B

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

z

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

op

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

returns

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

Definition Classes
Iterator
Пример:
    Iterator(1, 2, 3, 4).scanRight(0)(_ + _).toList == List(10, 9, 7, 4, 0)
Примечание

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

def seq: collection.Iterator[String]

Версия этого набора данных с реализованными последовательными операциями (т.е. в однопоточном режиме).

Этот метод возвращает ссылку на этот набор данных. В параллельных наборах данных он переопределён для возвращения последовательной реализации этого набора данных. В обоих случаях сложность составляет O(1).

возвращает

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

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

def size: Int

Размер этого итерируемого объекта или итератора.

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

возвращает

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

Определяющие классы
TraversableOnce → GenTraversableOnce

def sizeHintIfCheap: Int

Размер этого набора данных или итератора, если он может быть вычислен недорого.

возвращает

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

Атрибуты
protected[collection]
Определяющие классы
GenTraversableOnce

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

Создаёт итератор, возвращающий интервал значений, производимых этим итератором.

from

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

until

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

возвращает

итератор, который продвигается по этому итератору, минуя первые from элементов с использованием drop, и затем берет until - from элементов с использованием take.

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

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

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
возвращает

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

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

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

val source: CharSequence

Источник, из которого возникло соответствие.

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

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

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

p

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

возвращает

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

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

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

def start(i: Int): Int

Индекс первой совпавшей буквы в группе i.

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

def start: Int

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

Definition Classes
MatchIterator → MatchData

def subgroups: List[String]

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

Definition Classes
MatchData

def sum: A

[use case]

Суммирует элементы этого набора.

returns

сумма всех элементов в этом перебираемом объекте или итераторе чисел типа Int. Вместо Int может использоваться любой другой тип T с неявной Numeric[T] реализацией, который может быть использован в качестве типа элемента перебираемого объекта или итератора и типа результата sum. Примеры таких типов: Long, Float, Double, BigInt.

Definition Classes
TraversableOnce → GenTraversableOnce
Полная сигнатура

final def synchronized[T0](arg0: ⇒ T0): T0

Definition Classes
AnyRef

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

Выбирает первые n значений этого итератора.

n

количество значений для выбора

returns

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

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

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

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

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

p

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

returns

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

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

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

def to[Col[_]]: Col[A]

[use case]

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

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

Col

Тип коллекции для построения.

returns

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

Definition Classes
TraversableOnce → GenTraversableOnce
Полная сигнатура

def toArray: Array[A]

[use case]

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

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

returns

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

Definition Classes
TraversableOnce → GenTraversableOnce
Полная сигнатура

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

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

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

returns

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

Definition Classes
TraversableOnce → GenTraversableOnce

def toIndexedSeq: collection.immutable.IndexedSeq[String]

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

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

returns

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

Definition Classes
TraversableOnce → GenTraversableOnce

def toIterable: collection.Iterable[String]

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

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

returns

Iterable, содержащий все элементы этого перебираемого объекта или итератора.

Definition Classes
TraversableOnce → GenTraversableOnce

def toIterator: collection.Iterator[String]

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

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

returns

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

Definition Classes
Iterator → GenTraversableOnce

def toList: List[String]

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

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

returns

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

Definition Classes
TraversableOnce → GenTraversableOnce

def toMap[T, U]: Map[T, U]

[use case]

Преобразует этот перебираемый объект или итератор в словарь. Этот метод недоступен, если элементы не являются членами Tuple2, каждая ((T, U)) становится парой ключ-значение в словаре. Повторяющиеся ключи будут перезаписаны последующими ключами: если это неупорядоченное множество, то какой ключ находится в результирующем словаре, не определено.

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

returns

словарь типа immutable.Map[T, U], содержащий все пары ключ/значение типа (T, U) этого перебираемого объекта или итератора.

Definition Classes
TraversableOnce → GenTraversableOnce
Полная сигнатура

def toSeq: collection.Seq[String]

Преобразует этот перебираемый объект или итератор в последовательность. Как и toIterable, он ленивый в этой реализации по умолчанию, поскольку этот TraversableOnce может быть ленивым и невычисленным.

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

returns

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

Definition Classes
TraversableOnce → GenTraversableOnce

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

Преобразует этот перебираемый объект или итератор в множество.

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

returns

множество, содержащее все элементы этого перебираемого объекта или итератора.

Definition Classes
TraversableOnce → GenTraversableOnce

def toStream: collection.immutable.Stream[String]

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

returns

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

Definition Classes
Iterator → GenTraversableOnce

def toString(): String

Сообщить о пустоте.

returns

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

Definition Classes
MatchIterator → MatchData → Iterator → AnyRef → Any

def toTraversable: collection.Traversable[String]

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

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

returns

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

Definition Classes
Iterator → TraversableOnce → GenTraversableOnce

def toVector: Vector[String]

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

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

returns

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

Definition Classes
TraversableOnce → GenTraversableOnce

final def wait(): Unit

Definition Classes
AnyRef
Annotations
@throws( ... )

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

Definition Classes
AnyRef
Annotations
@throws( ... )

final def wait(arg0: Long): Unit

Definition Classes
AnyRef
Annotations
@throws( ... ) @native()

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

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

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

p

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

returns

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

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

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

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

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

that

Итератор, предоставляющий вторую половину каждой пары результатов

returns

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

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

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

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

[use case]

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

that

итератор that может иметь другую длину по сравнению с итератором self.

thisElem

элемент thisElem используется для заполнения полученного итератора, если итератор self короче, чем that

thatElem

элемент thatElem используется для заполнения полученного итератора, если that короче, чем итератор self

returns

новый итератор, содержащий пары, состоящие из соответствующих значений этого итератора и that. Длина возвращённого итератора равна максимальной из длин этого итератора и that. Если этот итератор короче, чем that, значения thisElem используются для заполнения результата. Если that короче, чем этот итератор, значения thatElem используются для заполнения результата.

Definition Classes
Iterator
Полная подпись

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

Создаёт итератор, который создаёт пары каждого элемента, генерируемого этим итератором, с его индексом, считая с 0.

returns

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

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

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

def →[B](y: B): (MatchIterator, B)

Неявный
Этот член добавляется неявным преобразованием из MatchIterator в ArrowAssoc[MatchIterator] выполненным методом ArrowAssoc в scala.Predef.
Definition Classes
ArrowAssoc

Члены-значения с затемнённым неявным значением

def filter(p: (String) ⇒ Boolean): collection.TraversableOnce[String]

Неявный
Этот член добавлен с помощью неявного преобразования из MatchIterator в MonadOps[String] с помощью метода MonadOps в scala.collection.TraversableOnce.
Затемнённый
Этот неявно унаследованный член затемнён одним или несколькими членами в этом классе.
Для доступа к этому члену можно использовать приведение типа:
(matchIterator: MonadOps[String]).filter(p)
Классы определений
MonadOps

def flatMap[B](f: (String) ⇒ GenTraversableOnce[B]): collection.TraversableOnce[B]

Неявный
Этот член добавлен с помощью неявного преобразования из MatchIterator в MonadOps[String] с помощью метода MonadOps в scala.collection.TraversableOnce.
Затемнённый
Этот неявно унаследованный член затемнён одним или несколькими членами в этом классе.
Для доступа к этому члену можно использовать приведение типа:
(matchIterator: MonadOps[String]).flatMap(f)
Классы определений
MonadOps

def map[B](f: (String) ⇒ B): collection.TraversableOnce[B]

Неявный
Этот член добавлен с помощью неявного преобразования из MatchIterator в MonadOps[String] с помощью метода MonadOps в scala.collection.TraversableOnce.
Затемнённый
Этот неявно унаследованный член затемнён одним или несколькими членами в этом классе.
Для доступа к этому члену можно использовать приведение типа:
(matchIterator: MonadOps[String]).map(f)
Классы определений
MonadOps

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

Неявный
Этот член добавлен с помощью неявного преобразования из MatchIterator в MonadOps[String] с помощью метода MonadOps в scala.collection.TraversableOnce.
Затемнённый
Этот неявно унаследованный член затемнён одним или несколькими членами в этом классе.
Для доступа к этому члену можно использовать приведение типа:
(matchIterator: MonadOps[String]).withFilter(p)
Классы определений
MonadOps

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

Spec-Zone.ru

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