varargin

가변 길이 입력 인수 목록

구문

varargin

설명

varargin은 함수 정의문의 입력 변수로, 이를 사용하면 함수가 임의 개수의 입력 인수를 받을 수 있습니다. 소문자를 사용하여 varargin을 지정합니다. 명시적으로 선언한 입력값 다음에 varargin을 마지막 입력 인수로 포함시켜야 합니다.

함수가 실행되면 varargin은 1×N 셀형 배열이 되고, 여기서 N은 명시적으로 선언된 입력값 다음에 함수가 받게 되는 입력값 개수입니다. 명시적으로 선언된 입력값 다음에 함수가 입력값을 받지 못한 경우 varargin은 빈 셀형 배열입니다.

예제

모두 확장

가변적인 개수의 입력값을 받는 함수

라이브 스크립트 열기

이름이 acceptVariableNumInputs.m인 파일에 가변적인 개수의 입력값을 받아 그 입력값의 값을 각각 표시하는 함수를 정의합니다.

type acceptVariableNumInputs

function acceptVariableNumInputs(varargin)
    disp("Number of input arguments: " + nargin)
    celldisp(varargin)
end

여러 개의 입력값을 포함한 함수를 호출합니다.

acceptVariableNumInputs(ones(3),'some text',pi)

Number of input arguments: 3
 
varargin{1} =
 
     1     1     1
     1     1     1
     1     1     1

 
 
varargin{2} =
 
some text
 
 
varargin{3} =
 
    3.1416

`varargin`과 선언된 입력값

라이브 스크립트 열기

이름이 definedAndVariableNumInputs.m인 파일에, 두 개의 입력값을 기본으로 받고 추가 개수의 입력값을 허용하는 함수를 정의합니다.

type definedAndVariableNumInputs

function definedAndVariableNumInputs(X,Y,varargin)
    disp("Total number of input arguments: " + nargin)
    
    formatSpec = "Size of varargin cell array: %dx%d";
    str = compose(formatSpec,size(varargin));
    disp(str)

end

여러 개의 입력값을 포함한 함수를 호출합니다.

definedAndVariableNumInputs(7,pi,rand(4),datetime('now'),'hello')

Total number of input arguments: 5
Size of varargin cell array: 1x3

2개의 입력값을 포함하여 함수를 호출합니다. varargin은 빈 셀형 배열입니다.

definedAndVariableNumInputs(13,42)

Total number of input arguments: 2
Size of varargin cell array: 0x0

가변적인 개수의 입력값과 출력값

라이브 스크립트 열기

이름이 variableNumInputAndOutput.m인 파일에 가변적인 개수의 입력값과 출력값을 받는 함수를 정의합니다.

type variableNumInputAndOutput

function varargout = variableNumInputAndOutput(varargin)
    disp(['Number of provided inputs: ' num2str(length(varargin))])
    disp(['Number of requested outputs: ' num2str(nargout)])
    
    for k = 1:nargout
        varargout{k} = k;
    end
end

입력값 2개와 출력값 3개를 포함한 함수를 호출합니다.

[d,g,p] = variableNumInputAndOutput(6,'Nexus')

Number of provided inputs: 2
Number of requested outputs: 3

d = 1

g = 2

p = 3

입력값이나 출력값 없이 함수를 다시 호출합니다.

variableNumInputAndOutput

Number of provided inputs: 0
Number of requested outputs: 0

확장 기능

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

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

varargin을 사용하여 진입점(최상위) 함수에 대한 인수를 정의하는 경우, 코드 생성기는 고정된 개수의 입력 인수를 사용하는 C/C++ 함수를 생성합니다. 코드 생성 시 지정하는 인수의 개수에 따라 인수의 고정 개수가 결정됩니다.
varargin에는 쓸 수 없습니다. 입력 인수에 쓰고 싶다면, 먼저 입력 인수를 지역 변수에 복사하십시오.
varargin에 대한 인덱스는 컴파일타임 상수여야 합니다.

HDL 코드 생성
HDL Coder™를 사용하여 FPGA 및 ASIC 설계를 위한 VHDL, Verilog 및 SystemVerilog 코드를 생성할 수 있습니다.

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

varargin에는 쓸 수 없습니다. 입력 인수에 쓰고 싶다면, 먼저 입력 인수를 지역 변수에 복사하십시오.
varargin을 HDL 블록 속성 아키텍처가 MATLAB Datapath로 설정된 MATLAB function 블록에서 사용하려면 다음을 수행하십시오.
- 셀형 배열을 만들 때 varargin만 사용해야 합니다. cell 함수를 사용하거나 cellArr = {1,2,3}과 같은 중괄호를 사용하여 셀형 배열을 만드는 등 다른 초기화 기법은 사용할 수 없습니다.
- 셀형 배열에 대해 다중 인덱싱을 사용할 수 없습니다. 예를 들어, 이 코드 조각은 HDL 코드 생성에서 오류를 일으킵니다.
  [x, y] = varargin{1:2};

버전 내역

R2006a 이전에 개발됨

모두 확장

R2023a: 0개 이상의 입력값을 지정할 때의 성능이 개선됨

varargin을 사용하여 가변 개수의 입력 인수를 지정할 때의 성능이 향상되었습니다. 예를 들어, 현재 폴더에 있는 timingTest.m이라는 파일에 하나의 입력값을 기본으로 받고 추가 개수의 입력값을 허용하는 함수를 만듭니다.

function timingTest(x,varargin)
n = 1e6;
tic
for i = 1:n
    y = myFun(x,varargin{:});
end
toc
end

function y = myFun(x,varargin)
if nargin == 1
    y = x;
elseif nargin == 3
    y = x + varargin{1} + varargin{2};
else
    y = NaN;
end
end

성능의 향상 정도는 varargin이 비어 있는지 여부에 따라 다릅니다. varargin이 비어 있을 때 성능 개선이 가장 두드러집니다.

비어 있는 varargin — timingTest(1)을 실행하여 이 코드의 실행 시간을 측정합니다. 이 코드는 이전 릴리스보다 약 22배 빠릅니다. 대략적인 실행 시간은 다음과 같습니다.
R2022b: 0.404초
R2023a: 0.018초
비어 있지 않은 varargin — timingTest(1,2,3)을 실행하여 이 코드의 실행 시간을 측정합니다. 이 코드는 이전 릴리스보다 약 2배 빠릅니다. 대략적인 실행 시간은 다음과 같습니다.
R2022b: 1.428초
R2023a: 0.734초

코드 실행 시간은 Windows^® 10, Intel^® Xeon^® CPU E5-1650 v4 @ 3.60GHz 테스트 시스템에서 측정했습니다.