pop

Use the pop command to retrieve a previously-stored context of bindings and selected objects from the top of the context stack. This command replaces the current ADEdit context with the retrieved context. Popping a context from the context stack removes the context from the stack.

This command is useful for Tcl scripts that use subroutines. A push can save the context before it’s altered in the subroutine; a pop can return the saved context when the subroutine returns.

Zone type

Not applicable

Syntax

pop

Abbreviation

None.

Options

This command takes no options.

Arguments

This command takes no arguments.

Return value

This command returns nothing if it runs successfully. If the stack is empty, it returns a message stating so.

Examples

pop

This example retrieves the context from the top of the context stack and uses it as the current ADEdit context.

Related commands

The following commands perform actions related to this command:

  • show returns the current context of ADEdit, including its bound domains and its currently selected objects.
  • push saves the current ADEdit context to the ADEdit context stack.