Java String replaceFirst() 方法
定义和用法
replaceFirst()
方法用于将字符串中第一个匹配正则表达式的子串替换为新的子串。
替换字符串可能包含形式为 n的反向引用,其中n是模式中组的索引。在返回的字符串中,n 的实例将被模式中与该组匹配的子串替换,或者使用 $0 来替换与整个表达式匹配的子串。有关使用反向引用的示例,请参阅下面的实例。
提示:请参阅 Java RegEx 教程,以了解正则表达式。
实例
例子 1
用不同的子串替换正则表达式的第一个匹配项:
String myStr = "This is W3School"; String regex = "is"; System.out.println(myStr.replaceFirst(regex, "at"));
例子 2
使用反向引用将第一个数字用括号括起来:
String myStr = "任务完成!获得了 30 金币和 500 经验。"; String regex = "[0-9]+"; System.out.println(myStr.replaceFirst(regex, "($0)"));
语法
public String replaceFirst(String regex, String replacement)
参数
参数 | 描述 |
---|---|
regex | 必需。定义要搜索的子字符串的正则表达式。 |
replacement | 必需。将替换第一个匹配项的子字符串。 |
技术细节
返回: | 字符串的副本,其中与正则表达式匹配的第一个子字符串被替换为新的子字符串。 |
---|---|
抛出: | PatternSyntaxException - 如果正则表达式的语法不正确。 |
Java 版本: | 1.4 |