ALPHA-VISION® Stack Manipulation: Pick

Pick

SUMMARY

Pick - The defined element is duplicated on the stack.

SYNTAX

Pick(<entry>);

ARGUMENTS

entry (type:integer)

The element on the stack that should be duplicated. 0 is the top level element. Pick(0) got the same result as Dup(1). >0 defines the Element counting from the top. <0 defines the Element counting from the bottom. If 'entry' is higher than the number of stack elements a NULL is put on the top of the stack.

DESCRIPTION

1. Missing arguments are taken from the stack.(and removed from there).
2. The defined element is duplicated on the stack.
3. The job does not have a return value.

The defined element is duplicated and put on top of the stack.

EXAMPLES

//Stack before (4 Elements):
//"a"
//"b"
//"c"
//"d"
Pick(2);
//Stack afterwards (5 Elements):
//"c"
//"a"
//"b"
//"c"
//"d"

//Stack before (5 Elements):
//-2
//"a"
//"b"
//"c"
//"d"
Pick();
//Stack afterwards (5 Elements):
//"c"
//"a"
//"b"
//"c"
//"d"

---

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