 |
ALPHA-VISION® Stack Manipulation: Drop
|
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
- Missing arguments are taken from the stack.(and removed from there).
- The defined number of elements is removed from the stack.
- 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