function_handle

Identificador de función

Descripción

Un identificador de función es un tipo de dato de MATLAB^® que representa una función. Comúnmente, los identificadores de función se utilizan para pasar una función a otra. Por ejemplo, se pueden utilizar identificadores de función como argumentos de entrada para las funciones que evalúan expresiones matemáticas en un rango de valores. Otros usos habituales de los indicadores de funciones son:

• Especificar funciones de callback (por ejemplo, un callback que responde a un evento de la IU o interactúa con el hardware de adquisición de datos).

• Construir identificadores para las funciones definidas en línea en lugar de para las almacenadas en un archivo de programa (funciones anónimas).

Creación

Cree un identificador de función utilizando el operador @. Los identificadores de función pueden representar funciones designadas o anónimas.

• Los identificadores de funciones designadas representan funciones en archivos de programa existentes, incluidas funciones que son parte de MATLAB y funciones que crea usted utilizando la palabra clave function. Para crear un identificador para una función designada, preceda el nombre de la función con @.

  Por ejemplo, cree un identificador de la función sin y, después, utilice fminbnd para encontrar el valor de x que minimiza sin(x) en el rango de 0 a $$2\pi$$:

  f = @sin;
  m = fminbnd(f,0,2*pi);

• Los identificadores de funciones anónimas (con frecuencia denominados funciones anónimas) representan expresiones ejecutables en línea únicas que devuelven una salida. Para definir una función anónima, encierre los nombres de los argumentos de entrada entre paréntesis inmediatamente después del operador @ y, después, especifique la expresión ejecutable.

  Por ejemplo, cree un identificador para una función anónima que evalúe la expresión x² − y²:

  f = @(x,y) (x.^2 - y.^2);

  Las funciones anónimas pueden aceptar varias entradas, pero devuelven solo una salida.

Ejemplos

Encontrar la integral de una función designada

En un archivo de la carpeta actual, cree una función llamada cubicPoly que acepte una entrada para evaluar el polinomio cúbico ${\mathit{x}}^3+{\mathit{x}}^2+\mathit{x}+1$.

function y = cubicPoly(x)
y = x.^3 + x.^2 + x + 1; 
end

Para encontrar la integral de cubicPoly de 0 a 1, pase un identificador de la función cubicPoly a integral.

q = integral(@cubicPoly,0,1)

q = 
2.0833

Encontrar la integral de una función anónima

Cree el identificador f de una función anónima que evalúe el polinomio cúbico ${\mathit{x}}^3+{\mathit{x}}^2+\mathit{x}+1$ para un valor dado de $\mathit{x}$.

f = @(x) x.^3 + x.^2 + x + 1;

Para encontrar la integral de la función anónima de 0 a 1, pase su identificador a integral.

q = integral(f,0,1)

q = 
2.0833

Capacidades ampliadas

Entorno basado en subprocesos

Ejecute código en segundo plano con MATLAB® backgroundPool o acelere código con Parallel Computing Toolbox™ ThreadPool.

Este tipo de datos es totalmente compatible con entornos basados en subprocesos. Para obtener más información, consulte Ejecutar funciones de MATLAB en un entorno basado en subprocesos.

Historial de versiones

Introducido antes de R2006a

R2023a: Rendimiento mejorado al invocar identificadores de funciones con nombre

Invocar identificadores de funciones con nombre que no están anidadas mejora el rendimiento. Invocar estos identificadores de función ya no supone una sobrecarga en comparación con la llamada directa a las funciones. Por ejemplo, en un archivo llamado myFun.m de su carpeta actual, cree la función myFun.

function y = myFun(x)
y = x;
end

En un archivo llamado timingTest.m de su carpeta actual, cree una función que invoque un identificador de myFun. La función timingTest es unas 40 veces más rápida que en la versión anterior.

function t = timingTest
f = @myFun;
n = 1e7;
tic
for i = 1:n
    out = f(3);
end
t = toc;
end

Los tiempos de ejecución aproximados son:

R2022b: 4,4 s

R2023a: 0,11 s

El código se cronometró en un sistema de prueba Windows^® 10, Intel^® Xeon^® CPU E5-1650 v4 con 3,60 GHz llamando a la función timingTest.

Consulte también

func2str | str2func | functions

Temas

• Crear un identificador de función
• Pasar una función a otra función
• Funciones anónimas
• Create Callbacks for Graphics Objects