Main Content

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 y name=value: la práctica recomendada es utilizar solo una sintaxis en la llamada a cualquier función determinada. Sin embargo, si combina las sintaxis name=value y name,value en una única llamada, todos los argumentos name=value deben aparecer después de los argumentos name,value. Por ejemplo, plot(x,y,"Color","red",LineWidth=2) es una combinación válida, pero plot(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-valor RelTol, seguido de una cadena de entrada:

    verifyEqual(testCase,1.5,2,"RelTol",0.1,...
        "Difference exceeds relative tolerance.")
    Utilizar la sintaxis 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 sintaxis name,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 como allow-empty=true. Utilice la sintaxis name,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.