# Get

Script 함수 또는 다른 Get 함수에 의한 배열 및/또는 개체 출력의 속성을 반환합니다.

## Get 개요

Get 함수는 Script 함수가 반환한 개체 속성에 액세스하기 위해 이용됩니다. 두 가지 인수가 필요합니다. 첫 번째는 개체 또는 배열을 반환하는 Scrripot 함수 또는 Get 함수수에 대한 참조입니다. 두 번째는 개체의 속성을 나타내는 문자열 또는 하위 개체의 속성에 대해 점으로 분류된 경로입니다. (옵션 사항) 배열을 참조될 때 세 번째 인수를 지정하여 0부터 시작하는 배열 인덱스에 액세스할 수 있습니다.

Get 함수에서 반환하는 값은 특성(또는 색인화된 배열 요소) 의 값이며 다음 유형 중 하나일 수 있습니다.

- 숫자
- 참(1) 또는 거짓(0)
- 문자열
- 이진 데이터 구조
- 미확인 개체, 가장자리, 히스토그램, Patterns 데이터 구조
- 도형 개체
- 개체
- 이미지
- null 또는 정의되지 않았거나 반환되지 않은 명령(빈 개체와 동일하게 처리됨)

참고 : Get 함수는 null 또는 '정의되지 않음'을 지원하지 않습니다.

### Get 예

이 예제의 경우, 셀 B3의 Script 함수에는 개체를 반환하는 run 메소드가 있습니다.

    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 | 개체 또는 Array 데이터 구조를 반환하는 Script 함수 또는 또다른 Get 함수에 대한 참조를 지정합니다.
개체 속성 및/또는 배열 | Object 데이터 구조의 속성에 대한 참조를 지정합니다. 문자열(속성 이름)로 하거나 하위 개체의 속성에 대한 점으로 분리된 경로 또는 Array 데이터 구조입니다.
[배열 인덱스] | (선택 사항) Array 데이터 구조를 참조하는 경우 배열의 인덱스 값을 지정할 수 있습니다.

## Get 출력

반환 | 속성(또는 인덱스 지정된 배열 요소)의 값을 반환하며 반환되는 유형은 다음과 같습니다. 숫자 참(1) 또는 거짓(0) 문자열 이진 데이터 구조 Blob, Edge, Histogram, Patterns 데이터 구조 도형 개체 개체 이미지 null 또는 정의되지 않았거나 반환되지 않은 명령(빈 개체와 동일하게 처리됨)

참고 : 함수는 Script 함수에서 null, 정의되지 않았거나 반환되지 않은 명령(빈 개체와 동일하게 처리됨)을 반환하지 않습니다.