FUNCIóNEn revisión

ASize

ASize( <aDestino>, <nTamanho> ) --> Nil

Redimensiona array existente.

ASizeAdvPL

01 · DESCRIPCIÓN GENERAL

Descripción general

ASize cambia cantidad de elementos. Reducir descarta posiciones finales y contenidos; ampliar no crea registros completos. La ficha declara retorno Nil; ejemplo llama como instrucción y mantiene array en variable original. Comprobar índices válidos tras reducir. (TOTVS, s.d., ref. 1)

02 · SINTAXIS

Sintaxis

ASize( <aDestino>, <nTamanho> ) --> Nil

Parámetros

aDestino

ArrayObligatorio

Array a redimensionar.

nTamanho

NuméricoObligatorio

Nuevo tamaño.

Retorno

Nil según ficha consultada. El efecto ocurre en array recibido.

03 · EJEMPLO PRÁCTICO

Ejemplo comentado

#Include "Protheus.ch"

User Function EdAsize()
    Local aItems := {10, 20, 30}
    // No asignar retorno de ASize a aItems.
    ASize(aItems, 2)
    ConOut(cValToChar(Len(aItems)))
    ConOut(cValToChar(aItems[2]))
Return Nil

Resultado esperado

Resultados esperados: 2 y 20. Se descartó elemento 30. En revisión: ejemplo editorial no compilado ni ejecutado en Protheus. Comprobar includes, release, RDD y contexto antes de probar.

BUENAS PRÁCTICAS

Validar tamaño entero no negativo. Usar AClone antes de reducir si debe conservarse estructura original.
En revisión: ejemplo editorial no compilado ni ejecutado en Protheus. Comprobar includes, release, RDD y contexto antes de probar.

Contenido relacionado

REFERENCIAS

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

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