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

nargin

함수 입력 인수의 개수

구문

nargin

nargin(fun)

설명

nargin은 현재 실행 중인 함수 호출에 주어진 함수 입력 인수 개수를 반환합니다. 이 구문은 함수 본문에만 사용하십시오. arguments 유효성 검사 블록을 사용할 때, 함수 내에서 nargin에 의해 반환되는 값은 함수 호출 시 제공되는 위치 인수의 개수입니다. 자세한 내용은 인수 유효성 검사 중 nargin 함수 사용하기 항목을 참조하십시오.

nargin(fun)은 fun 함수 정의에 나타나는 입력 인수 개수를 반환합니다. 함수의 정의에 varargin이 포함된 경우 nargin은 입력값 개수를 음수로 반환합니다. 예를 들어, 함수 myFun이 입력 인수 a, b, varargin을 선언하는 경우 nargin('myFun')은 -3을 반환합니다.

fun이 arguments 유효성 검사 블록을 사용하는 함수를 참조하는 경우, 반환되는 값은 함수 정의에서 음이 아닌 값으로 선언되는 위치 인수의 개수입니다.

예제

현재 함수에 대한 입력값

addme.m이라는 파일에 최대 두 개의 입력값을 받는 함수를 생성합니다. 함수 본문에 nargin을 사용하여 입력값 개수를 확인합니다.

type addme.m

function c = addme(a,b)
    switch nargin
        case 2
            c = a + b;
        case 1
            c = a + a;
        otherwise
            c = 0;
    end
end

명령 프롬프트에서 두 개의 입력값으로 addme 함수를 호출합니다.

c = addme(13,42)

c = 55

하나의 입력값으로 함수를 호출합니다.

c = addme(13)

c = 26

함수에 대해 정의된 입력값

함수가 받는 입력값 개수를 확인합니다.

이전 예제에서 만든 함수 addme의 선언문에는 두 개의 입력값(a와 b)이 있습니다. 함수의 이름을 문자형 벡터로 정의하고 이것을 nargin에 대한 입력값으로 사용합니다.

fun = 'addme';
nargin(fun)

ans = 2

varargin을 사용하는 함수에 대한 입력값

varargin을 사용하는 함수가 받을 수 있는 입력값 개수를 확인합니다.

mynewplot.m이라는 이름의 파일에 숫자형 입력값인 x, y와 varargin을 사용한 임의의 개수의 추가 플롯 입력값을 받는 함수를 생성합니다.

type mynewplot.m

function mynewplot(x,y,varargin)
    figure
    plot(x,y,varargin{:})
    title('My New Plot')
end

newplot 이 받을 수 있는 입력값 개수를 쿼리합니다.

fx = 'mynewplot';
nargin(fx)

ans = -3

마이너스 기호는 세 번째 입력값이 varargin임을 나타냅니다. mynewplot 함수는 정해지지 않은 개수의 추가 입력 인수를 받을 수 있습니다.

입력 인수

fun — 함수

함수 핸들 | 문자형 벡터 | string형 스칼라

함수로서, nargin은 이 함수의 정의로부터 입력 인수 개수를 반환합니다. 함수 핸들, 문자형 벡터 또는 string형 스칼라로 지정됩니다.

예: @cos

예: 'plot'

데이터형: char | function_handle

확장 기능

C/C++ 코드 생성

MATLAB® Coder™를 사용하여 C 코드나 C++ 코드를 생성할 수 있습니다.

사용법 관련 참고 및 제한 사항:

• 구문 nargin(fun)에 대해, fun이 C/C++ 코드 생성이 지원하지 않는 함수 이름 또는 함수 핸들인 경우 nargin에 대한 생성된 코드는 0을 반환합니다.

스레드 기반 환경

MATLAB®의 backgroundPool을 사용해 백그라운드에서 코드를 실행하거나 Parallel Computing Toolbox™의 ThreadPool을 사용해 코드 실행 속도를 높일 수 있습니다.

이 함수는 스레드 기반 환경을 완전히 지원합니다. 자세한 내용은 스레드 기반 환경에서 MATLAB 함수 실행하기 항목을 참조하십시오.

버전 내역

R2006a 이전에 개발됨

참고 항목

narginchk | nargout | varargin

도움말 항목

• 인수 유효성 검사 중 nargin 함수 사용하기
• 함수 인수의 개수 구하기
• 함수 인수 유효성 검사
• 중첩 함수에서 인수의 개수 검사하기