Main Content

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

입력 인수와 출력 인수

가변 길이 인수 목록 지원, 인수 확인, 유효성 검사를 위한 인수 선언

함수는 단일 함수 시그니처를 사용하여 가변 개수의 입력값 및 출력값을 허용할 수 있습니다. MATLAB®은 입력값의 개수, 데이터형, 크기 및 다른 특성을 확인할 수 있는 여러 기법을 제공하여 함수가 의도대로 수행되는지 확인하고 입력값이 유효하지 않은 경우 유용한 오류 메시지를 제공합니다.

함수

모두 확장

nargin함수 입력 인수의 개수
nargout함수의 출력 인수 개수
varargin가변 길이 입력 인수 목록
varargout가변 길이 출력 인수 목록
narginchk입력 인수 개수에 대한 유효성 검사
nargoutchkValidate number of output arguments
validateattributes배열의 유효성 검사
validatestringCheck validity of text
validatecolorValidate color values
inputParser함수의 입력값 구문 분석기
inputname함수 입력의 변수 이름
mfilename현재 실행 중인 코드의 파일 이름
arguments함수 인수 유효성 검사 선언
namedargs2cellConvert structure containing name-value pairs to cell array

숫자형 값 특성 유효성 검사

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

멤버 및 범위 유효성 검사

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

특수 의미를 갖는 텍스트 유효성 검사

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

도움말 항목

인수의 개수 확인하기

함수 인수의 개수 구하기

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

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

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

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

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

함수 인수 개수에 대한 유효성 검사하기

사용자 지정 함수가 유효한 개수의 입력 인수 또는 출력 인수를 받는지를 검사합니다. MATLAB은 일부 인수 검사를 자동으로 수행합니다. 이외의 경우에는 narginchk 또는 nargoutchk를 사용할 수 있습니다.

중첩 함수 내 인수 검사하기

중첩 함수에 varargin, varargout, nargin, nargout을 사용하는 경우 특별히 고려해야 할 사항이 있습니다.

함수 입력값 무시하기

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

함수 출력값 무시하기

이 예제에서는 함수에서 특정 출력값을 요청하는 방법을 보여줍니다.

입력 인수 구문 분석하기

함수 입력값 구문 분석 방법

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

함수 인수 유효성 검사

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

validateattributes로 함수 입력값 검사하기

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

함수 입력값 구문 분석하기

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