Matcher 类
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
通过解释 Patterna.
[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
- 继承
- 特性
- 实现
注解
通过解释 Patterna.
匹配程序通过调用模式的方法从模式 Pattern#matcher matcher 创建。 创建后,可以使用匹配程序执行三种不同类型的匹配操作:
<ul>
<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。
本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。
属性
| 名称 | 说明 |
|---|---|
| Class |
返回此 |
| Handle |
基础 Android 实例的句柄。 (继承自 Object) |
| HasAnchoringBounds |
查询此匹配程序的区域边界的定位。 |
| HasTransparentBounds |
查询此匹配程序的区域边界的透明度。 |
| JniIdentityHashCode |
获取互操作运行时分配给此Java对等的标识哈希代码。 (继承自 Object) |
| JniManagedPeerState |
获取运行时上次分配的状态标志。 (继承自 JavaObject) |
| JniPeerMembers |
获取用于访问此Java绑定成员的 JNI 元数据。 |
| PeerReference |
获取此Java对等方的 JNI 对象引用。 (继承自 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) |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
将此对等方的构造委托给运行时的值管理器。 (继承自 JavaObject) |
| Dispose() |
释放此Java对等方持有的资源。 (继承自 Object) |
| Dispose(Boolean) |
释放此Java对等方持有的资源。 (继承自 Object) |
| DisposeUnlessReferenced() |
要求值管理器释放此对等方,除非其映射保留此相同的托管实例。 (继承自 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) |
在不创建 JNI 引用副本的情况下,将引用值存储在控制块中。 (继承自 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< 或 >em<interrupted>/em<。><> (继承自 Object) |
| Wait(Int64, Int32) |
使当前线程等待直到唤醒,通常是通过 <em>通知</em> 或 <em interrupted>/em<>,或直到经过一定数量的实时。 (继承自 Object) |
| Wait(Int64) |
使当前线程等待直到唤醒,通常是通过 <em>通知</em> 或 <em interrupted>/em<>,或直到经过一定数量的实时。 (继承自 Object) |
显式接口实现
| 名称 | 说明 |
|---|---|
| IJavaPeerable.Disposed() |
将此对等方标记为已释放,并将 |
| IJavaPeerable.Finalized() |
将此对等方标记为已释放,并将 |
| IJavaPeerable.JniObjectReferenceControlBlock |
获取此对等方使用的本机控制块指针。 (继承自 JavaObject) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
存储运行时提供的标识哈希代码。 (继承自 JavaObject) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
替换存储的托管对等状态标志。 (继承自 JavaObject) |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
更新对等引用,并在引用无效时释放已释放的对等方控制块。 (继承自 JavaObject) |
| IJavaPeerable.UnregisterFromRuntime() |
从运行时的Java对象查找中删除此实例。 |
扩展方法
| 名称 | 说明 |
|---|---|
| GetJniTypeName(IJavaPeerable) |
获取实例 |
| JavaAs<TResult>(IJavaPeerable) |
尝试强制 |
| JavaCast<TResult>(IJavaObject) |
执行 Android 运行时检查的类型转换。 |
| JavaCast<TResult>(IJavaObject) |
重复使用兼容的托管对等,或获取请求类型的包装器。 |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
尝试强制 |