Struct wasmtime_wasi::preview2::table::Table

pub struct Table { /* private fields */ }

The Table type is designed to map u32 handles to resources. The table is now part of the public interface to a WasiCtx - it is reference counted so that it can be shared beyond a WasiCtx with other WASI proposals (e.g. wasi-crypto and wasi-nn) to manage their resources. Elements in the Table are Any typed.

The Table type is intended to model how the Interface Types concept of Resources is shaping up. Right now it is just an approximation.

Implementations

impl Table

pub fn new() -> Self

Create an empty table. New insertions will begin at 3, above stdio.

pub fn push(&mut self, a: Box<dyn Any + Send + Sync>) -> Result<u32, TableError>

Insert a resource at the next available index.

pub fn contains_key(&self, key: u32) -> bool

Check if the table has a resource at the given index.

pub fn is<T: Any + Sized>(&self, key: u32) -> bool

Check if the resource at a given index can be downcast to a given type. Note: this will always fail if the resource is already borrowed.

pub fn get<T: Any + Sized>(&self, key: u32) -> Result<&T, TableError>

Get an immutable reference to a resource of a given type at a given index. Multiple immutable references can be borrowed at any given time. Borrow failure results in a trapping error.

pub fn get_mut<T: Any + Sized>( &mut self, key: u32 ) -> Result<&mut T, TableError>

Get a mutable reference to a resource of a given type at a given index. Only one mutable reference can be borrowed at any given time. Borrow failure results in a trapping error.

pub fn delete<T: Any + Sized>(&mut self, key: u32) -> Result<T, TableError>

Remove a resource at a given index from the table.

Trait Implementations

impl Debug for Table

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

Formats the value using the given formatter.

impl TableStreamExt for Table

fn push_input_stream( &mut self, istream: Box<dyn InputStream> ) -> Result<u32, TableError>

fn get_input_stream(&self, fd: u32) -> Result<&dyn InputStream, TableError>

fn get_input_stream_mut( &mut self, fd: u32 ) -> Result<&mut Box<dyn InputStream>, TableError>

fn push_output_stream( &mut self, ostream: Box<dyn OutputStream> ) -> Result<u32, TableError>

fn get_output_stream(&self, fd: u32) -> Result<&dyn OutputStream, TableError>

fn get_output_stream_mut( &mut self, fd: u32 ) -> Result<&mut Box<dyn OutputStream>, TableError>