Matcher Класс

Определение

Пространство имен:

Java.Util.Regex

Сборка:

Mono.Android.dll

Подсистема, выполняющая операции сопоставления на java.

[Android.Runtime.Register("java/util/regex/Matcher", DoNotGenerateAcw=true)]
public sealed class Matcher : Java.Lang.Object, IDisposable, Java.Interop.IJavaPeerable, Java.Util.Regex.IMatchResult

[<Android.Runtime.Register("java/util/regex/Matcher", DoNotGenerateAcw=true)>]
type Matcher = class
    inherit Object
    interface IMatchResult
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable

Наследование

Object

Object

Matcher

Атрибуты

RegisterAttribute

Реализации

IJavaObject IJavaPeerable IMatchResult IDisposable

Комментарии

Подсистема, выполняющая операции сопоставления в последовательности символов java.lang.CharSequence путем интерпретации Pattern.

Сопоставитель создается на основе шаблона путем вызова метода шаблона Pattern#matcher matcher . После создания сопоставитель можно использовать для выполнения трех различных типов операций сопоставления:

<ul>

<Литий>

Метод #matches matches пытается сопоставить всю последовательность входных данных с шаблоном.

</Литий>

<Литий>

Метод #lookingAt lookingAt пытается сопоставить входную последовательность, начиная с начала, с шаблоном.

</Литий>

<Литий>

Метод #find find сканирует последовательность входных данных в поисках следующей последовательности, которая соответствует шаблону.

</Литий>

</ul>

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

Сопоставитель находит совпадения в подмножестве входных данных, называемом регионом. По умолчанию регион содержит все входные данные сопоставителя. Регион можно изменить с помощью #region(int, int) region метода и запросить с помощью #regionStart() regionStart методов и #regionEnd() regionEnd . Способ взаимодействия границ области с некоторыми конструкциями шаблонов может быть изменен. Дополнительные сведения см. в разделах #useAnchoringBounds(boolean) useAnchoringBounds и #useTransparentBounds(boolean) useTransparentBounds .

Этот класс также определяет методы для замены сопоставленных подсечений новыми строками, содержимое которых при необходимости можно вычислить на основе результата сопоставления. Методы #appendReplacement appendReplacement и #appendTail appendTail можно использовать в тандеме, чтобы собрать результат в существующий строковый буфер или построитель строк. Кроме того, более удобный #replaceAll replaceAll метод можно использовать для создания строки, в которой заменяется каждая соответствующая подсеть во входной последовательности.

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

Явное состояние сопоставителя изначально не определено; Попытка запросить любую часть до успешного совпадения вызовет IllegalStateException исключение . Явное состояние сопоставителя пересылается каждой операцией сопоставления.

Неявное состояние сопоставителя включает последовательность входных символов, а также позицию добавления, которая изначально равна нулю и обновляется методом #appendReplacement appendReplacement .

Сопоставитель может быть сброшен явным образом путем вызова его #reset() метода или, если потребуется новая входная последовательность, его #reset(java.lang.CharSequence) reset(CharSequence) метода. При сбросе сопоставителя отбрасываются его явные сведения о состоянии и устанавливается нулевое положение при добавлении.

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

Добавлено в версии 1.4.

Документация по Java для java.util.regex.Matcher.

Части этой страницы являются изменениями, основанными на работе, созданной и совместно используемой проектом и используемой в соответствии с условиями, Creative Commons 2.5 Attribution License Creative Commons 2.5 Attribution License.

Свойства

Class	Возвращает класс среды выполнения данного объекта Object. (Унаследовано от Object)
Handle	Дескриптор базового экземпляра Android. (Унаследовано от Object)
HasAnchoringBounds	Запрашивает привязку границ регионов для этого сопоставителя.
HasTransparentBounds	Запрашивает прозрачность границ регионов для этого сопоставителя.
JniIdentityHashCode	Подсистема, выполняющая операции сопоставления на java. (Унаследовано от Object)
JniPeerMembers	Подсистема, выполняющая операции сопоставления на java.
PeerReference	Подсистема, выполняющая операции сопоставления на java. (Унаследовано от Object)
ThresholdClass	Этот API поддерживает инфраструктуру Mono для Android и не предназначен для использования непосредственно из кода. (Унаследовано от Object)
ThresholdType	Этот API поддерживает инфраструктуру Mono для Android и не предназначен для использования непосредственно из кода. (Унаследовано от Object)

Методы

