Struct VectoredWriteFuture 

pub struct VectoredWriteFuture<'ring, 'buf> { /* private fields */ }

Future for vectored write operations.

This future handles gather writes that operate on multiple buffers simultaneously, allowing for efficient I/O when data from multiple non-contiguous memory regions needs to be written in a single operation. Returns the total bytes written and ownership of all buffers when complete.

Type Parameters

• 'ring - Lifetime of the io_uring Ring instance
• 'buf - Lifetime of all buffers used for the vectored write

Returns

Returns (usize, Vec<Pin<&'buf mut [u8]>>) on success where:

• usize is the total number of bytes written from all buffers
• Vec<Pin<&'buf mut [u8]>> are all the buffers that were written from

Examples

let mut ring = Ring::new(32)?;
let file = OpenOptions::new()
    .write(true)
    .create(true)
    .open("output.bin")?;

// Create buffers for vectored write
let mut header_buf = PinnedBuffer::from_slice(b"HEADER: ");
let mut data_buf = PinnedBuffer::from_slice(b"Important data content");
let buffers = vec![header_buf.as_mut_slice(), data_buf.as_mut_slice()];

let write_future = ring.write_vectored(file.as_raw_fd(), buffers)?;
let (total_bytes, _buffers) = write_future.await?;

println!("Wrote {} bytes total", total_bytes);

Trait Implementations

impl<'ring, 'buf> Drop for VectoredWriteFuture<'ring, 'buf>

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.

impl<'ring, 'buf> Future for VectoredWriteFuture<'ring, 'buf>

type Output = Result<(usize, Vec<Pin<&'buf mut [u8]>>), Error>

The type of value produced on completion.

fn poll(self: StdPin<&mut Self>, cx: &mut Context<'_>) -> Poll<Self::Output>

Attempts to resolve the future to a final value, registering the current task for wakeup if the value is not yet available.