IUnicodeMatcher.Matches(IReplaceable, Int32[], Int32, Boolean) Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Return a UMatchDegree value indicating the degree of match for the given text at the given offset.
[Android.Runtime.Register("matches", "(Landroid/icu/text/Replaceable;[IIZ)I", "GetMatches_Landroid_icu_text_Replaceable_arrayIIZHandler:Android.Icu.Text.IUnicodeMatcherInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null", ApiSince=24)]
public int Matches (Android.Icu.Text.IReplaceable? text, int[]? offset, int limit, bool incremental);[<Android.Runtime.Register("matches", "(Landroid/icu/text/Replaceable;[IIZ)I", "GetMatches_Landroid_icu_text_Replaceable_arrayIIZHandler:Android.Icu.Text.IUnicodeMatcherInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null", ApiSince=24)>]
abstract member Matches : Android.Icu.Text.IReplaceable * int[] * int * bool -> intParameters
- text
- IReplaceable
the text to be matched
- offset
- Int32[]
on input, the index into text at which to begin matching. On output, the limit of the matched text. The number of matched characters is the output value of offset minus the input value. Offset should always point to the HIGH SURROGATE (leading code unit) of a pair of surrogates, both on entry and upon return.
- limit
- Int32
the limit index of text to be matched. Greater than offset for a forward direction match, less than offset for a backward direction match. The last character to be considered for matching will be text.charAt(limit-1) in the forward direction or text.charAt(limit+1) in the backward direction.
- incremental
- Boolean
if true, then assume further characters may be inserted at limit and check for partial matching. Otherwise assume the text as given is complete.
Returns
a match degree value indicating a full match, a partial match, or a mismatch. If incremental is false then U_PARTIAL_MATCH should never be returned.
- Attributes
Remarks
Return a UMatchDegree value indicating the degree of match for the given text at the given offset. Zero, one, or more characters may be matched.
Matching in the forward direction is indicated by limit > offset. Characters from offset forwards to limit-1 will be considered for matching.
Matching in the reverse direction is indicated by limit < offset. Characters from offset backwards to limit+1 will be considered for matching.
If limit == offset then the only match possible is a zero character match (which subclasses may implement if desired).
If U_MATCH is returned, then as a side effect, advance the offset parameter to the limit of the matched substring. In the forward direction, this will be the index of the last matched character plus one. In the reverse direction, this will be the index of the last matched character minus one.
Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.