Struct redo::Queue

pub struct Queue<'a, T, C> { /* private fields */ }

A command queue wrapper.

Wraps a Record or History and gives it batch queue functionality.

Examples

#[derive(Debug)]
struct Add(char);

impl Command<String> for Add {
    type Error = Box<dyn error::Error>;

    fn apply(&mut self, s: &mut String) -> Result<(), Self::Error> {
        s.push(self.0);
        Ok(())
    }

    fn undo(&mut self, s: &mut String) -> Result<(), Self::Error> {
        self.0 = s.pop().ok_or("`s` is empty")?;
        Ok(())
    }
}

fn main() -> redo::Result<String, Add> {
    let mut record = Record::default();
    let mut queue = record.queue();
    queue.apply(Add('a'));
    queue.apply(Add('b'));
    queue.apply(Add('c'));
    assert_eq!(queue.as_receiver(), "");
    queue.commit()?;
    assert_eq!(record.as_receiver(), "abc");
    Ok(())
}

Implementations

impl<T, C> Queue<'_, T, C>

pub fn apply(&mut self, command: C)

Queues an apply action.

pub fn undo(&mut self)

Queues an undo action.

pub fn redo(&mut self)

Queues a redo action.

pub fn cancel(self)

Cancels the queued actions.

impl<R, C: Command<R>> Queue<'_, Record<R, C>, C>

pub fn go_to(&mut self, cursor: usize)

Queues a go_to action.

pub fn commit(self) -> Result<R, C>

Applies the actions that is queued.

Errors

If an error occurs, it stops applying the actions and returns the error.

pub fn checkpoint(&mut self) -> Checkpoint<'_, Record<R, C>, C>

Returns a checkpoint.

pub fn queue(&mut self) -> Queue<'_, Record<R, C>, C>

Returns a queue.

pub fn as_receiver(&self) -> &R

Returns a reference to the receiver.

pub fn as_mut_receiver(&mut self) -> &mut R

Returns a mutable reference to the receiver.

This method should only be used when doing changes that should not be able to be undone.

impl<R, C: Command<R>> Queue<'_, History<R, C>, C>

pub fn go_to(&mut self, branch: usize, cursor: usize)

Queues a go_to action.

pub fn commit(self) -> Result<R, C>

Applies the actions that is queued.

Errors

If an error occurs, it stops applying the actions and returns the error.

pub fn checkpoint(&mut self) -> Checkpoint<'_, History<R, C>, C>

Returns a checkpoint.

pub fn queue(&mut self) -> Queue<'_, History<R, C>, C>

Returns a queue.

pub fn as_receiver(&self) -> &R

Returns a reference to the receiver.

pub fn as_mut_receiver(&mut self) -> &mut R

Returns a mutable reference to the receiver.

This method should only be used when doing changes that should not be able to be undone.

Trait Implementations

impl<R, C: Command<R>> AsMut<R> for Queue<'_, History<R, C>, C>

fn as_mut(&mut self) -> &mut R

Converts this type into a mutable reference of the (usually inferred) input type.

impl<R, C: Command<R>> AsMut<R> for Queue<'_, Record<R, C>, C>

fn as_mut(&mut self) -> &mut R

Converts this type into a mutable reference of the (usually inferred) input type.

impl<R, C: Command<R>> AsRef<R> for Queue<'_, History<R, C>, C>

fn as_ref(&self) -> &R

Converts this type into a shared reference of the (usually inferred) input type.

impl<R, C: Command<R>> AsRef<R> for Queue<'_, Record<R, C>, C>

fn as_ref(&self) -> &R

Converts this type into a shared reference of the (usually inferred) input type.

impl<'a, T: Debug, C: Debug> Debug for Queue<'a, T, C>

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

Formats the value using the given formatter.

impl<'a, T, C> From<&'a mut T> for Queue<'a, T, C>

fn from(inner: &'a mut T) -> Self

Converts to this type from the input type.