Roll

| ALPHA-VISION® DCS

## Roll

### Syntax

`Roll(num_of_entries);`

### Stack

1. Fehlende Argumente werden vom Stack entnommen (und von dort entfernt).
2. Die Reihenfolge der angegebenen Elemente wird auf dem Stack geändert.
3. Der Job hat keinen Rückgabewert

### Wirkung

Die angegebenen Elemente werden auf dem Stack nach unten oder nach oben gerollt.

### Argumente

num_of_entries (Ganzzahl)
  Die Anzahl der Elemente auf dem Stack, die vertauscht werden sollen.
  0, 1 oder -1 hat keine Wirkung
  <0 Das oberste Element des Stack wird an die Stelle des n-ten elments gesetzt, die nachfolgenden n-1 Elemente rutschen nach oben.
  >0 Das n-te Element wird ganz oben auf dem Stack abgelegt, die n-1 Elemente darüber rutschen nach unten.
  Ist num_of_entries größer als die Anzahl der Elemente auf dem Stack, ??????

### Beispiel

    //Stack vorher (4 Elemente):
    //"a"
    //"b"
    //"c"
    //"d"
    Roll(3);
    //Stack nachher (4 Elemente):
    //"c"
    //"a"
    //"b"
    //"d"

    //Stack vorher (5 Elemente):
    //-3
    //"a"
    //"b"
    //"c"
    //"d"
    Roll();
    //Stack nachher (4 Elemente):
    //"b"
    //"c"
    //"a"
    //"d"