FUNCIóNEn revisión

AFill

AFill( <aDest>, <xValue>, [nStart], [nCount] ) --> aRet

Rellena intervalo con un mismo valor.

AFillAdvPL

01 · DESCRIPCIÓN GENERAL

Descripción general

AFill modifica elementos existentes sin dimensionar array. Sin límites rellena desde posición 1 hasta final. Acepta cualquier tipo, pero arrays u objetos no demuestran copias independientes por posición. Preferir inicialización escalar cuando corresponda al modelo. (TOTVS, s.d., ref. 1)

02 · SINTAXIS

Sintaxis

AFill( <aDest>, <xValue>, [nStart], [nCount] ) --> aRet

Parámetros

aDest

ArrayObligatorio

Array dimensionado.

xValue

CualquieraObligatorio

Valor de relleno.

nStart

NuméricoOpcional

Primera posición; predeterminado 1.

nCount

NuméricoOpcional

Cantidad desde inicio; predeterminado hasta final.

Retorno

Array tras relleno.

03 · EJEMPLO PRÁCTICO

Ejemplo comentado

#Include "Protheus.ch"

User Function EdAfill()
    Local aValores := Array(4)
    // Dimensionar primero; rellenar solo intervalo necesario.
    AFill(aValores, 0)
    AFill(aValores, 9, 2, 2)
    ConOut(cValToChar(aValores[1]))
    ConOut(cValToChar(aValores[2]))
Return Nil

Resultado esperado

Array esperado: {0, 9, 9, 0}; salidas 0 y 9. En revisión: ejemplo editorial no compilado ni ejecutado en Protheus. Comprobar includes, release, RDD y contexto antes de probar.

BUENAS PRÁCTICAS

No sustituir subarrays por escalar accidentalmente. Comprobar límites si intervalo proviene de configuración.
En revisión: ejemplo editorial no compilado ni ejecutado en Protheus. Comprobar includes, release, RDD y contexto antes de probar.

Contenido relacionado

REFERENCIAS

TOTVS. AFill. TDN. Consulta el 2026-10-25.

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