
理解 String.format() 的基本用法
string.format() 方法是java中一个强大的字符串格式化工具,它允许开发者使用类似于c语言printf的语法来构建复杂的字符串。它通过占位符(如%s表示字符串,%d表示整数等)来动态插入值。
例如,一个简单的字符串格式化示例如下:
String format = "您的名字是 %s"; String text = String.format(format, "Harry"); System.out.print(text); // 输出: 您的名字是 Harry
在这个例子中,%s被替换为提供的参数 "Harry",实现了预期的字符串拼接效果。
字面量百分号%引发的问题
然而,当格式化字符串中需要包含字面量百分号%,并且同时存在其他格式化占位符时,就可能出现问题。java.util.Formatter类(String.format()底层使用的类)将单个百分号%视为一个格式说明符的开始。如果%后面没有紧跟一个有效的转换字符(如s, d, f等),或者它不是一个合法的格式说明符的一部分,Formatter就会抛出UnknownFormatConversionException运行时异常。
考虑以下场景,我们希望在字符串中同时包含一个动态值和一个字面量百分号:
立即学习“Java免费学习笔记(深入)”;
String format = "您的名字是 %s, 100%point"; String name = String.format(format, "Harry"); System.out.print(name); // 期望输出: 您的名字是 Harry, 100%point
运行上述代码,会得到如下错误信息:
java.util.UnknownFormatConversionException: Conversion = 'p'
at java.util.Formatter$FormatSpecifier.conversion(Formatter.java:2781)
at java.util.Formatter$FormatSpecifier.(Formatter.java:2811)
at java.util.Formatter$FormatSpecifierParser.(Formatter.java:2624)
at java.util.Formatter.parse(Formatter.java:2557)
at java.util.Formatter.format(Formatter.java:2504)
at java.util.Formatter.format(Formatter.java:2458)
at java.lang.String.format(String.java:2842) 这个错误表明,Formatter在解析到100%point中的%p时,将其识别为一个非法的格式转换符,因为p不是一个标准的转换字符。
解决方案:转义百分号%%
为了在String.format()中正确地显示字面量百分号%,需要对其进行转义。转义的方法是使用两个连续的百分号%%。当Formatter遇到%%时,它会将其解释为一个字面量的百分号字符,而不是一个格式说明符的开始。
修改后的代码如下:
String format = "您的名字是 %s, 100%%point"; // 注意这里是 100%%point String name = String.format(format, "Harry"); System.out.print(name); // 正确输出: 您的名字是 Harry, 100%point
通过将%point改为%%point,程序成功地输出了预期的结果,避免了运行时异常。
注意事项与总结
- 通用规则:%%是java.util.Formatter(以及所有基于此的格式化方法,如String.format()、PrintStream.printf()等)中表示字面量百分号的通用转义序列。
- 错误原因:UnknownFormatConversionException通常意味着格式字符串中存在不被识别的格式说明符。当单个%后面没有跟着有效的转换字符时,就会触发此异常。
- 代码健壮性:在构建动态格式字符串时,如果字符串内容可能包含百分号,务必考虑进行适当的转义,以避免潜在的运行时错误,提高程序的健壮性。
- 避免混淆:务必区分格式化占位符(如%s、%d)和字面量百分号(需要%%转义)。
掌握String.format()中百分号的转义机制,对于编写高质量、无错误的Java字符串处理代码至关重要。










