# Get

スクリプト 関数または別の Get 関数によって出力された配列/オブジェクトのプロパティを返します。

## Get の概要

Script 関数によって返されたオブジェクトのプロパティにアクセスするには、Get 関数を使用します。少なくとも 2 つの引数が必要です。1 つは Script 関数、あるいはオブジェクトまたは配列を返す別の Get 関数への参照です。もう 1 つは、オブジェクトのプロパティを表す文字列、またはサブオブジェクトのプロパティを指すドットで区切られたパスです。オプションで、配列を参照する場合にゼロから始まる配列インデックスにアクセスするための 3 番目の引数を指定できます。

Get 関数の戻り値は、プロパティの値 (またはインデックスで指定された配列要素) であり、次のいずれかの型です。

- 数値
- true (1) または false (0)
- 文字列
- Binary データ構造体
- ブロブ、エッジ、ヒストグラム、または Patterns データ構造体
- 形状オブジェクト
- オブジェクト
- 画像
- null ステートメント、未定義ステートメント、または戻り値なしステートメント (これらは空のオブジェクトと同様に処理されます)

注 : Get 関数で null または未定義を返すことはできません。

### Get の例

この例では、セル B3 の Script 関数に、オブジェクトを返す実行メソッドがあります。

    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
    	}
       };
    };

次の Get 関数は単純な数値を返します (戻り値が数値であることを前提とします)。

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

次の Get 関数は「range」サブオブジェクトを返します。戻り値は別の Script 関数または Get 関数に渡すことができます。

- Get(B3, "stats.range")

次の Get 関数は値の配列から要素 37 を返します。

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

## Get の入力

Script/Get | Object または Array データ構造体を返す Script 関数または別の Get 関数への参照を指定します。
オブジェクトプロパティと配列の両方またはいずれか | Object データ構造体のプロパティへの参照を、文字列 (プロパティ名) またはサブオブジェクトのプロパティへのドット区切りパスとして指定するか、Array データ構造体として指定します。
[配列インデックス] | Array データ構造体を参照する場合に、配列のインデックスに対する引数をオプションで指定します。

## Get の出力

戻り値 | この関数は、プロパティの値 (またはインデックスで指定された配列要素) を、次のいずれかの型で返します。 数値 true (1) または false (0) 文字列 Binary データ構造体 Blob、Edge、Histogram、または Patterns データ構造体 形状オブジェクト オブジェクト 画像 null ステートメント、未定義ステートメント、または戻り値なしステートメント (これらは空のオブジェクトと同様に処理されます)

注 : この関数が、Script 関数から null ステートメント、未定義ステートメント、または戻り値なしステートメントを返すことはありません (これらは空のオブジェクトと同様に処理されます)。