함수 호출에서의 Name=Value

R2021a 이후

MATLAB^®은 이름-값 인수를 전달하는 데 두 가지 구문을 지원합니다.

plot(x,y,LineWidth=2) name=value 구문

plot(x,y,"LineWidth",2) 쉼표로 구분된 구문

name=value 구문을 사용하면 함수의 이름-값 인수를 식별하는 데 도움이 되고 이름-값 인수 목록에서 이름과 값을 명확하게 구별할 수 있습니다.

대부분의 함수와 메서드는 두 가지 구문을 모두 지원하지만, name=value 구문을 사용할 수 있는 위치와 방법에는 다음과 같은 몇 가지 제한 사항이 있습니다.

name,value 구문과 name=value 구문을 혼합하여 사용하는 경우: 함수 호출에서 한 방식의 구문만 사용할 것을 권장합니다. 하지만, 하나의 호출에 name=value 구문과 name,value 구문을 혼합하여 사용할 경우 name=value 인수는 모두 name,value 인수 뒤에 와야 합니다. 예를 들어, plot(x,y,"Color","red",LineWidth=2)는 유효한 조합이지만 plot(x,y,Color="red","LineWidth",2)는 오류를 발생시킵니다.
이름-값 인수 뒤에 위치 인수를 사용하는 경우: 일부 함수에는 이름-값 인수 뒤에 오는 위치 인수가 있습니다. 예를 들어, 아래의 verifyEqual 메서드 호출은 RelTol 이름-값 인수를 사용하고 그 뒤에 입력값으로 문자열이 옵니다.
```
verifyEqual(testCase,1.5,2,"RelTol",0.1,...
    "Difference exceeds relative tolerance.")
```
name=value 구문(RelTol=0.1)을 사용하면 명령문에서 오류가 발생합니다. 이름-값 인수 뒤에 위치 인수가 오는 경우에는 name,value 구문을 사용하십시오.
변수 이름이 유효하지 않은 경우: 이름-값 인수에서 이름이 MATLAB 변수 이름으로 유효하지 않은 경우 name=value 구문과 함께 사용할 수 없습니다. 자세한 내용은 변수 이름 항목을 참조하십시오. 예를 들어, "allow-empty",true와 같은 이름-값 인수는 allow-empty=true로 전달되면 오류가 발생합니다. 이러한 경우에는 name,value 구문을 사용하십시오.

함수 작성자는 name,value 구문과 name=value 구문을 모두 지원하기 위해 코딩을 다르게 할 필요는 없습니다. 이름-값 인수에 인수 유효성 검사를 사용하는 방법에 대한 자세한 내용은 이름-값 인수의 유효성 검사하기 항목을 참조하십시오.