aDestArrayObrigatório
Array dimensionado.
FUNçãOEm revisão
AFill
AFill( <aDest>, <xValue>, [nStart], [nCount] ) --> aRetPreenche uma faixa com um mesmo valor.
Visão geral
AFill modifica elementos já existentes; não dimensiona o array. Sem limites explícitos, preenche desde a posição 1 até o final. O valor pode ser de qualquer tipo, mas preencher com um array ou objeto não comprova cópias independentes por posição. Para inicialização simples, prefira valores escalares quando isso atender ao modelo de dados. (TOTVS, s.d., ref. 1)
Sintaxe
AFill( <aDest>, <xValue>, [nStart], [nCount] ) --> aRetParâmetros
xValueQualquerObrigatório
Valor de preenchimento.
nStartNuméricoOpcional
Primeira posição; padrão 1.
nCountNuméricoOpcional
Quantidade a partir do início; padrão até o final.
Retorno
Array após o preenchimento.
Exemplo comentado
#Include "Protheus.ch"
User Function EdAfill()
Local aValores := Array(4)
// Dimensionar antes; preencher apenas a faixa desejada.
AFill(aValores, 0)
AFill(aValores, 9, 2, 2)
ConOut(cValToChar(aValores[1]))
ConOut(cValToChar(aValores[2]))
Return NilResultado esperado
Array esperado: {0, 9, 9, 0}; saídas 0 e 9. Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.
- Não substituir subarrays por um escalar inadvertidamente. Conferir limites quando a faixa vier de configuração.
- 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.