Rust Write.write_all_vectored用法及代碼示例

用法

fn write_all_vectored(&mut self, bufs: &mut [IoSlice<'_>]) -> Result<()>

嘗試將多個緩衝區寫入此寫入器。

此方法將不斷調用 write_vectored ，直到沒有更多數據要寫入或返回非 ErrorKind::Interrupted 類型的錯誤。在所有緩衝區都已成功寫入或發生此類錯誤之前，此方法不會返回。將返回由該方法生成的第一個不屬於 ErrorKind::Interrupted 類型的錯誤。

如果緩衝區不包含數據，則永遠不會調用 write_vectored 。

注意

不像std::io::Write.write_vectored，這需要一個可變的引用切片IoSlices，不是一成不變的。這是因為我們需要修改切片以跟蹤已寫入的字節。

此函數返回後，bufs 的內容未指定，因為這取決於需要多少次調用 write_vectored 。最好將此函數理解為擁有bufs 的所有權，之後不要使用bufs。 IoSlice s 指向的底層緩衝區(但不是 IoSlice s 本身)不變並且可以重複使用。

例子

#![feature(write_all_vectored)]

use std::io::{Write, IoSlice};

let mut writer = Vec::new();
let bufs = &mut [
    IoSlice::new(&[1]),
    IoSlice::new(&[2, 3]),
    IoSlice::new(&[4, 5, 6]),
];

writer.write_all_vectored(bufs)?;
// Note: the contents of `bufs` is now undefined, see the Notes section.

assert_eq!(writer, &[1, 2, 3, 4, 5, 6]);