引言：字符串特定位置替换的需求
在软件开发中，经常会遇到需要生成特定模式的字符串，并对其中某个位置的字符进行修改的场景。例如，生成一串点（...），然后在指定位置将其中的一个点替换为其他字符（如#），最终得到类似..#...的效果。这种需求在命令行工具、进度条显示或简单的文本格式化中都非常常见。本教程将探讨如何在java中优雅且高效地实现这一功能。
初始尝试与StringBuilder
对于字符串的修改，Java中的String类是不可变的，这意味着一旦创建，就不能更改其内容。因此，如果需要修改字符串，通常会借助于StringBuilder或StringBuffer类，它们提供了可变的字符序列。
一个直观的实现方式是首先生成包含所有点的字符串，然后将其转换为StringBuilder，再使用setCharAt()方法在指定索引处替换字符。
考虑以下初始尝试的代码：
public class StringReplacementDemo {
/**
* 生成指定长度的点线，并在特定位置替换为'#'。
*
* @param length 点线的总长度。
* @param position 要替换字符的0-based索引位置。
* @return 替换后的字符串。
*/
public static String printSingleDotInitial(int length, int position) {
if (length <= 0) {
return ""; // 长度非正，返回空字符串
}
if (position < 0 || position >= length) {
// 位置越界，可以抛出异常或返回原字符串，这里选择返回原字符串
return ".".repeat(length);
}
String lineOfDots = ".".repeat(length); // 生成指定长度的点线
StringBuilder sb = new StringBuilder(lineOfDots);
sb.setCharAt(position, '#'); // 在指定位置替换字符
return sb.toString(); // 返回修改后的字符串
}
public static void main(String[] args) {
System.out.println(printSingleDotInitial(10, 3)); // 输出: ...#......
System.out.println(printSingleDotInitial(5, 0)); // 输出: #....
System.out.println(printSingleDotInitial(7, 6)); // 输出: ......#
System.out.println(printSingleDotInitial(5, 5)); // 输出: ..... (位置越界，返回原字符串)
}
}解析：
立即学习“Java免费学习笔记（深入）”；
- ".".repeat(length)：这是Java 11引入的便捷方法，用于重复字符串length次，快速生成所需长度的点线。
- new StringBuilder(lineOfDots)：将生成的点线字符串转换为StringBuilder对象，使其可变。
- sb.setCharAt(position, '#')：这是StringBuilder的核心方法之一，允许在指定的position（0-based索引）处替换字符。
- return sb.toString()：将修改后的StringBuilder转换回String并返回。
注意事项：
- position参数通常被视为0-based索引，即第一个字符的索引是0。如果需求中position是1-based（例如，第1个位置），则需要在使用前将其调整为position - 1。
- 需要对length和position进行有效的输入验证，以避免IndexOutOfBoundsException或产生非预期的结果。
优化方案：基于String.repeat()的高效构建
虽然StringBuilder.setCharAt()方法有效，但我们还可以通过更直接的拼接方式来构建目标字符串，尤其是在已知替换位置的情况下。这种方法可以避免先生成完整点线再修改的步骤，而是直接拼接三部分：替换字符前的点、替换字符本身、替换字符后的点。
以下是优化后的实现方案：
public class StringReplacementOptimized {
/**
* 生成指定长度的点线，并在特定位置替换为'#'。
* 采用直接拼接的方式，避免先生成完整字符串再修改。
*
* @param length 点线的总长度。
* @param position 要替换字符的0-based索引位置。
* @return 替换后的字符串。
*/
public static String printSingleDotOptimized(int length, int position) {
// 1. 输入参数的基本校验
if (length <= 0) {
return ""; // 长度非正，返回空字符串
}
// 2. 边界条件处理：如果位置越界
// 这里的处理方式是，如果position >= length，则只返回一个'#'。
// 这种处理方式是特定于原始问题的，更通用的做法可能是抛出异常或返回原字符串。
if (position < 0 || position >= length) {
// 示例：如果position超出有效范围，可以返回原始点线或抛出异常
// 这里我们遵循原始答案的逻辑，如果position >= length，返回"#"
// 如果position < 0，则可以返回原始点线或抛出异常
if (position < 0) {
return ".".repeat(length); // position为负，返回原始点线
} else { // position >= length
return "#"; // 遵循原始答案的特定处理
}
}
// 3. 使用StringBuilder高效拼接三部分
return new StringBuilder()
.append(".".repeat(position)) // 替换字符前的点
.append("#") // 替换字符本身
.append(".".repeat(length - position - 1)) // 替换字符后的点
.toString();
}
public static void main(String[] args) {
System.out.println(printSingleDotOptimized(10, 3)); // 输出: ...#......
System.out.println(printSingleDotOptimized(5, 0)); // 输出: #....
System.out.println(printSingleDotOptimized(7, 6)); // 输出: ......#
System.out.println(printSingleDotOptimized(5, 5)); // 输出: # (遵循原始答案的特定处理)
System.out.println(printSingleDotOptimized(5, -1)); // 输出: ..... (position为负，返回原始点线)
}
}代码示例解析：
- 参数校验： 首先对length进行基本校验，确保其为正数。
-
边界条件处理：
- if (position
- if (position >= length)：如果position大于或等于length，意味着它超出了有效索引范围（0到length-1）。原始答案在此处返回了单个"#"。这是一种非常具体的业务逻辑，在实际应用中，你可能更倾向于抛出IndexOutOfBoundsException或返回原始的点线字符串，以提供更明确的错误指示或默认行为。本教程保留了原始答案的这一特殊处理，但建议读者根据实际需求调整。
-
StringBuilder拼接：
- ".".repeat(position)：生成替换字符前的点。例如，如果position是3，则生成...。
- append("#")：添加替换字符。
- ".".repeat(length - position - 1)：生成替换字符后的点。length - position - 1计算的是替换字符之后还需要多少个点。例如，总长10，position是3，那么替换字符后还需要10 - 3 - 1 = 6个点。
- toString()：将最终构建的StringBuilder内容转换为String返回。
注意事项
- 索引约定： 在Java中，字符串和数组的索引都是0-based。在设计方法时，务必明确position参数是0-based还是1-based。如果外部调用者习惯1-based，可以在方法内部进行position - 1的转换。
- 输入验证： 对length和position等输入参数进行严格的验证至关重要。例如，length不应为负数，position应在[0, length-1]的有效范围内。不当的输入可能导致IndexOutOfBoundsException或其他逻辑错误。
- 性能考量： 对于少量字符串操作，直接使用+运算符进行字符串拼接可能没有明显性能问题。但当涉及大量拼接或在循环中进行拼接时，StringBuilder（非线程安全，性能稍优）或StringBuffer（线程安全）是更优的选择，因为它们避免了创建大量中间String对象。
- 可读性与维护性： 编写清晰、易懂的代码是良好实践。使用有意义的变量名，添加必要的注释，并保持方法职责单一，都有助于提高代码的可读性和维护性。
- 错误处理： 对于无效的position，是返回默认值、抛出异常还是执行其他逻辑，应根据具体的业务需求和API设计原则来决定。
总结
本文介绍了在Java中生成指定长度字符行并在特定位置替换字符的两种主要方法。初始方法利用StringBuilder.setCharAt()直接修改预生成的字符串，简单直观。优化方案则通过String.repeat()和StringBuilder的组合，直接构建三部分字符串，从而避免了中间字符串的创建，在特定场景下可能更高效。无论选择哪种方法，理解0-based索引、进行严格的输入验证以及妥善处理边界条件是编写健壮代码的关键。
