AELEMENT( ) (Función)
Devuelve el número de un elemento de la matriz a partir de los subíndices del elemento.
AELEMENT(ArrayName, nRowSubscript [, nColumnSubscript])
Valores devueltos
Numeric
Parámetros
ArrayName
Especifica el nombre de la matriz cuyo número de elemento se desea devolver.nRowSubscript
Especifica el subíndice de fila. Si la matriz es unidimensional, AELEMENT( ) devolverá nRowSubscript.Si sólo incluye nRowSubscript y es mayor que el número de filas de la matriz, Visual FoxPro generará un mensaje de error.
nColumnSubscript
Especifica el subíndice de columna. Si la matriz es bidimensional, incluya nRowSubscript y nColumnSubscript.
Observaciones
Puede hacer referencia a un elemento de una matriz bidimensional de dos maneras. El primer método utiliza dos subíndices para especificar la posición de fila y columna del elemento en la matriz y el segundo método utiliza un número de elemento único. AELEMENT( ) devuelve el número de elemento cuando se facilitan los subíndices de fila y columna de un elemento.
Las funciones ADEL( ), ADIR( ), AFIELDS( ), AINS( ), ALEN( ), ASCAN( ), ASORT( ) y ASUBSCRIPT( ) de Visual FoxPro pueden manipular matrices de dos dimensiones y precisan que se haga referencia a los elementos por su número de elemento. AELEMENT( ) facilita la conversión de subíndices a un número de elemento para utilizarlo en estas funciones. Los subíndices correspondientes de fila y columna se pueden devolver a partir del número de elemento mediante ASUBSCRIPT( ).
El ejemplo siguiente ilustra la forma de crear 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)
Se puede hacer referencia a un elemento mediante sus subíndices o su número de elemento. Los comandos STORE 'INVOICE' TO gaMyArray(2, 1)
y STORE 'INVOICE' TO gaMyArray(4)
almacenan la cadena de caracteres INVOICE en el mismo elemento de la matriz.
En las matrices de una dimensión, un número de elemento coincide con su subíndice de fila única. No es necesario utilizar AELEMENT( ) con las matrices de una dimensión.
Vea también
ADEL( ) | ADIR( ) | AFIELDS( ) | AINS( ) | ALEN( ) | ASCAN( ) | ASORT( ) | ASUBSCRIPT( ) | DIMENSION | DISPLAY MEMORY