# Get

Devuelve las propiedades de matrices y/u objetos obtenidas mediante una función Script u otra función Get.

## Get Descripción general

La función Get se utiliza para acceder a propiedades de objetos devueltas por una función Script. Requiere como mínimo dos argumentos: una referencia a una función Script u otra función Get que devuelva un objeto o matriz y, además, una cadena que indique la propiedad de un objeto o una ruta de acceso separada por puntos a una propiedad de un subobjeto. Opcionalmente, se puede incluir un tercer argumento para especificar el acceso a un índice de matriz de base cero cuando se hace referencia a una matriz.

El valor devuelto por la función Get es el valor de la propiedad (o del elemento de matriz indexado) que puede ser cualquiera de los siguientes tipos:

- Un número
- verdadero (1) o falso (0)
- Una cadena
- Una estructura de datos binaria
- Una estructura de datos Blob, Edge, Histograma, o Patterns
- Un objeto de forma
- Un objeto
- Una imagen
- Un valor nulo, no definido o sin instrucción de retorno (que se trata como si fuese un objeto vacío).

Nota: La función Get no admite la devolución de un valor nulo o no definido.

### Ejemplo con Get

Para este ejemplo, una función Script en la celda B3 tiene un método de ejecución que devuelve un objeto:

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

Las siguientes funciones Get devolverían números simples (suponiendo que los valores devueltos son numéricos):

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

La siguiente función Get devuelve el subobjeto "rango" que podría pasarse a otra función Script o Get:

- Get(B3, "stats.range")

La siguiente función Get devuelve el elemento 37 de la matriz de valores:

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

## Get Entradas

Script/Get | Especifica una referencia a una función Script u otra función Get que devuelve una estructura de datos Object o Array.
Propiedad de Object y/o Array | Especifica una referencia a una propiedad de una estructura de datos Object, ya sea en forma de cadena (el nombre de la propiedad) o de una ruta de acceso separada por puntos a una propiedad de un subobjeto, o una estructura de datos Array.
[Índice de la matriz] | Un argumento opcional para especificar el índice de una matriz cuando se hace referencia a una estructura de datos Array.

## Get Salidas

Devuelve | La función devuelve el valor de la propiedad (o elemento de matriz indexada), pudiendo ser este uno cualquiera de los siguientes tipos: Un número verdadero (1) o falso (0) Una cadena Una estructura de datos binaria Una estructura de datos Blob, Edge, Histogram, o Patterns Un objeto de forma Un objeto Una imagen Un valor nulo, no definido o sin instrucción de retorno (que se trata como si fuese un objeto vacío).

Nota: La función no devolverá lo siguiente de una función Script: valor nulo, valor no definido o sin instrucción de retorno (que se trata como si fuese un objeto vacío).