dbUndoToHandle

dbUndoToHandle(
[ t_handleName ]
)
=> t / nil

Description

Invokes undo back to the given handle. If no handle name is given, rolls back to the last labeled checkpoint.

dbUndoToHandle depends on the HI event loop just like hiUndo, and has the same limitations as hiUndo. For example, dbUndoToHandle cannot be called from within a SKILL procedure.

Arguments

t_handleName

Handle name that was set using dbSetUndoHandle.

Value Returned

t	The undo was invoked.
nil	The undo was not invoked.

Examples

Rolls back to the undo handle checkpoint5.

dbUndoToHandle("checkpoint5")

dbUndoToHandle()

Related Topics

hiUndo

dbSetUndoHandle

Undo and Redo Functions

Return to top