Delegados (F#)

  • Artículo

Un delegado representa una llamada a función como un objeto. En F#, normalmente se deben usar valores de función para representar funciones como valores de primera clase, pero en .NET Framework se usan delegados, que son necesarios al interoperar con API que los esperan. También se pueden usar al crear bibliotecas diseñadas para su uso desde otros lenguajes de .NET Framework.

Sintaxis

type delegate-typename = delegate of type1 -> type2

Comentarios

En la sintaxis anterior, type1 representa el tipo o tipos de argumento y type2 el tipo de valor devuelto. Los tipos de argumento representados por type1 se currifican automáticamente. Esto sugiere que para este tipo se usa un formulario de tupla si los argumentos de la función de destino se currifican, y una tupla entre paréntesis para los argumentos que ya están en el formulario de tupla. La currificación automática quita un conjunto de paréntesis y deja un argumento de tupla que coincide con el método de destino. Vea el ejemplo de código para obtener la sintaxis que se debe usar en cada caso.

Los delegados se pueden adjuntar a valores de función de F# y métodos estáticos o de instancia. Los valores de función de F# se pueden pasar directamente como argumentos a constructores delegados. En un método estático, para crear el delegado se usa el nombre de la clase y el método. En un método de instancia, proporcione la instancia de objeto y el método en un argumento. En ambos casos se usa el operador de acceso a miembros (.).

El método Invoke del tipo delegado llama a la función encapsulada. Además, los delegados se pueden pasar como valores de función si se hace referencia al nombre del método Invoke sin los paréntesis.

En el código siguiente se muestra la sintaxis para crear delegados que representan varios métodos en una clase. En función de si el método es estático o de instancia, y de si tiene argumentos en el formulario de tupla o en el formulario currificado, la sintaxis para declarar y asignar el delegado varía un poco.

type Test1() =
  static member add(a : int, b : int) =
     a + b
  static member add2 (a : int) (b : int) =
     a + b

  member x.Add(a : int, b : int) =
     a + b
  member x.Add2 (a : int) (b : int) =
     a + b


// Delegate1 works with tuple arguments.
type Delegate1 = delegate of (int * int) -> int
// Delegate2 works with curried arguments.
type Delegate2 = delegate of int * int -> int

let InvokeDelegate1 (dlg: Delegate1) (a: int) (b: int) =
   dlg.Invoke(a, b)
let InvokeDelegate2 (dlg: Delegate2) (a: int) (b: int) =
   dlg.Invoke(a, b)

// For static methods, use the class name, the dot operator, and the
// name of the static method.
let del1 = Delegate1(Test1.add)
let del2 = Delegate2(Test1.add2)

let testObject = Test1()

// For instance methods, use the instance value name, the dot operator, and the instance method name.
let del3 = Delegate1(testObject.Add)
let del4 = Delegate2(testObject.Add2)

for (a, b) in [ (100, 200); (10, 20) ] do
  printfn "%d + %d = %d" a b (InvokeDelegate1 del1 a b)
  printfn "%d + %d = %d" a b (InvokeDelegate2 del2 a b)
  printfn "%d + %d = %d" a b (InvokeDelegate1 del3 a b)
  printfn "%d + %d = %d" a b (InvokeDelegate2 del4 a b)

En el código siguiente se muestran algunas de las distintas formas en que puede trabajar con delegados.

type Delegate1 = delegate of int * char -> string

let replicate n c = String.replicate n (string c)

// An F# function value constructed from an unapplied let-bound function
let function1 = replicate

// A delegate object constructed from an F# function value
let delObject = Delegate1(function1)

// An F# function value constructed from an unapplied .NET member
let functionValue = delObject.Invoke

List.map (fun c -> functionValue(5,c)) ['a'; 'b'; 'c']
|> List.iter (printfn "%s")

// Or if you want to get back the same curried signature
let replicate' n c =  delObject.Invoke(n,c)

// You can pass a lambda expression as an argument to a function expecting a compatible delegate type
// System.Array.ConvertAll takes an array and a converter delegate that transforms an element from
// one type to another according to a specified function.
let stringArray = System.Array.ConvertAll([|'a';'b'|], fun c -> replicate' 3 c)
printfn "%A" stringArray

La salida del ejemplo de código anterior es la siguiente.

aaaaa
bbbbb
ccccc
[|"aaa"; "bbb"|]

Los nombres pueden agregarse a los parámetros de los delegados de la siguiente manera:

// http://www.pinvoke.net/default.aspx/user32/WinEventDelegate.html
type WinEventDelegate = delegate of hWinEventHook:nativeint * eventType:uint32 * hWnd:nativeint * idObject:int * idChild:int * dwEventThread:uint32 * dwmsEventTime:uint32 -> unit

Los nombres de los parámetros de los delegados son opcionales y se mostrarán en el método Invoke. No es necesario que coincidan con los nombres de los parámetros de la implementación. Solo se permiten para la forma currificado pero no para la forma tupled.

type D1 = delegate of item1: int * item2: string -> unit
let a = D1(fun a b -> printf "%s" b)
a.Invoke(item2 = "a", item1 = 1) // Calling with named arguments

type D2 = delegate of int * item2: string -> unit // Omitting one name
let b = D2(fun a b -> printf "%s" b)
b.Invoke(1, item2 = "a")

La salida del ejemplo de código anterior es la siguiente.

aa

Vea también