Name=value en llamadas a funciones
Desde la versión R2021a
MATLAB® admite dos sintaxis para pasar argumentos nombre-valor.
plot(x,y,LineWidth=2)
sintaxis name=value
plot(x,y,"LineWidth",2)
sintaxis separada por comas
Utilice la sintaxis name=value
para ayudar a identificar argumentos nombre-valor para funciones, y para distinguir con claridad los nombres de los valores en listas de argumentos nombre-valor.
La mayoría de funciones y métodos admite ambas sintaxis, pero existen algunas limitaciones sobre dónde y cómo se puede utilizar la sintaxis name=value
:
La combinación de las sintaxis
name,value
yname=value
: la práctica recomendada es utilizar solo una sintaxis en la llamada a cualquier función determinada. Sin embargo, si combina las sintaxisname=value
yname,value
en una única llamada, todos los argumentosname=value
deben aparecer después de los argumentosname,value
. Por ejemplo,plot(x,y,"Color","red",LineWidth=2)
es una combinación válida, peroplot(x,y,Color="red","LineWidth",2)
produce un error.El uso de argumentos de posición después de argumentos nombre-valor: algunas funciones tienen argumentos de posición que aparecen después de los argumentos nombre-valor. Por ejemplo, esta llamada al método
verifyEqual
utiliza el argumento nombre-valorRelTol
, seguido de una cadena de entrada:Utilizar la sintaxisverifyEqual(testCase,1.5,2,"RelTol",0.1,... "Difference exceeds relative tolerance.")
name=value
(RelTol=0.1
) produce un error en la instrucción. En los casos en los que un argumento de posición siga a los argumentos nombre-valor, utilice la sintaxisname,value
.Nombres que son nombres de variable no válidos: los argumentos nombre-valor con nombres de variable de MATLAB no válidos no se pueden utilizar con la sintaxis
name=value
. Para obtener más información, consulte Nombres de variables. Por ejemplo, un argumento nombre-valor como"allow-empty",true
produce un error si se pasa comoallow-empty=true
. Utilice la sintaxisname,value
en estos casos.
Los autores de funciones no tienen que modificar su código para que sea compatible con las sintaxis name,value
y name=value
. Para obtener información sobre cómo utilizar la validación de argumentos con argumentos nombre-valor, consulte Validate Name-Value Arguments.