numericNOpcional
Valores numéricos enteros o decimales, positivos o negativos.
FUNDAMENTOPublicado
Tipado de datos en AdvPL
Local <variável> As <tipo> · Function <nome>(<parâmetro> As <tipo>) As <tipo>Declara tipos de variables, parámetros, retornos, propiedades y métodos para hacer visibles las inconsistencias.
Descripción general
AdvPL posee tipado dinámico, pero permite declarar tipos explícitamente en archivos .PRW. Estas anotaciones ayudan al compilador y al AppServer a identificar asignaciones, parámetros y retornos incompatibles. Los tipos documentados son numeric, character, date, codeblock, logical, array, object y variadic. El tipado de TLPP tiene recursos y documentación propios.
Sintaxis
Local <variável> As <tipo> · Function <nome>(<parâmetro> As <tipo>) As <tipo>Parámetros
character / charCOpcional
Cadenas de caracteres.
dateDOpcional
Valores de fecha.
codeblock / blockBOpcional
Bloques de código evaluables en ejecución.
logicalLOpcional
Valores lógicos verdadero (.T.) o falso (.F.).
arrayAOpcional
Matrices que pueden contener valores y estructuras.
objectOOpcional
Instancias de clases u objetos de interfaz.
variadicHOpcional
Cantidad variable de parámetros en funciones.
Variables locales tipadas
User Function ExTipos()
Local cMensaje As Character
Local nCantidad As Numeric
Local dHoy As Date
Local lActivo As Logical
Local aElementos As Array
cMensaje := "Registro disponible"
nCantidad := 3
dHoy := Date()
lActivo := .T.
aElementos := {"A", "B", "C"}
If lActivo
MsgInfo(cMensaje + " - elementos: " + CValToChar(nCantidad))
EndIf
ReturnResultado esperado
Cada variable declara el tipo esperado, facilitando la identificación de asignaciones incompatibles.
Parámetro y retorno tipados
User Function TotalPedido(nValor As Numeric, nCantidad As Numeric) As Numeric
Local nTotal As Numeric
nTotal := nValor * nCantidad
Return nTotalResultado esperado
El prototipo documenta que ambos parámetros y el retorno son numéricos.
Propiedad y método de clase
Class Pedido
Data nTotal As Numeric
Method New(nValor As Numeric) As Object
EndClass
Method New(nValor As Numeric) Class Pedido
::nTotal := nValor
Return SelfResultado esperado
La propiedad, el parámetro y el retorno del constructor tienen tipos declarados.
Incompatibilidad detectable
User Function ExIncompativel()
Local cCodigo As Character
Local nTotal As Numeric
nTotal := "ABC"
cCodigo := 10
ReturnResultado esperado
El compilador puede emitir el aviso W0015 por conversiones incompatibles entre C y N. Corrige el origen o convierte el valor conscientemente.
- Utiliza As <tipo> en variables locales, parámetros, retornos de funciones, propiedades y métodos.
- El tipado explícito mejora el contrato de la rutina y permite que el compilador avise sobre incompatibilidades.
- En llamadas tipadas, AppServer también compara el tipo recibido con el prototipo definido.
- La referencia oficial indica requisitos históricos desde diciembre de 2014; confirma el comportamiento en la versión utilizada.
- No ignores los avisos de compilación: asignar character a numeric, o al contrario, contradice el contrato declarado.
- Según la documentación, un argumento incompatible puede llegar como NIL, producir un aviso en la consola y alterar el flujo esperado.
- No confundas el tipado de .PRW con el de TLPP (.tlpp), que tiene recursos y documentación separados.
- El tipado explícito no sustituye la validación de NIL, contenido, intervalos y reglas de negocio.