nElementos1NuméricoObrigatório
Tamanho da primeira dimensão.
FUNçãOEm revisão
Array
Array( <nElementos1>, [xElemento2], ... [xElemento16] ) --> aRetCria um array com dimensões definidas.
Visão geral
Array reserva a quantidade de elementos indicada. Parâmetros numéricos adicionais criam dimensões; a ficha admite até 16 argumentos e informa que apenas o último pode ser não numérico para inicialização. Para começar com valores conhecidos, a notação literal pode ser mais legível. Dimensões representam posições disponíveis, não registros preenchidos. (TOTVS, s.d., ref. 1)
Sintaxe
Array( <nElementos1>, [xElemento2], ... [xElemento16] ) --> aRetParâmetros
xElemento2 ... xElemento16QualquerOpcional
Dimensões adicionais ou inicializador final, conforme a documentação.
Retorno
Array com a estrutura dimensionada.
Exemplo comentado
#Include "Protheus.ch"
User Function EdArray()
Local aGrade := Array(2, 2)
// Atribui celulas existentes; nao presume registros prontos.
aGrade[1][1] := "A"
aGrade[1][2] := 10
ConOut(cValToChar(Len(aGrade)))
ConOut(cValToChar(aGrade[1][2]))
Return NilResultado esperado
Resultados esperados: 2 e 10. A segunda linha ainda não representa um registro preenchido. Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.
- Validar dimensões recebidas de fora e limitar o uso de memória. Usar AAdd para crescimento sequencial quando não houver tamanho conhecido.
- Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.
Comentários
Ainda não há comentários aprovados.
Entre com Google ou Microsoft para comentar.