Struct WriteFuture 

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

Future for file write operations.

This future polls the completion queue until the write operation completes, then returns the number of bytes written and buffer ownership. Like all I/O futures in this crate, it ensures proper resource cleanup and handles error conditions gracefully.

Type Parameters

• 'ring - Lifetime of the io_uring Ring instance
• 'buf - Lifetime of the buffer containing data to write

Returns

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

• usize is the number of bytes written
• Pin<&'buf mut [u8]> is the buffer that was written from

Examples

let mut ring = Ring::new(32)?;
let mut buffer = PinnedBuffer::from_slice(b"Hello, world!");
let file = OpenOptions::new()
    .write(true)
    .create(true)
    .open("output.txt")?;

let write_future = ring.write(file.as_raw_fd(), buffer.as_mut_slice())?;
let (bytes_written, _buffer) = write_future.await?;

println!("Wrote {} bytes", bytes_written);

Trait Implementations

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

fn drop(&mut self)

Executes the destructor for this type.

impl<'ring, 'buf> Future for WriteFuture<'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.