智能客服
你问我答，随时在线为你解决问题
- 要匹配的字符串最大长度不得超过 231-1。
- 要使用 replaceAll 替换的字符串最大长度不得超过 230-2。
- 探索了解鸿蒙应用和多设备开发，学习如何构建应用/元服务应用形态HarmonyOS 应用One as All，All as One
元服务秒开直达 服务随行 无处不在
游戏为游戏创意玩法带来无限可能
多设备应用开发穿戴
折叠屏手机鸿蒙电脑开发者学堂视频课程Codelabs - 开发获取官方开发工具和文档等资源，将创意转化为鸿蒙应用开发工具DevEco Studio应用开发 IDE, AI Agent 和 CLI
小艺开放平台Skill 和智能体开发平台
ArkTS
ArKUI
AppGallery ConnectDevEco Testing开发资源工具下载示例代码开发文档最佳实践 - 分发通过华为应用市场发布你的应用，多渠道触达用户应用分发应用市场纯净安全的全场景应用分发平台
游戏中心
应用审核政策服务分发小艺HarmonyOS 的超级 AI 入口
智慧助手·今天
服务分发文档内容分发主题服务
内容分发文档 - 推广与变现一站式流量增长与营销变现平台推广应用推广引擎全链路应用推广与增长服务平台
鲸鸿动能广告为企业广告主提供广告营销服务
联运服务推广文档变现鲸鸿动能流量变现使能应用展示广告，实现流量变现应用内支付变现文档 - 生态合作携手伙伴共建共享鸿蒙智能终端生态伙伴 SDK一站式获取安全可靠的鸿蒙伙伴 SDK
生态服务鸿蒙应用开发、培训和人力服务
服务商伙伴中心华为终端云服务商伙伴的统一门户
伙伴入驻指南生态市场介绍，卖家和买家服务指引
廉洁政策合作伙伴诚信廉洁政策
- 支持获取客服帮助、技术支持、活动资讯等信息智能客服24小时 AI 在线自助服务，即问即答
社区问答在官方论坛提问，与开发者互动交流
在线提单提交工单，获得技术支持
开发者活动HDD 等线下活动速览及报名入口
资讯帮助指南
此版本文档已归档不再维护，推荐您使用最新版本。
类
本文导读
class MatchData
- public class MatchData {}
功能：存储正则表达式匹配结果，并提供对正则匹配结果进行查询的函数。
func matchPosition()
- public func matchPosition(): Position
功能：获取上一次匹配到的子字符串在输入字符串中起始位置和末尾位置的索引。
返回值：
- Position - 匹配结果位置信息。
func matchPosition(Int64)
- public func matchPosition(group: Int64): Position
功能：根据给定的索引获取上一次匹配中该捕获组匹配到的子字符串在输入字符串中的位置信息。
参数：
- group: Int64 - 指定组。
返回值：
- Position - 对应捕获组的位置信息。
异常：
- IndexOutOfBoundsException - 当 group 小于 0 或者大于 groupNumber 时，抛出异常。
- RegexException - 当 group 不为 0 且没有捕获组时，抛出异常。
func matchStr()
- public func matchStr(): String
功能：获取上一次匹配到的子字符串，结果与调用 matchStr(0) 相同。
返回值：
- String - 匹配到的子字符串。
异常：
- IndexOutOfBoundsException - 当匹配字符串数组长度小于 1，抛出异常。
func matchStr(Int64)
- public func matchStr(group: Int64): String
功能：根据给定的索引获取上一次匹配中该捕获组匹配到的子字符串。
捕获组的索引从 1 开始，索引为 0 表示获取整个正则表达式的匹配结果。
参数：
- group: Int64 - 指定组。
返回值：
- String - 匹配到的子字符串。
异常：
- IndexOutOfBoundsException - 当 group 小于 0 或者大于 groupNumber 时，抛出异常。
- RegexException - 当 group 不为 0 且没有捕获组时，抛出异常。
class Matcher
- public class Matcher {
- public init(re: Regex, input: String)
- }
功能：正则匹配器，用于扫描输入序列并进行匹配。
注意
init(Regex, String)
- public init(re: Regex, input: String)
功能：使用传入的正则表达式和输入序列创建 Matcher 实例。
参数：
异常：
- RegexException - 当初始化失败时，抛出异常。
- IllegalArgumentException - 当 input 中包含空字符或长度大于231-1时，抛出异常。
func allCount()
- public func allCount(): Int64
功能：获取正则表示式的匹配结果总数。
默认是从头到尾匹配的结果，使用了 setRegion 后只会在设置的范围内查找。
返回值：
- Int64 - 匹配结果总数。
func find()
- public func find(): Option<MatchData>
功能：自当前字符串偏移位置起，查找第一个匹配到的子序列。
find 调用一次，当前偏移位置为最新一次匹配到的子序列后第一个字符位置，下次调用, find 从当前位置开始匹配。
返回值：
异常：
- RegexException - 当重置匹配器失败时，抛出异常。
func find(Int64)
- public func find(index: Int64): Option<MatchData>
功能：重置该匹配器索引位置，从 index 对应的位置处开始对输入序列进行匹配, 返回匹配到的子序列。
返回值：
异常：
- IndexOutOfBoundsException - 当 index 小于 0，或 index 大于等于输入序列的 size 时，抛出异常。
- RegexException - 当重置匹配器失败时，抛出异常。
func findAll()
- public func findAll(): Option<Array<MatchData>>
功能：对整个输入序列进行匹配，查找所有匹配到的子序列。
返回值：
- Option < Array<MatchData>> - 如果匹配到结果，返回 Option<Array<MatchData>>；如果匹配不到，返回 Option<Array<MatchData>>.None
异常：
- RegexException - 当重置匹配器内存分配失败或申请内存失败时，抛出异常。
func fullMatch()
- public func fullMatch(): Option<MatchData>
功能：对整个输入序列进行匹配。
返回值：
func matchStart()
- public func matchStart(): Option<MatchData>
功能：对输入序列的头部进行匹配。
返回值：
异常：
- RegexException - 当重置匹配器失败时，抛出异常。
func replace(String)
- public func replace(replacement: String): String
功能：自当前字符串偏移位置起，匹配到的第一个子序列替换为目标字符串, 并将当前索引位置设置到匹配子序列的下一个位置。
参数：
- replacement: String - 指定替换字符串。
返回值：
- String - 替换后字符串。
异常：
- RegexException - 当重置匹配器失败时，抛出异常。
- IllegalArgumentException - 当 replacement 长度大于 230-2，或者 replacement 包含空字符时，抛出异常。
func replace(String, Int64)
- public func replace(replacement: String, index: Int64): String
功能：从输入序列的 index 位置起匹配正则，将匹配到的第一个子序列替换为目标字符串。
参数：
返回值：
- String - 替换后字符串。
异常：
- IndexOutOfBoundsException - 当 index 小于 0，或 index 大于等于输入序列的 size 时，抛出异常。
- RegexException - 当重置匹配器失败时，抛出异常。
- IllegalArgumentException - 当 replacement 长度大于 230-2，或者 replacement 包含空字符时，抛出异常。
func replaceAll(String)
- public func replaceAll(replacement: String): String
功能：将输入序列中所有与正则匹配的子序列替换为给定的目标字符串。
参数：
- replacement: String - 指定替换字符串。
返回值：
- String - 替换后的字符串。
异常：
- RegexException - 当重置匹配器失败时，或者 c 侧申请内存失败，或者替换字符串时发生了 GC 时，抛出异常。
- IllegalArgumentException - 当 replacement 长度大于 230-2，或者 replacement 包含空字符时，抛出异常。
func replaceAll(String, Int64)
- public func replaceAll(replacement: String, limit: Int64): String
功能：将输入序列中与正则匹配的前 limit 个子序列替换为给定的替换字符串。
参数：
返回值：
- String - 替换后字符串。
异常：
- RegexException - 当重置匹配器失败时，或者 c 侧申请内存失败，或者替换字符串时发生了 GC 时，抛出异常。
- IllegalArgumentException - 当 replacement 长度大于 230-2，或者 replacement 包含空字符时，抛出异常。
func resetRegion()
- public func resetRegion(): Matcher
功能：重置匹配器开始位置和结束位置。
返回值：
- Matcher - 匹配器自身。
异常：
- RegexException - 当重置匹配器失败时，抛出异常。
func resetString(String)
- public func resetString(input: String): Matcher
功能：重设匹配序列，并重置匹配器。
参数：
- input: String - 新的匹配序列。
返回值：
- Matcher - 匹配器自身。
异常：
- RegexException - 当重置匹配器失败时，抛出异常。
- IllegalArgumentException - 当 input 长度大于 231-1 或者包含空字符时，抛出异常。
func setRegion(Int64, Int64)
- public func setRegion(beginIndex: Int64, endIndex: Int64): Matcher
功能：设置匹配器可搜索区域的位置信息，具体位置由指定的 begin 和 end 决定。
参数：
返回值：
- Matcher - 匹配器自身。
异常：
- IndexOutOfBoundsException - 当 beginIndex 小于0，或 beginIndex 大于输入序列的 size 时，抛出异常。
- IndexOutOfBoundsException - 当 endIndex 小于0，或 endIndex 大于输入序列的 size 时，抛出异常。
- IndexOutOfBoundsException - 当 beginIndex 大于 endIndex 时，抛出异常。
func split()
- public func split(): Array<String>
功能：将给定的输入序列根据正则尽可能的分割成多个子序列。
返回值：
func split(Int64)
- public func split(limit: Int64): Array<String>
功能：将给定的输入序列根据正则尽可能的分割成多个子序列 (最多分割成 limit 个子串)。
参数：
- limit: Int64 - 最多分割的子串个数。
返回值：
异常：
- RegexException - 当重置匹配器失败时，抛出异常。
class Regex
- public class Regex {
- public init(s: String)
- public init(s: String, option: RegexOption)
- }
功能：用来指定编译类型和输入序列。
正则匹配规则详见 regex 规则集。
init(String)
- public init(s: String)
功能：创建 Regex 实例， 匹配模式为普通模式。
参数：
- s: String - 正则表达式。
异常：
- RegexException - 当初始化失败时，抛出异常。
- IllegalArgumentException - 当 s 中包含空字符时，抛出异常。
init(String, RegexOption)
- public init(s: String, option: RegexOption)
功能：使用指定的模式创建一个 Regex 实例。
参数：
- s: String - 正则表达式。
- option: RegexOption - 正则匹配的模式。
异常：
- RegexException - 当初始化失败时，抛出异常。
- IllegalArgumentException - 当 s 中包含空字符时，抛出异常。
func matcher(String)
- public func matcher(input: String): Matcher
功能：创建匹配器。
参数：
- input: String - 要匹配的字符串, 字符串长度最大 231 - 1。
返回值：
- Matcher - 创建的匹配器。
异常：
- RegexException - 当初始化失败时，抛出异常。
- IllegalArgumentException - 当 input 中包含空字符时，抛出异常。
func matches(String)
- public func matches(input: String): Option<MatchData>
功能：创建匹配器，并将入参 input 与正则表达式进行完全匹配。
参数：
- input: String - 要匹配的字符串, 字符串长度最大 231 - 1。
返回值：
异常：
- RegexException - 当初始化失败时，抛出异常。
- IllegalArgumentException - 当 input 中包含空字符时，抛出异常。
class RegexOption
- public class RegexOption <: ToString {
- public init()
- }
功能：用于指定正则匹配的模式。
默认的正则匹配算法为 NFA ，匹配运行次数上限为 1000000。
func ignoreCase()
- public func ignoreCase(): RegexOption
功能：修改 RegexOption，修改匹配模式为忽略大小写（IGNORECASE）。
返回值：
- RegexOption - 修改后的 RegexOption。
func multiLine()
- public func multiLine(): RegexOption
功能：修改 RegexOption，修改匹配模式为多行文本模式（MULTILINE）。
返回值：
- RegexOption - 修改后的 RegexOption。
搜索
请输入您想要搜索的关键词