# Get

Gibt die Eigenschaften von Arrays und/oder Objekten zurück, die entweder von einer Skript-Funktion oder einer anderen Get-Funktion ausgegeben werden.

## Get – Übersicht

Die Get-Funktion wird verwendet, um auf Eigenschaften von Objekten zuzugreifen, die von einer Script-Funktion zurückgegeben werden. Sie erfordert mindestens zwei Argumente: einen Verweis auf eine Script-Funktion oder eine andere Get-Funktion, die ein Objekt oder Array zurückgibt, und entweder eine Zeichenfolge, die die Eigenschaft eines Objekts angibt, oder einen durch Punkte getrennten Pfad zu einer Eigenschaft eines Unterobjekts. Optional kann ein drittes Argument angegeben werden, um auf einen nullbasierten Array-Index zuzugreifen, wenn ein Array referenziert wird.

Der Rückgabewert der Get-Funktion ist der Wert der Eigenschaft (oder des indizierten Array-Elements) und kann von einem der folgenden Typen sein:

- Eine Zahl
- True (1) oder False (0)
- Eine Zeichenfolge
- Eine Binary-Datenstruktur
- Eine Blob-, Kante-, Histogramm-, oder Patterns-Datenstruktur
- Ein Form-Objekt
- Ein Objekt
- Ein Bild
- null, nicht definiert oder keine Rückgabeanweisung (was einem leeren Objekt gleichgesetzt wird).

Hinweis: Die Get-Funktion unterstützt nicht die Rückgabe von null oder nicht definiert.

### Get – Beispiel

In diesem Beispiel besitzt eine Script-Funktion in Zelle B3 eine Run-Methode, die ein Objekt zurückgibt:

    Tool.prototype.run = function(n) {
      this.updateStats(n);
      return {
        total: this._total;
    	stats: {
    	  avg: this._avg,
    	  range: {
    	    max: this._max,
    	    min: this._min
    	  },
    	  values: this._valueArray
    	}
       };
    };

Die folgenden Get-Funktionen geben einfache Zahlen zurück (sofern die zurückgegebenen Werte numerisch sind):

- Get(B3, "gesamt")
- Get(B3, "stats.avg")
- Get(B3, "stats.range.max")
- Get(B3, "stats.range.min")

Die folgende Get-Funktion gibt das Unterobjekt „range“ zurück, das an eine andere Script- oder Get-Funktion übergeben werden kann:

- Get(B3, "stats.range")

Die folgende Get-Funktion gibt Element 37 aus dem Werte-Array zurück:

- Get(B3, "stats.values", 37)

## Get – Eingaben

Script/Get | Gibt einen Verweis auf eine Script-Funktion oder eine andere Get-Funktion an, die eine Object- oder Array-Datenstruktur zurückgibt.
Objekteigenschaft und/oder Array | Gibt einen Verweis auf eine Eigenschaft einer Object-Datenstruktur an, entweder als Zeichenfolge (der Name der Eigenschaft) oder als durch Punkte getrennter Pfad zu einer Eigenschaft eines Unterobjekts; oder eine Array-Datenstruktur.
[Array-Index] | Gibt ein optionales Argument für einen Index eines Arrays an, wenn auf eine Array-Datenstruktur verwiesen wird.

## Get – Ausgaben

Rückgabewert | Die Funktion gibt den Wert der Eigenschaft (oder des indizierten Array-Elements) zurück und kann einen der folgenden Typen zurückgeben: Eine Zahl True (1) oder False (0) Eine Zeichenfolge Eine Binary-Datenstruktur Eine Blob-, Edge-, Histogram-, oder Patterns-Datenstruktur Ein Form-Objekt Ein Objekt Ein Bild null, nicht definiert oder keine Rückgabeanweisung (was einem leeren Objekt gleichgesetzt wird).

Hinweis: Die Funktion gibt in einer Script-Funktion Folgendes nicht zurück: null, nicht definiert oder keine Rückgabeanweisung (was einem leeren Objekt gleichgesetzt wird).