FUNCIóNEn revisión

Array

Array( <nElementos1>, [xElemento2], ... [xElemento16] ) --> aRet

Crea array con dimensiones definidas.

ArrayAdvPL

01 · DESCRIPCIÓN GENERAL

Descripción general

Array reserva cantidad indicada. Argumentos numéricos adicionales crean dimensiones; la ficha admite hasta 16 y solo último no numérico para inicializar. Un literal puede ser más claro con valores conocidos. Dimensiones son posiciones disponibles, no registros rellenados. (TOTVS, s.d., ref. 1)

02 · SINTAXIS

Sintaxis

Array( <nElementos1>, [xElemento2], ... [xElemento16] ) --> aRet

Parámetros

nElementos1

NuméricoObligatorio

Tamaño primera dimensión.

xElemento2 ... xElemento16

CualquieraOpcional

Dimensiones adicionales o inicializador final según documentación.

Retorno

Array con estructura dimensionada.

03 · EJEMPLO PRÁCTICO

Ejemplo comentado

#Include "Protheus.ch"

User Function EdArray()
    Local aGrilla := Array(2, 2)
    // Asignar celdas existentes; no suponer registros completos.
    aGrilla[1][1] := "A"
    aGrilla[1][2] := 10
    ConOut(cValToChar(Len(aGrilla)))
    ConOut(cValToChar(aGrilla[1][2]))
Return Nil

Resultado esperado

Resultados esperados: 2 y 10. Segunda fila no representa aún registro completo. En revisión: ejemplo editorial no compilado ni ejecutado en Protheus. Comprobar includes, release, RDD y contexto antes de probar.

BUENAS PRÁCTICAS

Validar dimensiones externas y limitar memoria. Usar AAdd para crecimiento secuencial sin tamaño conocido.
En revisión: ejemplo editorial no compilado ni ejecutado en Protheus. Comprobar includes, release, RDD y contexto antes de probar.

Contenido relacionado

REFERENCIAS

TOTVS. Array. TDN. Consulta el 2026-10-26.

Estado: En revisión
Página creada el: 26/10/2026 a las 06:48
Última revisión el: 26/10/2026 a las 06:48
Idioma original: Portugués
Revisión: Usina.BR