인수 정의

가변 개수의 입력값 또는 출력값 허용, 값의 유효성 확인

MATLAB^®은 데이터형이 고정되지 않은 언어이므로 대부분의 함수에는 인수 선언이나 인수의 유효성 검사가 필요하지 않습니다. 그러나 함수에 다양한 사용법이 있고 코드가 예상대로 작동하도록 하기 위해 입력값의 유형, 크기 또는 다른 측면을 확인해야 하는 경우 arguments 블록을 정의할 수 있습니다.

function z = mySharedFunction(x,y,NameValueArgs)
   arguments
      x (1,1) double     % scalar
      y double {mustBeVector,mustBePositive} 
      NameValueArgs.A string
      NameValueArgs.B string = "default"
   end 
...
end

함수

모두 확장

인수 선언 및 유효성 검사

arguments 블록

arguments 함수 인수 유효성 검사 선언

숫자형 값 유효성 검사

`mustBePositive`	Validate that value is positive
`mustBeNonpositive`	Validate that value is nonpositive
`mustBeNonnegative`	Validate that value is nonnegative
`mustBeNegative`	Validate that value is negative
`mustBeFinite`	Validate that value is finite
`mustBeNonNan`	Validate that value is not NaN
`mustBeNonzero`	Validate that value is nonzero
`mustBeNonsparse`	Validate that value is nonsparse
`mustBeSparse`	Validate that value is sparse (R2023b 이후)
`mustBeReal`	Validate that value is real
`mustBeInteger`	Validate that value is integer
`mustBeNonmissing`	Validate that value is not missing (R2020b 이후)

비교

`mustBeGreaterThan`	Validate that value is greater than another value
`mustBeLessThan`	Validate that value is less than another value
`mustBeGreaterThanOrEqual`	Validate that value is greater than or equal to another value
`mustBeLessThanOrEqual`	Validate that value is less than or equal to another value

데이터형

`mustBeA`	Validate that value comes from one of specified classes (R2020b 이후)
`mustBeNumeric`	Validate that value is numeric
`mustBeNumericOrLogical`	Validate that value is numeric or logical
`mustBeFloat`	Validate that value is floating-point array (R2020b 이후)
`mustBeText`	값이 string형 배열, 문자형 벡터, 또는 문자형 벡터로 구성된 셀형 배열인지 확인 (R2020b 이후)
`mustBeTextScalar`	값이 한 조각의 텍스트인지 확인 (R2020b 이후)
`mustBeNonzeroLengthText`	Validate that value is text with nonzero length (R2020b 이후)
`mustBeUnderlyingType`	Validate that value has specified underlying type (R2020b 이후)

크기

`mustBeNonempty`	Validate that value is nonempty
`mustBeScalarOrEmpty`	Validate that value is scalar or empty (R2020b 이후)
`mustBeVector`	Validate that value is vector (R2020b 이후)
`mustBeRow`	Validate that value is row vector (R2024b 이후)
`mustBeColumn`	Validate that value is column vector (R2024b 이후)
`mustBeMatrix`	Validate that value is matrix (R2024b 이후)

범위 및 집합의 멤버인지 여부

`mustBeInRange`	Validate that value is in the specified range (R2020b 이후)
`mustBeMember`	Validate that value is member of specified set

이름

`mustBeFile`	Validate that path refers to file (R2020b 이후)
`mustBeFolder`	Validate that input path refers to folder (R2020b 이후)
`mustBeValidVariableName`	Validate that input name is valid variable name (R2020b 이후)

이름-값 인수 구조체

namedargs2cell Convert structure containing name-value pairs to cell array

가변 길이 인수 목록

입력값

`varargin`	가변 길이 입력 인수 목록
`nargin`	함수 입력 인수의 개수
`narginchk`	입력 인수 개수에 대한 유효성 검사

출력값

`varargout`	가변 길이 출력 인수 목록
`nargout`	함수의 출력 인수 개수
`nargoutchk`	Validate number of output arguments

추가 검사

`validateattributes`	배열의 유효성 검사
`validatestring`	Check validity of text
`validatecolor`	Validate color values (R2020b 이후)
`inputname`	함수 입력의 변수 이름
`mfilename`	현재 실행 중인 코드의 파일 이름
`inputParser`	함수의 입력값 구문 분석기

도움말 항목

인수 유효성 검사

함수 인수 유효성 검사

인수의 클래스 및 크기를 선언하고 인수 값을 제한합니다.
인수 유효성 검사 함수

유효성 검사 함수를 사용하여 인수의 특정 요구 사항에 대한 유효성을 검사합니다. 특정 인수 요구 사항을 확인하기 위해 고유한 함수를 작성합니다.
- Use Validation Functions to Avoid Unwanted Class and Size Conversions
- 인수 유효성 검사 중 nargin 함수 사용하기
validateattributes로 함수 입력값 검사하기
이 예제에서는 validateattributes 함수를 사용하여 함수에 대한 입력값이 일련의 요구 사항을 준수하는지 확인하는 방법을 보여줍니다.
함수 입력값 구문 분석하기

필수 입력값과 선택적 입력값을 정의하고, 선택적 입력값에 디폴트 값을 할당하고, 입력값 구문 분석기(Input Parser)를 사용하여 사용자 지정 함수에 대한 모든 입력값을 검증합니다.
- 입력값 구문 분석기 유효성 검사(Validation) 함수

인수 개수

가변 개수의 입력값을 받는 함수 정의하기
varargin을 사용하여 가변 개수의 입력 인수를 받는 함수를 정의합니다. varargin 인수는 셀형 배열로, 각 입력값을 셀 요소로 분리하여 함수 입력값을 포함합니다.
가변 개수의 출력값을 받는 함수 정의하기
varargout을 사용하여 가변 개수의 출력 인수를 반환하는 함수를 정의합니다. varargout은 함수 출력값들로 구성된 셀형 배열로, 각각의 함수 출력값은 셀에 들어 있습니다.
함수 인수의 개수 구하기

nargin 및 nargout을 사용하여 함수가 받는 입력 인수 또는 출력 인수의 개수를 확인합니다.
- 함수 인수 개수에 대한 유효성 검사하기
- 중첩 함수에서 인수의 개수 검사하기

무시되는 입력값

함수 정의에서 입력값 무시하기
함수가 미리 정의된 일련의 입력값을 받지만 받은 입력값을 모두 사용하지는 않는 경우, 물결표(~) 연산자를 사용하여 함수 정의에서 이러한 입력값을 무시합니다.