Drop

SUMMARY

Drop - Defines the number of elements that should be removed from the stack

SYNTAX

Drop(<num_of_entries>);

ARGUMENTS

num_of_entries (type:integer)
The number of elements that should be removed from the stack 0 does not have any effect. If 'num_of_entries' is higher than the number of stack elements all elements are removed.

DESCRIPTION

Stack
  1. Missing arguments are taken from the stack.(and removed from there).
  2. The defined number of elements is removed from the stack.
  3. The job does not have a return value.

Effect
The defined number of elements is removed from the stack.

EXAMPLES

//Stack before (4 Elements):
//"a"
//"b"
//"c"
//"d"
Drop(3);
//Stack afterwards (1 Element):
//"d"

//Stack before (4 Elemente):
//2
//"a"
//"b"
//"c"
Drop();
//Stack afterwards (1 Element):
//"c"


Syntax Notation
[aaa]
aaa is optional (zero or one occurences)
(aaa|bbb)
aaa exclusive or bbb
(aaa)*
aaa may occur indefinitely often or may be omitted
(aaa)+
aaa may occur indefinitely often but at least once
(aaa)m..n
aaa may occur from m to n times