Matcher Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Подсистема, выполняющая операции сопоставления на java.
[Android.Runtime.Register("java/util/regex/Matcher", DoNotGenerateAcw=true)]
public sealed class Matcher : Java.Lang.Object, IDisposable, 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- Наследование
- Атрибуты
- Реализации
Комментарии
Обработчик, выполняющий операции сопоставления в последовательности символов java.lang.CharSequence, интерпретируя объект Pattern.
Сопоставление создается из шаблона путем вызова метода шаблона Pattern#matcher matcher . После создания сопоставитель можно использовать для выполнения трех различных видов операций сопоставления:
<Ул>
<li>
Метод #matches matches пытается сопоставить всю входную последовательность с шаблоном.
</li>
<li>
Метод #lookingAt lookingAt пытается сопоставить входную последовательность, начиная с начала, с шаблона.
</li>
<li>
Метод #find find сканирует входную последовательность, которая ищет следующую подсезону, соответствующую шаблону.
</li>
</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.
Части этой страницы — это изменения на основе работы, созданной и общей Project и используемых в соответствии с условиями, описанными в разделе "".
Свойства
| Имя | Описание |
|---|---|
| Class |
Возвращает класс среды выполнения этого |
| Handle |
Дескриптор базового экземпляра Android. (Унаследовано от Object) |
| HasAnchoringBounds |
Запрашивает привязку границ региона для этого компатера. |
| HasTransparentBounds |
Запрашивает прозрачность границ региона для этого компатера. |
| JniIdentityHashCode |
Возвращает хэш-код удостоверения, назначенный этому Java одноранговой среде выполнения взаимодействия. (Унаследовано от Object) |
| JniManagedPeerState |
Подсистема, выполняющая операции сопоставления на java. (Унаследовано от JavaObject) |
| JniPeerMembers |
Подсистема, выполняющая операции сопоставления на java. |
| PeerReference |
Возвращает ссылку на объект JNI для этого Java однорангового узла. (Унаследовано от Object) |
| ThresholdClass |
Этот API поддерживает инфраструктуру Mono для Android и не предназначен для использования непосредственно из кода. (Унаследовано от Object) |
| ThresholdType |
Этот API поддерживает инфраструктуру Mono для Android и не предназначен для использования непосредственно из кода. (Унаследовано от Object) |
Методы
| Имя | Описание |
|---|---|
| AppendReplacement(StringBuffer, String) |
Реализует шаг добавления и замены без терминала. |
| AppendReplacement(StringBuilder, String) |
Реализует шаг добавления и замены без терминала. |
| AppendTail(StringBuffer) |
Реализует шаг добавления и замены терминала. |
| AppendTail(StringBuilder) |
Реализует шаг добавления и замены терминала. |
| Clone() |
Создает и возвращает копию этого объекта. (Унаследовано от Object) |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
Подсистема, выполняющая операции сопоставления на java. (Унаследовано от JavaObject) |
| Dispose() |
Освобождает ресурсы, удерживаемые этим Java одноранговым узлом. (Унаследовано от Object) |
| Dispose(Boolean) |
Освобождает ресурсы, удерживаемые этим Java одноранговым узлом. (Унаследовано от Object) |
| DisposeUnlessReferenced() |
Подсистема, выполняющая операции сопоставления на java. (Унаследовано от JavaObject) |
| End() |
Возвращает смещение после последнего совпадения символа. |
| End(Int32) |
Возвращает смещение после последнего символа подсефференции, захваченного заданной группой во время предыдущей операции сопоставления. |
| End(String) |
Возвращает смещение после последнего символа подсебления, захваченного заданной группой именованной записи во время предыдущей операции сопоставления. |
| Equals(Object) |
Подсистема, выполняющая операции сопоставления на java. (Унаследовано от JavaObject) |
| 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) |
Возвращает литеральную замену |
| 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) |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
Подсистема, выполняющая операции сопоставления на java. (Унаследовано от JavaObject) |
| Start() |
Возвращает начальный индекс предыдущего совпадения. |
| Start(Int32) |
Возвращает начальный индекс подсечений, захваченных заданной группой во время предыдущей операции сопоставления. |
| Start(String) |
Возвращает начальный индекс подсечений, захваченных заданной именованной группой записи во время предыдущей операции сопоставления. |
| ToArray<T>() |
Создает управляемый массив из этого Java оболочки массива. (Унаследовано от Object) |
| ToMatchResult() |
Возвращает состояние соответствия этого компатера в виде |
| ToString() |
Возвращает строковое представление объекта. (Унаследовано от Object) |
| UnregisterFromRuntime() |
Отменяет регистрацию этого Java однорангового узла из среды выполнения взаимодействия. (Унаследовано от Object) |
| UseAnchoringBounds(Boolean) |
Задает привязку границ региона для этого компатера. |
| UsePattern(Pattern) |
Изменяет значение |
| UseTransparentBounds(Boolean) |
Задает прозрачность границ региона для этого компатера. |
| Wait() |
Приводит к тому, что текущий поток будет ждать, пока он не проснется, как правило, при <>помощи уведомления</em> или <эм>прерванного</em>. (Унаследовано от Object) |
| Wait(Int64, Int32) |
Приводит к тому, что текущий поток будет ждать, пока он не проснется, как правило, при <>получении уведомления</>em или <>эм прервано< или> до тех пор, пока не истекло определенное количество реального времени. (Унаследовано от Object) |
| Wait(Int64) |
Приводит к тому, что текущий поток будет ждать, пока он не проснется, как правило, при <>получении уведомления</>em или <>эм прервано< или> до тех пор, пока не истекло определенное количество реального времени. (Унаследовано от Object) |
Явные реализации интерфейса
| Имя | Описание |
|---|---|
| IJavaPeerable.Disposed() |
Подсистема, выполняющая операции сопоставления на java. (Унаследовано от JavaObject) |
| IJavaPeerable.Finalized() |
Подсистема, выполняющая операции сопоставления на java. (Унаследовано от JavaObject) |
| IJavaPeerable.JniObjectReferenceControlBlock |
Подсистема, выполняющая операции сопоставления на java. (Унаследовано от JavaObject) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
Подсистема, выполняющая операции сопоставления на java. (Унаследовано от JavaObject) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
Подсистема, выполняющая операции сопоставления на java. (Унаследовано от JavaObject) |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
Подсистема, выполняющая операции сопоставления на java. (Унаследовано от JavaObject) |
| IJavaPeerable.UnregisterFromRuntime() |
Подсистема, выполняющая операции сопоставления на java. |
Методы расширения
| Имя | Описание |
|---|---|
| GetJniTypeName(IJavaPeerable) |
Возвращает имя JNI типа экземпляра |
| JavaAs<TResult>(IJavaPeerable) |
Попробуйте принуждать к типу |
| JavaCast<TResult>(IJavaObject) |
Выполняет преобразование типа, проверяемого средой выполнения Android. |
| JavaCast<TResult>(IJavaObject) |
Подсистема, выполняющая операции сопоставления на java. |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
Попробуйте принуждать к типу |