Share via

ASUBSCRIPT( ) (Función)

  • Artículo

Devuelve el subíndice de fila o columna de un elemento a partir del número de elemento.

ASUBSCRIPT(ArrayName, nElementNumber, nSubscript)

Valores devueltos

Numeric

Parámetros

  • ArrayName
    Especifica el nombre de la matriz.

  • nElementNumber
    Especifica el número de elemento.

  • nSubscript
    Determina si se devuelve el subíndice de fila o el de columna.

    Si la matriz es de una dimensión, incluya el número de elemento en nElementNumber y 1 en nSubscript. ASUBSCRIPT( ) devolverá nElementNumber.

    Si la matriz es de dos dimensiones, deberá incluir el número de elemento nElementNumber y un valor de 1 ó 2 en nSubscript. Si especifica 1 en nSubscript, se devolverá el subíndice de fila del elemento; si especifica 2, se devolverá el subíndice de columna.

    Para obtener más información sobre cómo puede hacer referencia a los elementos de una matriz, vea DIMENSION.

Observaciones

Puede hacerse referencia de dos formas a los elementos de las matrices bidimensionales de variables. El primer método utiliza dos subíndices para especificar la posición de fila y columna del elemento de la matriz. El segundo método utiliza un número de elemento. Utilice ASUBSCRIPT( ) para obtener el subíndice de fila o columna de un elemento a partir del número de elemento.

El ejemplo siguiente crea una matriz con dos filas y tres columnas. DISPLAY MEMORY muestra el contenido de los elementos de la matriz, enumerados en orden del número de elemento.

DIMENSION gaMyArray(2,3)
DISPLAY MEMORY LIKE gaMyArray
GAMYARRAY  Pub  A
  ( 1, 1)   L  .F. (element number 1)
  ( 1, 2)   L  .F. (element number 2)
  ( 1, 3)   L  .F. (element number 3)
  ( 2, 1)   L  .F. (element number 4)
  ( 2, 2)   L  .F. (element number 5)
  ( 2, 3)   L  .F. (element number 6)

Estos dos comandos almacenan la cadena de caracteres INVOICE en el mismo elemento de la matriz:

STORE 'INVOICE' TO gaMyArray(2, 1)
STORE 'INVOICE' TO gaMyArray(4)

En las matrices de una dimensión, un número de elemento es igual que su subíndice de fila única. No es necesario utilizar ASUBSCRIPT( ) con las matrices de una dimensión.

Vea también

ADEL( ) | ADIR( ) | AELEMENT( ) | AFIELDS( ) | AINS( ) | ALEN( ) | ASCAN( ) | ASORT( ) | DIMENSION | DISPLAY MEMORY