Main Content

이 번역 페이지는 최신 내용을 담고 있지 않습니다. 최신 내용을 영문으로 보려면 여기를 클릭하십시오.

인수 정의

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

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

또한, 함수가 받는 입력값이나 출력값의 개수, 입력 변수의 이름 등을 검사할 수 있습니다.

함수

모두 확장

arguments 블록

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

숫자형 값 유효성 검사

mustBePositiveValidate that value is positive
mustBeNonpositiveValidate that value is nonpositive
mustBeNonnegativeValidate that value is nonnegative
mustBeNegativeValidate that value is negative
mustBeFiniteValidate that value is finite
mustBeNonNanValidate that value is not NaN
mustBeNonzeroValidate that value is nonzero
mustBeNonsparseValidate that value is nonsparse
mustBeRealValidate that value is real
mustBeIntegerValidate that value is integer
mustBeNonmissingValidate that value is not missing

비교

mustBeGreaterThanValidate that value is greater than another value
mustBeLessThanValidate that value is less than another value
mustBeGreaterThanOrEqualValidate that value is greater than or equal to another value
mustBeLessThanOrEqualValidate that value is less than or equal to another value

데이터형

mustBeAValidate that value comes from one of specified classes
mustBeNumericValidate that value is numeric
mustBeNumericOrLogicalValidate that value is numeric or logical
mustBeFloatValidate that value is floating-point array
mustBeTextValidate that value is string array, character vector, or cell array of character vectors
mustBeTextScalarValidate that value is single piece of text
mustBeNonzeroLengthTextValidate that value is text with nonzero length
mustBeUnderlyingTypeValidate that value has specified underlying type

크기

mustBeNonemptyValidate that value is nonempty
mustBeScalarOrEmptyValidate that value is scalar or empty
mustBeVectorValidate that value is vector

범위 및 집합의 원소인지 여부

mustBeInRangeValidate that value is in the specified range
mustBeMemberValidate that value is member of specified set

이름

mustBeFileValidate that path refers to file
mustBeFolderValidate that input path refers to folder
mustBeValidVariableNameValidate that input name is valid variable name

이름-값 인수 구조체

namedargs2cellConvert structure containing name-value pairs to cell array

입력값

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

출력값

varargout가변 길이 출력 인수 목록
nargout함수의 출력 인수 개수
nargoutchkValidate number of output arguments
validateattributes배열의 유효성 검사
validatestringCheck validity of text
validatecolorValidate color values
inputname함수 입력의 변수 이름
mfilename현재 실행 중인 코드의 파일 이름
inputParser함수의 입력값 구문 분석기

도움말 항목

인수 값

함수 입력값 구문 분석 방법

입력 인수의 유효성을 확인하는 방법을 선택합니다.

함수 인수 유효성 검사

입력 인수의 클래스 및 크기를 선언하고 인수 값을 제한합니다.

validateattributes로 함수 입력값 검사하기

이 예제에서는 validateattributes 함수를 사용하여 함수에 대한 입력값이 일련의 요구 사항을 준수하는지 확인하는 방법을 보여줍니다.

함수 입력값 구문 분석하기

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

인수 개수

가변 개수의 입력값을 받는 함수 정의하기

varargin을 사용하여 가변 개수의 입력 인수를 받는 함수를 정의합니다. varargin 인수는 셀형 배열로, 각 입력값을 셀 요소로 분리하여 함수 입력값을 포함합니다.

가변 개수의 출력값을 받는 함수 정의하기

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

함수 인수의 개수 구하기

narginnargout을 사용하여 함수가 받는 입력 인수 또는 출력 인수의 개수를 확인합니다.

무시되는 입력값

함수 정의에서 입력값 무시하기

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