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

注解

通过解释 Patterna.

匹配程序通过调用模式的方法从模式 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.util.regex.MatcherJava 文档

本页的某些部分是根据 Android 开放源代码项目创建和共享的工作进行的修改，并根据 Creative Commons 2.5 属性许可证中所述的术语使用。

属性

Class	返回此 Object的运行时类。 (继承自 Object)
Handle	基础 Android 实例的句柄。 (继承自 Object)
HasAnchoringBounds	查询此匹配程序的区域边界的定位。
HasTransparentBounds	查询此匹配程序的区域边界的透明度。
JniIdentityHashCode	对 java 执行匹配操作的引擎。 (继承自 Object)
JniPeerMembers	对 java 执行匹配操作的引擎。
PeerReference	对 java 执行匹配操作的引擎。 (继承自 Object)
ThresholdClass	此 API 支持 Mono for Android 基础结构，不打算直接从代码使用。 (继承自 Object)
ThresholdType	此 API 支持 Mono for 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> 或 <em>interrupted</em>。<>< (继承自 Object)
Wait(Int64)	使当前线程等待直到唤醒，通常是通过 <em>通知</em> 或 <em interrupted</em>>，或直到经过一定数量的实时。 (继承自 Object)
Wait(Int64, Int32)	使当前线程等待直到唤醒，通常是通过 <em>通知</em> 或 <em interrupted</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 执行匹配操作的引擎。