手册目录

Java 迭代器接口

Java 错误和异常类型

Java.io 包教程

Java 教程

浏览6134
更新时间2025-07-22

前言

定义和用法replaceFirst() 方法用于将字符串中第一个匹配正则表达式的子串替换为新的子串。替换字符串可能包含形式为 n的反向引用,其中n是模式中组的索


定义和用法

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

相关视频

更多

免费

php8,我来也
初级php8,我来也

321756次学习

收藏

免费

Thinkphp6.0正式版视频教程
中级Thinkphp6.0正式版视频教程

382411次学习

收藏

免费

细说PHP第一季
中级细说PHP第一季

282705次学习

收藏

免费

简单聊聊PHP创业那点事
初级简单聊聊PHP创业那点事

13413次学习

收藏

精品课程

更多
前端入门_HTML5
前端入门_HTML5

共29课时 | 62.5万人学习

CSS视频教程-玉女心经版
CSS视频教程-玉女心经版

共25课时 | 39.7万人学习

JavaScript极速入门_玉女心经系列
JavaScript极速入门_玉女心经系列

共43课时 | 73.8万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号