Function

Un objeto 4D.Function contiene un trozo de código que puede ser ejecutado desde un objeto, ya sea utilizando el operador (), o utilizando las funciones apply() y call().

Herencia

4D maneja varios tipos de objetos Function, que heredan de la clase 4D.Function:

• native functions, i.e. built-in functions from various 4D classes such as collection.sort() or file.copyTo().
• funciones usuario, creadas en las clases usuario utilizando la palabra clave Function.
• las funciones de fórmula, es decir, las funciones que pueden ejecutar un código de fórmula almacenado en los objetos 4D.Formula,
• method functions, i.e. functions that can execute source code as text stored in 4D.Method objects.

Ejecución del código en los objetos Function

Los objetos Function pueden encapsularse en las propiedades de objeto:

var $message : 4D.Formula
$message:=Formula(ALERT("Hello world"))
$f:={message: $message}

Esta propiedad es una "función objeto", es decir una función que está vinculada a su objeto padre. Para ejecutar una función almacenada en una propiedad objeto, utilice el operador () después del nombre de la propiedad, como:

 $f.message() //muestra "Hello world"

También se admite la sintaxis con paréntesis:

 $f["message"]() //muestra "Hello world"

Tenga en cuenta que, aunque no tenga parámetros (ver arriba), una función objeto a ejecutar debe ser llamada con paréntesis (). Llamar sólo a la propiedad del objeto devolverá una nueva referencia a la fórmula (y no la ejecutará):

 $o:=$f.message //devuelve el objeto función en $o

You can also execute a function using the apply() and call():

 $message.apply() //muestra "Hello world"

Resumen

.apply() : any .apply( thisObj : Object { ; params : Collection } ) : any executes the function object to which it is applied, passing parameters as a collection, and returns the resulting value
.call() : any .call( thisObj : Object { ; ...params : any } ) : any executes the function object to which it is applied, with one or more parameter(s) passed directly, and returns the resulting value
.source : Text contiene el código fuente de la función como texto

.apply()

Historia

Lanzamiento	Modificaciones
21 R3	Soporte de objetos 4D.Methods
17 R3	Añadidos

.apply() : any
.apply( thisObj : Object { ; params : Collection } ) : any

Parámetros	Tipo		Descripción
thisObj	Object	->	Objeto a devolver por el comando This en la función
params	Collection	->	Colección de valores que se pasarán como parámetros a la función
Resultado	any	<-	Valor de la ejecución de la función

Descripción

The .apply() function executes the function object to which it is applied, passing parameters as a collection, and returns the resulting value.

En el parámetro thisObj, puede pasar una referencia al objeto que se utilizará como This en la función. Pasa Null si no quiere utilizar This pero quiere enviar parámetros.

Puede pasar una colección para utilizarla como parámetros en la función utilizando el parámetro opcional params:

• en los objetos 4D.Formula, los parámetros se pasan en $1...$n en la fórmula.
• in other 4D.Function objects such as 4D.Method objects, parameters are passed in declared method parameters.

Tenga en cuenta que .apply() es similar a .call() excepto que los parámetros se pasan como una colección. Esto puede ser útil para pasar los resultados calculados.

.call()

Historia

Lanzamiento	Modificaciones
21 R3	Soporte de objetos 4D.Methods
17 R3	Añadidos

.call() : any
.call( thisObj : Object { ; ...params : any } ) : any

Parámetros	Tipo		Descripción
thisObj	Object	->	Objeto a devolver por el comando This en la función
params	any	->	Valores a pasar como parámetros a la función
Resultado	any	<-	Valor de la ejecución de la función

Descripción

The .call() function executes the function object to which it is applied, with one or more parameter(s) passed directly, and returns the resulting value.

En el parámetro thisObj, puede pasar una referencia al objeto que se utilizará como This en la función.

You can pass values to be used as parameters in the function using the optional params parameter:

• en los objetos 4D.Formula, los parámetros se pasan en $1...$n en la fórmula.
• en los objetos 4D.Method, los parámetros se pasan en parámetros declarados.

Tenga en cuenta que .call() es similar a .apply() excepto que los parámetros se pasan directamente.

Ejemplo 1

 var $f : 4D.Function
 $f:=Formula(Uppercase($1))
 $result:=$f.call(Null;"hello") // devuelve "HELLO"

Ejemplo 2

 $o:=New object("value";50)
 $f:=Formula(This.value*2)
 $result:=$f.call($o) // devuelve 100

.source

Historia

Lanzamiento	Modificaciones
21 R3	Soporte de objetos 4D.Methods
18 R2	Añadidos

.source : Text

Descripción

La propiedad .source contiene el código fuente de la función como texto.

El valor devuelto es el texto original utilizado para crear el objeto 4D.Formula o 4D.Method pero reformateado.

Esta propiedad es de solo lectura.

Ejemplo

 var $of : 4D.Function
 var $tf : Text
 $of:=Formula(String(Current time;HH MM AM PM))
 $tf:=$of.source //"String(Current time;HH MM AM PM)"