Struct tokio::io::util::mem::Pipe

struct Pipe {
    buffer: BytesMut,
    is_closed: bool,
    max_buf_size: usize,
    read_waker: Option<Waker>,
    write_waker: Option<Waker>,
}

A unidirectional IO over a piece of memory.

Data can be written to the pipe, and reading will return that data.

Fields

buffer: BytesMut

The buffer storing the bytes written, also read from.

Using a BytesMut because it has efficient Buf and BufMut functionality already. Additionally, it can try to copy data in the same buffer if there read index has advanced far enough.

is_closed: bool

Determines if the write side has been closed.

max_buf_size: usize

The maximum amount of bytes that can be written before returning Poll::Pending.

read_waker: Option<Waker>

If the read side has been polled and is pending, this is the waker for that parked task.

write_waker: Option<Waker>

If the write side has filled the max_buf_size and returned Poll::Pending, this is the waker for that parked task.

Implementations

impl Pipe

fn new(max_buf_size: usize) -> Self

fn close_write(&mut self)

fn close_read(&mut self)

fn poll_read_internal( self: Pin<&mut Self>, cx: &mut Context<'_>, buf: &mut ReadBuf<'_> ) -> Poll<Result<()>>

fn poll_write_internal( self: Pin<&mut Self>, cx: &mut Context<'_>, buf: &[u8] ) -> Poll<Result<usize>>

fn poll_write_vectored_internal( self: Pin<&mut Self>, cx: &mut Context<'_>, bufs: &[IoSlice<'_>] ) -> Poll<Result<usize, Error>>

Trait Implementations

impl AsyncRead for Pipe

fn poll_read( self: Pin<&mut Self>, cx: &mut Context<'_>, buf: &mut ReadBuf<'_> ) -> Poll<Result<()>>

Attempts to read from the AsyncRead into buf.

impl AsyncWrite for Pipe

fn poll_write( self: Pin<&mut Self>, cx: &mut Context<'_>, buf: &[u8] ) -> Poll<Result<usize>>

Attempt to write bytes from buf into the object.

fn poll_write_vectored( self: Pin<&mut Self>, cx: &mut Context<'_>, bufs: &[IoSlice<'_>] ) -> Poll<Result<usize, Error>>

Like poll_write, except that it writes from a slice of buffers.

fn is_write_vectored(&self) -> bool

Determines if this writer has an efficient poll_write_vectored implementation.

fn poll_flush(self: Pin<&mut Self>, _: &mut Context<'_>) -> Poll<Result<()>>

Attempts to flush the object, ensuring that any buffered data reach their destination.

fn poll_shutdown(self: Pin<&mut Self>, _: &mut Context<'_>) -> Poll<Result<()>>

Initiates or attempts to shut down this writer, returning success when the I/O connection has completely shut down.

impl Debug for Pipe

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.