Struct Console 

pub struct Console { /* private fields */ }

A console with a byte output buffer and a byte input queue.

Implementations

impl Console

pub fn new() -> Console

A console with no pending input.

pub fn with_input(input: impl Into<Vec<u8>>) -> Console

A console preloaded with input, and closed.

Closed because a caller supplying all its input at once has no more to give, and a guest that waited for more would wait forever.

pub fn output(&self) -> &[u8]

Everything written to the console so far.

pub fn output_string(&self) -> String

The output interpreted as UTF-8, replacing invalid sequences.

pub fn has_input(&self) -> bool

True while input is waiting. Also the console’s interrupt condition.

pub fn close(&mut self)

Declares that no further input will arrive.

The status register then reads negative once the queue drains, which is how a guest learns to stop rather than wait.

pub fn take_starved(&mut self) -> bool

True if the guest has read the status and found nothing waiting.

An interactive host polls this to know when the guest is waiting on a person, and reads a line only then. Reading the flag clears it.

pub fn push_input(&mut self, bytes: &[u8])

Queues input bytes for the guest to read.

Trait Implementations

impl Default for Console

fn default() -> Console

Returns the “default value” for a type.

impl Device for Console

fn name(&self) -> &'static str

A name, used in error messages.

fn read(&mut self, offset: i64) -> Result<Tryte, MemoryError>

Reads one tryte. May have side effects.

fn write(&mut self, offset: i64, value: Tryte) -> Result<(), MemoryError>

Writes one tryte.