Struct VectoredReadFuture 

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

Future for vectored read operations.

This future handles scatter-gather reads that operate on multiple buffers simultaneously, allowing for efficient I/O when data needs to be read into multiple non-contiguous memory regions. Returns the total bytes read and ownership of all buffers when the operation completes.

Type Parameters

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

Returns

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

• usize is the total number of bytes read across all buffers
• Vec<Pin<&'buf mut [u8]>> are all the buffers containing read data

Examples

let mut ring = Ring::new(32)?;
let file = File::open("data.bin")?;

// Create buffers for vectored read
let mut header_buf = PinnedBuffer::with_capacity(512);
let mut data_buf = PinnedBuffer::with_capacity(4096);
let buffers = vec![header_buf.as_mut_slice(), data_buf.as_mut_slice()];

let read_future = ring.read_vectored(file.as_raw_fd(), buffers)?;
let (total_bytes, _buffers) = read_future.await?;

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

Trait Implementations

impl<'ring, 'buf> Drop for VectoredReadFuture<'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 VectoredReadFuture<'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.