Java String replaceFirst()方法

文
章
目
录

• 1.String.replaceFirst() API
• 2.String.replaceFirst() 示例
• 3.转义特殊字符
• 4.”null” 不被允许作为方法的任何参数

Java 中的 String.replaceFirst() 方法用于将第一个与给定参数子字符串（或正则表达式）匹配的子字符串替换为指定的替换子字符串。子字符串匹配过程从字符串的开头（索引0）开始，一旦找到第一个匹配项，匹配就结束，否则匹配到字符串的末尾。

需要注意的是，不能将 null 作为方法参数传递，但可以传递一个空字符串。

1.String.replaceFirst() API

replaceFirst() 的语法如下。它搜索子字符串 regex 并用替换字符串进行替换。regex 可以是普通字符串，也可以是正则表达式。

String replaceFirst(String regex, String replacement);

2.String.replaceFirst() 示例

以下的Java程序将第一个出现的 “com” 替换为大写 “COM” 字符串。

String str = \"panziye.com\";
String newStr = str.replaceFirst(\"com\", \"COM\");
System.out.println(newStr); //panziye.COM

我们也可以使用正则表达式如下所示：

// 第一个空格替换为-
String string = \"www panziye com\";
String updatedString = string.replaceFirst(\"\\\\s\", \"-\");
System.out.println(updatedString); //www-panziye com

3.转义特殊字符

尽管我们可以将正则表达式作为子字符串模式传递以进行匹配，但原始字符串可能包含我们不希望在模式匹配中考虑的特殊字符。

在正则表达式中，有些字符具有特殊含义。这些元字符包括：

\\ ^ $ . | ? * + {} [] ()

对于这样的元字符，使用双反斜杠（\\\\）来跳过该元字符。

String string = \"www+panziye+com\";
String updatedString = string.replaceFirst(\"\\\\+\", \"-\");
System.out.println(updatedString); //www-panziye+com

4.”null” 不被允许作为方法的任何参数

如果传递了 null，该方法将抛出 NullPointerException（空指针异常）。因此，在使用 String.replaceFirst() 方法时，请确保不将 null 作为参数传递。

String updatedString = string.replaceFirst(null, \"-\");

运行程序直接报NullPointerException