Funciones

Las funciones son rutinas incorporadas que aceptan una cantidad determinada de parámetros y devuelven un valor único. Utilice las funciones para manipular el contenido de los campos y las variables que se utilizan en los comandos.

Nota

Las funciones no modifican los datos del campo sino que generan y devuelven un nuevo valor sobre la base de un cálculo o un algoritmo que utiliza los datos del campo o variables como datos de entrada. Utilice el valor que devuelve la función como entrada para un comando.

Sintaxis de las funciones

Las funciones comienzan con el nombre de la función, seguido de un paréntesis de apertura, una lista de 0 o más valores separados por un punto y coma que se se pasan a la función como argumentos, y un paréntesis de cierre.

Ejemplo

La función BETWEEN(valor; mín; máx) tiene tres argumentos y devuelve verdadero si el valor cae dentro del rango o falso si cae fuera del rango:

  • valor: la expresión o el campo que se debe probar
  • mín: el mínimo del rango
  • máx: el máximo del rango
BETWEEN(importe; 500; 5000)

Argumentos de las funciones

Un argumento de una función es un valor de entrada específico que se pasa a la función.

Los argumentos de las funciones se pasan a las funciones a través de una lista de argumentos. Se trata de una lista de expresiones, variables o valores literales que se evalúan en valores del tipo de datos del parámetro. Si desea obtener más información acerca del trabajo con tipos de datos, consulte Tipos de datos.

Nota

Si su proyecto trabaja con formatos de números europeos o si está escribiendo scripts que se pueden utilizar en otras regiones, separe los argumentos de las funciones con un carácter de espacio en lugar de una coma, aunque esté pasando un valor numérico con signo. Las funciones que aceptan valores numéricos con signos necesitan un delimitador explícito.

Comparación entre funciones y comandos

La diferencia entre comandos y funciones es sutil pero crucial para el uso de ACLScript:

Funciones Comandos
Utilice campos, valores o registros como entrada y genere un nuevo valor para devolverlo. Utilice tablas como entrada y genere nuevos registros y tablas.
Se utilizan en expresiones, campos calculados, valores de parámetros de comandos, variables y filtros para ayudar a modificar la ejecución del comando. Se utilizan para analizar datos, importar datos o generar resultados.
No puede ser un paso independiente en un script. Puede ser un paso independiente en un script.
Guía de creación de scripts de ACL 14.1