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:
Combinación de las sintaxis
name,valueyname=value: la práctica recomendada es utilizar solo una sintaxis en la llamada a cualquier función determinada. Sin embargo, si combina las sintaxisname=valueyname,valueen una única llamada, todos los argumentosname=valuedeben 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
verifyEqualutiliza 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",trueproduce un error si se pasa comoallow-empty=true. Utilice la sintaxisname,valueen 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.