Nome=Valore nelle chiamate di funzione

R2026b

Dalla release R2021a

MATLAB^® supporta due sintassi per il passaggio degli argomenti nome-valore.

plot(x,y,LineWidth=2) sintassi nome=valore

plot(x,y,"LineWidth",2) sintassi separata da virgole

Utilizzare la sintassi name=value per identificare più facilmente gli argomenti nome-valore per le funzioni e per distinguere chiaramente i nomi dai valori negli elenchi di argomenti nome-valore.

La maggior parte delle funzioni e dei metodi supporta entrambe le sintassi, ma esistono alcune limitazioni relative a dove e come è possibile utilizzare la sintassi name=value:

Combinazione delle sintassi name,value e name=value: la pratica consigliata consiste nell'utilizzare una sola sintassi in ogni singola chiamata di funzione. Tuttavia, se si combinano le sintassi name=value e name,value in una singola chiamata, tutti gli argomenti name=value devono apparire dopo quelli name,value. Ad esempio, plot(x,y,"Color","red",LineWidth=2) è una combinazione valida, mentre plot(x,y,Color="red","LineWidth",2) genera un errore.
Utilizzo di argomenti posizionali dopo gli argomenti nome-valore: alcune funzioni presentano argomenti posizionali che appaiono dopo gli argomenti nome-valore. Ad esempio, questa chiamata al metodo verifyEqual utilizza l'argomento nome-valore RelTol seguito da un input stringa:
```
verifyEqual(testCase,1.5,2,"RelTol",0.1,...
    "Difference exceeds relative tolerance.")
```
L'utilizzo della sintassi name=value (RelTol=0.1) genera un errore nella dichiarazione. Nei casi in cui un argomento posizionale segue gli argomenti nome-valore, utilizzare la sintassi name,value.
Nomi non validi come nomi delle variabili: gli argomenti nome-valore con nomi non validi come nomi delle variabili di MATLAB non possono essere utilizzati con la sintassi name=value. Per maggiori informazioni, vedere Nomi delle variabili. Ad esempio, un argomento nome-valore come "allow-empty",true genera un errore se viene passato come allow-empty=true. In questi casi, utilizzare la sintassi name,value.

Gli autori delle funzioni non devono scrivere codice diverso per supportare entrambe le sintassi name,value e name=value. Per informazioni su come utilizzare la validazione degli argomenti con argomenti nome-valore, vedere Validate Name-Value Arguments.