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