Enum Event 

pub enum Event {
    FocusGained,
    FocusLost,
    Key(KeyEvent),
    Mouse(MouseEvent),
    Paste(String),
    Resize(u16, u16),
}

Available on crate feature term only.

Represents an event.

Variants

FocusGained

The terminal gained focus

FocusLost

The terminal lost focus

Key(KeyEvent)

A single key event with additional pressed modifiers.

Mouse(MouseEvent)

A single mouse event with additional pressed modifiers.

Paste(String)

Available on crate feature bracketed-paste only.

A string that was pasted into the terminal. Only emitted if bracketed paste has been enabled.

Resize(u16, u16)

An resize event with new dimensions after resize (columns, rows). Note that resize events can occur in batches.

Implementations

impl Event

pub fn is_key_press(&self) -> bool

Returns true if the event is a key press event.

This is useful for waiting for any key press event, regardless of the key that was pressed.

Returns false for key release and repeat events (as well as for non-key events).

Examples

The following code runs a loop that processes events until a key press event is encountered:

use crossterm::event;

while !event::read()?.is_key_press() {
    // ...
}

pub fn is_key_release(&self) -> bool

Returns true if the event is a key release event.

pub fn is_key_repeat(&self) -> bool

Returns true if the event is a key repeat event.

pub fn as_key_event(&self) -> Option<KeyEvent>

Returns the key event if the event is a key event, otherwise None.

This is a convenience method that makes apps that only care about key events easier to write.

Examples

The following code runs a loop that only processes key events:

use crossterm::event;

while let Some(key_event) = event::read()?.as_key_event() {
    // ...
}

pub fn as_key_press_event(&self) -> Option<KeyEvent>

Returns an Option containing the KeyEvent if the event is a key press event.

This is a convenience method that makes apps that only care about key press events, and not key release or repeat events (or non-key events), easier to write.

Returns None for key release and repeat events (as well as for non-key events).

Examples

The following code runs a loop that only processes key press events:

use crossterm::event;

while let Ok(event) = event::read() {
    if let Some(key) = event.as_key_press_event() {
        // ...
    }
}

pub fn as_key_release_event(&self) -> Option<KeyEvent>

Returns an Option containing the KeyEvent if the event is a key release event.

pub fn as_key_repeat_event(&self) -> Option<KeyEvent>

Returns an Option containing the KeyEvent if the event is a key repeat event.

pub fn as_mouse_event(&self) -> Option<MouseEvent>

Returns the mouse event if the event is a mouse event, otherwise None.

This is a convenience method that makes code which only cares about mouse events easier to write.

Examples

use crossterm::event;

while let Some(mouse_event) = event::read()?.as_mouse_event() {
    // ...
}

pub fn as_paste_event(&self) -> Option<&str>

Available on crate feature bracketed-paste only.

Returns the pasted string if the event is a paste event, otherwise None.

This is a convenience method that makes code which only cares about paste events easier to write.

Examples

use crossterm::event;

while let Some(paste) = event::read()?.as_paste_event() {
    // ...
}

pub fn as_resize_event(&self) -> Option<(u16, u16)>

Returns the size as a tuple if the event is a resize event, otherwise None.

This is a convenience method that makes code which only cares about resize events easier to write.

Examples

use crossterm::event;

while let Some((columns, rows)) = event::read()?.as_resize_event() {
    // ...
}

Trait Implementations

impl Clone for Event

fn clone(&self) -> Event

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Event

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

Formats the value using the given formatter.

impl Eq for Event

impl Hash for Event

fn hash<__H>(&self, state: &mut __H)

where __H: Hasher,

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for Event

fn eq(&self, other: &Event) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl PartialOrd for Event

fn partial_cmp(&self, other: &Event) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl StructuralPartialEq for Event