Rust read_to_string用法及代码示例

将 reader 中的所有字节读取到新的 String 中。

这是 Read::read_to_string 的便利函数。使用此函数避免了必须先创建变量并提供更高的类型安全性，因为只有在没有错误的情况下才能取出缓冲区。 (如果您使用 Read::read_to_string ，您必须记住检查读取是否成功，否则您的缓冲区将为空或仅部分满。)

性能

此函数增加了易用性和类型安全性的缺点是它使您对性能的控制较少。例如，您不能像使用 String::with_capacity 和 Read::read_to_string 那样预先分配内存。此外，如果读取时发生错误，您将无法重新使用缓冲区。

在许多情况下，这个函数的性能是足够的，而且易用性和类型安全的权衡是值得的。但是，在某些情况下您需要对性能进行更多控制，在这些情况下，您绝对应该直接使用 Read::read_to_string 。

请注意，在某些特殊情况下，例如读取文件时，此函数将根据正在读取的输入的大小预先分配内存。在这些情况下，性能应该与您使用带有手动预分配缓冲区的 Read::read_to_string 一样好。

错误

此函数强制您处理错误，因为输出(String)包含在 Result 中。有关可能发生的错误，请参阅 Read::read_to_string 。如果发生任何错误，您将得到 Err ，因此您不必担心缓冲区为空或部分已满。

例子

#![feature(io_read_to_string)]

fn main() -> io::Result<()> {
    let stdin = io::read_to_string(&mut io::stdin())?;
    println!("Stdin was:");
    println!("{}", stdin);
    Ok(())
}