AppendReplacement(StringBuffer, String)	Реализует шаг добавления и замены без терминала.
AppendReplacement(StringBuilder, String)	Реализует шаг добавления и замены без терминала.
AppendTail(StringBuffer)	Реализует шаг добавления и замены терминала.
AppendTail(StringBuilder)	Реализует шаг добавления и замены терминала.
Clone()	Создает и возвращает копию этого объекта. (Унаследовано от Object)
Dispose()	Подсистема, выполняющая операции сопоставления на java. (Унаследовано от Object)
Dispose(Boolean)	Подсистема, выполняющая операции сопоставления на java. (Унаследовано от Object)
End()	Возвращает смещение после последнего совпадения символа.
End(Int32)	Возвращает смещение после последнего символа вложенной последовательности, захваченной данной группой во время предыдущей операции сопоставления.
End(String)	Возвращает смещение после последнего символа вложенной последовательности, захваченной заданной именованной группой захвата во время предыдущей операции сопоставления.
Equals(Object)	Указывает, равен ли какой-то другой объект этому объекту. (Унаследовано от Object)
Find()	Пытается найти следующую вложенную последовательность входных данных, соответствующую шаблону.
Find(Int32)	Сбрасывает этот сопоставитель, а затем пытается найти следующую вложенную последовательность входных данных, соответствующую шаблону, начиная с указанного индекса.
GetHashCode()	Возвращает значение хэш-кода для объекта. (Унаследовано от Object)
Group()	Возвращает входную подсеть, соответствующую предыдущему совпадению.
Group(Int32)	Возвращает входную подсеть, записанную заданной группой во время предыдущей операции сопоставления.
Group(String)	Возвращает входную подсеть, записанную заданной именованной группой записи во время предыдущей операции сопоставления.
GroupCount()	Возвращает количество записываемых групп в шаблоне этого сопоставителя.
HitEnd()	Возвращает значение true, если поисковая система достигла конца входных данных в последней операции сопоставления, выполненной этим сопоставителем.
JavaFinalize()	Вызывается сборщиком мусора для объекта , когда сборка мусора определяет, что больше нет ссылок на объект . (Унаследовано от Object)
LookingAt()	Пытается сопоставить входную последовательность, начиная с начала области, с шаблоном.
Matches()	Пытается сопоставить весь регион с шаблоном.
Notify()	Пробуждение одного потока, ожидающего на мониторе этого объекта. (Унаследовано от Object)
NotifyAll()	Активирует все потоки, ожидающие на мониторе этого объекта. (Унаследовано от Object)
Pattern()	Возвращает шаблон, интерпретируемый данным сопоставителем.
QuoteReplacement(String)	Возвращает литерал замены String для указанного Stringобъекта .
Region(Int32, Int32)	Задает ограничения региона этого сопоставителя.
RegionEnd()	Сообщает конечный индекс (монопольный) региона этого сопоставителя.
RegionStart()	Сообщает начальный индекс региона этого сопоставителя.
ReplaceAll(IFunction)	Заменяет каждую подсезону входной последовательности, которая соответствует шаблону, результатом применения данной функции замены к результату сопоставления этого сопоставителя, соответствующего этой части последовательности.
ReplaceAll(String)	Заменяет каждую вложенную последовательность входных данных, соответствующую шаблону, заданной строкой замены.
ReplaceFirst(IFunction)	Заменяет первую подсезону входной последовательности, которая соответствует шаблону, с результатом применения данной функции замены к результату сопоставления этого сопоставителя, соответствующего этой подзарядке.
ReplaceFirst(String)	Заменяет первую подсеть входной последовательности, которая соответствует шаблону, заданной строкой замены.
RequireEnd()	Возвращает значение true, если дополнительные входные данные могут изменить положительное совпадение на отрицательное.
Reset()	Сбрасывает этот сопоставитель.
Reset(ICharSequence)	Сбрасывает этот сопоставитель с новой входной последовательностью.
Reset(String)	Сбрасывает этот сопоставитель с новой входной последовательностью.
SetHandle(IntPtr, JniHandleOwnership)	Задает свойство Handle. (Унаследовано от Object)
Start()	Возвращает начальный индекс предыдущего совпадения.
Start(Int32)	Возвращает начальный индекс вложенной последовательности, захваченной заданной группой во время предыдущей операции сопоставления.
Start(String)	Возвращает начальный индекс вложенной последовательности, захваченной заданной именованной группой записи во время предыдущей операции сопоставления.
ToArray<T>()	Подсистема, выполняющая операции сопоставления на java. (Унаследовано от Object)
ToMatchResult()	Возвращает состояние соответствия этого сопоставителя в виде MatchResult.
ToString()	Возвращает строковое представление объекта. (Унаследовано от Object)
UnregisterFromRuntime()	Подсистема, выполняющая операции сопоставления на java. (Унаследовано от Object)
UseAnchoringBounds(Boolean)	Задает привязку границ областей для этого сопоставителя.
UsePattern(Pattern)	Изменяет , Pattern который используется для Matcher поиска совпадений с .
UseTransparentBounds(Boolean)	Задает прозрачность границ регионов для этого сопоставителя.
Wait()	Заставляет текущий поток ждать, пока он не будет пробужден, как правило, из-за <уведомления/><em> или <прерывания></em>. (Унаследовано от Object)
Wait(Int64)	Заставляет текущий поток ждать, пока он не будет пробужден, как правило, из-за <уведомления</>em>, <>прерывания< или> em, либо до истечения определенного количества реального времени. (Унаследовано от Object)
Wait(Int64, Int32)	Заставляет текущий поток ждать, пока он не будет пробужден, как правило, из-за <уведомления</>em>, <>прерывания< или> em, либо до истечения определенного количества реального времени. (Унаследовано от Object)

Явные реализации интерфейса

IJavaPeerable.Disposed()	Подсистема, выполняющая операции сопоставления на java. (Унаследовано от Object)
IJavaPeerable.DisposeUnlessReferenced()	Подсистема, выполняющая операции сопоставления на java. (Унаследовано от Object)
IJavaPeerable.Finalized()	Подсистема, выполняющая операции сопоставления на java. (Унаследовано от Object)
IJavaPeerable.JniManagedPeerState	Подсистема, выполняющая операции сопоставления на java. (Унаследовано от Object)
IJavaPeerable.SetJniIdentityHashCode(Int32)	Подсистема, выполняющая операции сопоставления на java. (Унаследовано от Object)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	Подсистема, выполняющая операции сопоставления на java. (Унаследовано от Object)
IJavaPeerable.SetPeerReference(JniObjectReference)	Подсистема, выполняющая операции сопоставления на java. (Унаследовано от Object)

Методы расширения

JavaCast<TResult>(IJavaObject)	Выполняет преобразование типа, проверенное средой выполнения Android.
JavaCast<TResult>(IJavaObject)	Подсистема, выполняющая операции сопоставления на java.
GetJniTypeName(IJavaPeerable)	Подсистема, выполняющая операции сопоставления на java.