Rust Write.write用法及代碼示例

用法

fn write(&mut self, buf: &[u8]) -> Result<usize>

將緩衝區寫入此寫入器，返回寫入的字節數。

該函數將嘗試寫入的全部內容buf，但整個寫入可能不會成功，或者寫入也可能會產生錯誤。調用write代表最多一個嘗試寫入任何包裝的對象。

對write 的調用不能保證阻塞等待寫入數據，並且可以通過 Err 變體指示否則會阻塞的寫入。

如果返回值為 Ok(n) 那麽必須保證 n <= buf.len() 。 0 的返回值通常意味著底層對象不再能夠接受字節並且將來也可能無法接受，或者提供的緩衝區為空。

錯誤

對write 的每次調用都可能生成一個指示操作無法完成的 I/O 錯誤。如果返回錯誤，則緩衝區中的任何字節都不會寫入此寫入器。

如果無法將整個緩衝區寫入此寫入器，則不會將其視為錯誤。

ErrorKind::Interrupted 類型的錯誤是非致命的，如果沒有其他事情可做，則應重試寫入操作。

例子

use std::io::prelude::*;
use std::fs::File;

fn main() -> std::io::Result<()> {
    let mut buffer = File::create("foo.txt")?;

    // Writes some prefix of the byte string, not necessarily all of it.
    buffer.write(b"some bytes")?;
    Ok(())
}