Matcher replaceFirst(Function) method in Java with Examples
Last Updated :
01 Jul, 2020
The replaceFirst(Function) method of Matcher Class behaves as a append-and-replace method. This method replaces first instance of the pattern matched in the matcher with the function passed in the parameter.
Syntax:
public String replaceFirst(
Function replacerFunction)
Parameters: This method takes a parameter replacerFunction which is the function that defines the replacement of the matcher.
Return Value: This method returns a String with the target String constructed by replacing the String.
Exceptions: This method throws following exceptions:
- NullPointerException: if the replacer function is null
- ConcurrentModificationException: if it is detected that the replacer function modified this matcher’s state
Below examples illustrate the Matcher.replaceFirst() method:
Example 1:
import java.util.regex.*;
public class GFG {
public static void main(String[] args)
{
String regex = "(Geeks)" ;
Pattern pattern
= Pattern.compile(regex);
String stringToBeMatched
= "GeeksForGeeks Geeks for For Geeks Geek" ;
Matcher matcher
= pattern.matcher(stringToBeMatched);
System.out.println( "Before Replacement: "
+ stringToBeMatched);
String stringToBeReplaced = "Geeks" ;
StringBuilder builder
= new StringBuilder();
System.out.println( "After Replacement: "
+ matcher
.replaceFirst(
x -> x.group().toUpperCase()));
}
}
|
Output:
Before Replacement: GeeksForGeeks Geeks for For Geeks Geek
After Replacement: GEEKSForGeeks Geeks for For Geeks Geek
Example 2:
import java.util.regex.*;
public class GFG {
public static void main(String[] args)
{
String regex = "(FGF)" ;
Pattern pattern
= Pattern.compile(regex);
String stringToBeMatched
= "GFG FGF GFG GFG FGF" ;
Matcher matcher
= pattern.matcher(stringToBeMatched);
System.out.println( "Before Replacement: "
+ stringToBeMatched);
String stringToBeReplaced = "(GFG)" ;
StringBuilder builder
= new StringBuilder();
System.out.println( "After Replacement: "
+ matcher
.replaceFirst(
x -> x.group().toLowerCase()));
}
}
|
Output:
Before Replacement: GFG FGF GFG GFG FGF
After Replacement: GFG fgf GFG GFG FGF
Reference: https://docs.oracle.com/javase/9/docs/api/java/util/regex/Matcher.html#replaceFirst-java.util.function.Function-
Like Article
Suggest improvement
Share your thoughts in the comments
Please Login to comment...