C# 中的 StringBuilder.CopyTo 方法

在 C# 中，StringBuilder 类是用于处理字符串的一个非常方便的工具。它可以帮助我们高效地构建和修改字符串，避免了频繁地创建新字符串所带来的性能问题。

其中 CopyTo 方法是 StringBuilder 中的一个重要方法，它可以将 StringBuilder 中的内容复制到一个字符数组中。

语法

CopyTo 方法有两个不同的重载：

public void CopyTo(int sourceIndex, char[] destination, int destinationIndex, int count);
public void CopyTo(char[] destination);

第一个重载允许我们指定源字符串的起始位置、目标字符数组的起始位置和复制的字符数，用于精确地控制复制的过程；第二个重载则可以让我们方便地复制整个字符串。

示例

下面是使用 CopyTo 方法复制字符串的示例代码：

StringBuilder sb = new StringBuilder("Hello, world!");
char[] destination = new char[6];
sb.CopyTo(0, destination, 0, 6);
Console.WriteLine(destination);  // 输出：Hello,

在上面的代码中，我们首先创建了一个 StringBuilder 对象，并向其中添加了一个字符串。然后我们创建了一个字符数组 destination，并调用 CopyTo 方法将从 StringBuilder 中索引为 0 的位置开始的 6 个字符复制到 destination 数组中。

最后，我们输出了 destination 数组的内容，也就是从 StringBuilder 中复制的内容："Hello,"。

注意事项

在使用 CopyTo 方法时，需要注意以下几点：

1. CopyTo 方法会将源字符串中的指定部分复制到目标字符数组中，并且不会改变源字符串本身，因此这是一个安全的操作。

2. 如果目标字符数组的长度不足以存储复制的字符数，则会抛出 System.ArgumentOutOfRangeException 异常。

3. 如果源字符串中指定的起始位置（即 sourceIndex 参数）大于等于源字符串的长度，则不会发生任何复制操作。

4. 如果 count 参数的值大于源字符串中可用的字符数，则 CopyTo 方法只会复制源字符串中剩余的所有字符。

总结

CopyTo 方法是 StringBuilder 类中一个非常有用的方法，可以让我们方便地将 StringBuilder 中的内容复制到一个字符数组中。它具有良好的安全性和可靠性，并且支持多种不同的用法。因此，在日常的 C# 开发工作中，我们应该熟练掌握 CopyTo 方法的使用技巧。