Java String.format()中百分号%的转义与混合使用

理解 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.<init>(Formatter.java:2811)
        at java.util.Formatter$FormatSpecifierParser.<init>(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，程序成功地输出了预期的结果，避免了运行时异常。

注意事项与总结

1. 通用规则：%%是java.util.Formatter（以及所有基于此的格式化方法，如String.format()、PrintStream.printf()等）中表示字面量百分号的通用转义序列。
2. 错误原因：UnknownFormatConversionException通常意味着格式字符串中存在不被识别的格式说明符。当单个%后面没有跟着有效的转换字符时，就会触发此异常。
3. 代码健壮性：在构建动态格式字符串时，如果字符串内容可能包含百分号，务必考虑进行适当的转义，以避免潜在的运行时错误，提高程序的健壮性。
4. 避免混淆：务必区分格式化占位符（如%s、%d）和字面量百分号（需要%%转义）。

掌握String.format()中百分号的转义机制，对于编写高质量、无错误的Java字符串处理代码至关重要。

以上就是Java String.format()中百分号%的转义与混合使用的详细内容，更多请关注php中文网其它相关文章！