Struct Runtime

Source
pub struct Runtime { /* private fields */ }
Available on crate features rt-current-thread or rt-full only.
Expand description

Single-threaded runtime provides a way to start reactor and executor on the current thread.

See module level documentation for more details.

Implementations§

Source§

impl Runtime

Source

pub fn new() -> Result<Runtime>

Returns a new runtime initialized with default configuration values.

Source

pub fn handle(&self) -> Handle

Get a new handle to spawn futures on the single-threaded Tokio runtime

Different to the runtime itself, the handle can be sent to different threads.

Unlike the tokio 0.1 current_thread::Handle, this handle can spawn both futures 0.1 and std::future tasks.

Source

pub fn spawn<F>(&mut self, future: F) -> &mut Self
where F: Future01<Item = (), Error = ()> + 'static,

Spawn a futures 0.1 future onto the single-threaded Tokio runtime.

See module level documentation for more details.

§Examples
use tokio_compat::runtime::current_thread::Runtime;

// Create the runtime
let mut rt = Runtime::new().unwrap();

// Spawn a future onto the runtime
rt.spawn(futures_01::future::lazy(|| {
    println!("now running on a worker thread");
    Ok(())
}));
Source

pub fn spawn_std<F>(&mut self, future: F) -> &mut Self
where F: Future<Output = ()> + 'static,

Spawn a std::future future onto the single-threaded Tokio runtime.

See module level documentation for more details.

§Examples
use tokio_compat::runtime::current_thread::Runtime;

// Create the runtime
let mut rt = Runtime::new().unwrap();

// Spawn a future onto the runtime
rt.spawn_std(async {
    println!("now running on a worker thread");
});
Source

pub fn block_on<F>(&mut self, f: F) -> Result<F::Item, F::Error>
where F: Future01,

Runs the provided futures 0.1 future, blocking the current thread until the future completes.

This function can be used to synchronously block the current thread until the provided future has resolved either successfully or with an error. The result of the future is then returned from this function call.

Note that this function will also execute any spawned futures on the current thread, but will not block until these other spawned futures have completed. Once the function returns, any uncompleted futures remain pending in the Runtime instance. These futures will not run until block_on or run is called again.

The caller is responsible for ensuring that other spawned futures complete execution by calling block_on or run.

Source

pub fn block_on_std<F>(&mut self, f: F) -> F::Output
where F: Future,

Runs the provided std::future future, blocking the current thread until the future completes.

This function can be used to synchronously block the current thread until the provided future has resolved either successfully or with an error. The result of the future is then returned from this function call.

Note that this function will also execute any spawned futures on the current thread, but will not block until these other spawned futures have completed. Once the function returns, any uncompleted futures remain pending in the Runtime instance. These futures will not run until block_on or run is called again.

The caller is responsible for ensuring that other spawned futures complete execution by calling block_on or run.

Source

pub fn run(&mut self) -> Result<(), RunError>

Run the executor to completion, blocking the thread until all spawned futures have completed.

Source

pub fn enter<F, R>(&self, f: F) -> R
where F: FnOnce() -> R,

Enter the runtime context

Trait Implementations§

Source§

impl Debug for Runtime

Source§

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

Formats the value using the given formatter. Read more

Auto Trait Implementations§

§

impl !Freeze for Runtime

§

impl !RefUnwindSafe for Runtime

§

impl !Send for Runtime

§

impl !Sync for Runtime

§

impl Unpin for Runtime

§

impl !UnwindSafe for Runtime

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.