Struct ReadFuture 

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

Future for file read operations.

This future polls the completion queue until the read operation completes, then returns the number of bytes read and buffer ownership. The future ensures proper cleanup of waker registrations and handles both successful completions and error conditions.

Type Parameters

• 'ring - Lifetime of the io_uring Ring instance
• 'buf - Lifetime of the buffer used for the read operation

Returns

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

• usize is the number of bytes read
• Pin<&'buf mut [u8]> is the buffer with read data

Examples

let mut ring = Ring::new(32)?;
let mut buffer = PinnedBuffer::with_capacity(1024);
let file = File::open("example.txt")?;

// Buffer lifetime must outlive the operation
let read_future = ring.read(file.as_raw_fd(), buffer.as_mut_slice())?;
let (bytes_read, _buffer) = read_future.await?;

println!("Read {} bytes", bytes_read);

Trait Implementations

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

fn drop(&mut self)

Executes the destructor for this type.

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

type Output = Result<(usize, 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.