Struct wasi_common::pipe::WritePipe

pub struct WritePipe<W: Write> { /* fields omitted */ }

A virtual pipe write end.

use wasi_common::{pipe::WritePipe, WasiCtx, Table};
let stdout = WritePipe::new_in_memory();
// Brint these instances from elsewhere (e.g. wasi-cap-std-sync):
let random = todo!();
let clocks = todo!();
let sched = todo!();
let table = Rc::new(RefCell::new(Table::new()));
let ctx = WasiCtx::builder(random, clocks, sched, table)
            .stdout(Box::new(stdout.clone()))
            .build();
// use ctx in an instance, then make sure it is dropped:
drop(ctx);
let contents: Vec<u8> = stdout.try_into_inner().expect("sole remaining reference to WritePipe").into_inner();
println!("contents of stdout: {:?}", contents);

Implementations

impl<W: Write> WritePipe<W>

pub fn new(w: W) -> Self

Create a new pipe from a Write type.

All Handle write operations delegate to writing to this underlying writer.

pub fn from_shared(writer: Arc<RwLock<W>>) -> Self

Create a new pipe from a shareable Write type.

All Handle write operations delegate to writing to this underlying writer.

pub fn try_into_inner(self) -> Result<W, Self>

Try to convert this WritePipe<W> back to the underlying W type.

This will fail with Err(self) if multiple references to the underlying W exist.

impl WritePipe<Cursor<Vec<u8>>>

pub fn new_in_memory() -> Self

Create a new writable virtual pipe backed by a Vec<u8> buffer.

Trait Implementations

impl<W: Write> Clone for WritePipe<W>

fn clone(&self) -> Self

Returns a copy of the value.

pub fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<W: Debug + Write> Debug for WritePipe<W>

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

Formats the value using the given formatter.

impl<W: Write + Any> WasiFile for WritePipe<W>

fn as_any(&self) -> &dyn Any

fn datasync(&self) -> Result<(), Error>

fn sync(&self) -> Result<(), Error>

fn get_filetype(&self) -> Result<FileType, Error>

fn get_fdflags(&self) -> Result<FdFlags, Error>

fn set_fdflags(&mut self, _fdflags: FdFlags) -> Result<(), Error>

fn get_filestat(&self) -> Result<Filestat, Error>

fn set_filestat_size(&self, _size: u64) -> Result<(), Error>

fn advise(&self, offset: u64, len: u64, advice: Advice) -> Result<(), Error>

fn allocate(&self, offset: u64, len: u64) -> Result<(), Error>

fn read_vectored(&self, bufs: &mut [IoSliceMut<'_>]) -> Result<u64, Error>

fn read_vectored_at(
    &self,
    bufs: &mut [IoSliceMut<'_>],
    offset: u64
) -> Result<u64, Error>

fn write_vectored(&self, bufs: &[IoSlice<'_>]) -> Result<u64, Error>

fn write_vectored_at(
    &self,
    bufs: &[IoSlice<'_>],
    offset: u64
) -> Result<u64, Error>

fn seek(&self, pos: SeekFrom) -> Result<u64, Error>

fn peek(&self, buf: &mut [u8]) -> Result<u64, Error>

fn set_times(
    &self,
    atime: Option<SystemTimeSpec>,
    mtime: Option<SystemTimeSpec>
) -> Result<(), Error>

fn num_ready_bytes(&self) -> Result<u64, Error>