aMatrizArrayObligatorio
Variable que almacena la colección.
FUNDAMENTOPublicado
Matrices (arrays) en AdvPL
aMatriz := { <elemento1>, <elemento2>, ... } · aMatriz[nÍndice]Organiza valores en listas simples o multidimensionales, accede a posiciones y modifica la estructura dinámicamente.
Descripción general
Las matrices o arrays son colecciones ordenadas de valores. En AdvPL, el primer elemento ocupa la posición 1 y un mismo array puede contener caracteres, números, fechas, lógicos, objetos, otros arrays y demás tipos. Los arrays anidados permiten representar filas, columnas y estructuras compuestas.
Sintaxis
aMatriz := { <elemento1>, <elemento2>, ... } · aMatriz[nÍndice]Parámetros
nÍndiceNuméricoObligatorio
Posición del elemento, iniciada en 1 y limitada por el tamaño actual del array.
elementoQualquerOpcional
Valor almacenado; los elementos del mismo array pueden tener tipos diferentes.
Creación, acceso y tamaño
User Function ExMatriz()
Local aLetras := {"A", "B", "C"}
MsgInfo("Segundo elemento: " + aLetras[2])
MsgInfo("Cantidad: " + CValToChar(Len(aLetras)))
ReturnResultado esperado
El índice 2 devuelve B y Len() informa que hay tres elementos.
Inclusión dinámica con AAdd
User Function ExAgregar()
Local aLetras := {"A", "B", "C"}
AAdd(aLetras, "D")
MsgInfo("Último elemento: " + aLetras[Len(aLetras)])
ReturnResultado esperado
AAdd() agrega D y Len() proporciona la última posición actual.
Estructura con tipos diferentes
#define PESSOA_NOME 1
#define PESSOA_IDADE 2
#define PESSOA_ATIVA 3
User Function ExPessoa()
Local aPessoa := {"Maria", 32, .T.}
If aPessoa[PESSOA_ATIVA]
ConOut(aPessoa[PESSOA_NOME] + " está ativa")
EndIf
ReturnResultado esperado
Las constantes nombran semánticamente las posiciones de nombre, edad y estado.
Matriz multidimensional
#define PESSOA_NOME 1
#define PESSOA_IDADE 2
User Function ExPessoas()
Local aPessoas := { ;
{"Pedro", 32}, ;
{"Maria", 22}, ;
{"Antônio", 42} }
Local nLinha
For nLinha := 1 To Len(aPessoas)
ConOut(aPessoas[nLinha, PESSOA_NOME] + ;
" - " + CValToChar(aPessoas[nLinha, PESSOA_IDADE]))
Next
ReturnResultado esperado
Cada array interno representa una fila. El bucle recorre las personas y accede a las columnas mediante constantes.
Acceso protegido por índice
User Function ExIndice(nIndice)
Local aCores := {"Azul", "Verde", "Vermelho"}
If nIndice >= 1 .And. nIndice <= Len(aCores)
MsgInfo(aCores[nIndice])
Else
MsgAlert("Posição inválida")
EndIf
ReturnResultado esperado
La condición impide acceder fuera de los límites actuales.
- Utiliza llaves para crear un array literal y corchetes para acceder a una posición.
- Len(aMatriz) devuelve la cantidad de elementos de la dimensión consultada.
- AAdd(aMatriz, xValor) agrega un elemento al final.
- Los arrays multidimensionales se acceden como aDatos[nFila, nColumna] o aDatos[nFila][nColumna].
- Las constantes #define pueden nombrar posiciones y mejorar la legibilidad.
- Acceder a una posición menor que 1 o mayor que Len(aMatriz) provoca un error; valida el índice.
- Los arrays muy grandes o profundamente anidados pueden consumir mucha memoria. Para grandes volúmenes, considera tablas temporales o procesamiento por partes.
- La referencia histórica menciona hasta 100.000 elementos para versiones 5.07 a 8.11. No lo trates como límite universal; confírmalo en el AppServer y la LIB utilizados.
- Al representar registros por posiciones numéricas, mantén constantes y documentación sincronizadas.
- Los arrays pueden mezclar tipos, pero las rutinas que esperan una estructura específica deben validarlos.