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에 대한 인덱스는 컴파일타임 상수여야 합니다.

버전 내역

R2006a 이전에 개발됨

R2024b: HDL Coder에서 셀형 배열에 대한 다중 인덱싱 입력 인수 지원

HDL 블록 속성 아키텍처가 MATLAB Datapath로 설정되어 있고 셀형 배열에 대한 다중 인덱스 입력 인수를 가진 MATLAB Function 블록에서 varargin을 사용할 수 있습니다. 예를 들어 이제 다음 코드 조각에 대한 HDL 코드를 생성할 수 있습니다.

[x, y] = varargin{1:2};

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 테스트 시스템에서 측정했습니다.

R2022a: MATLAB Datapath 아키텍처를 사용하여 MATLAB Function 블록에 대한 HDL 생성

HDL 블록 속성 아키텍처가 MATLAB Datapath로 설정된 MATLAB Function 블록에서 함수에 대한 HDL 코드를 생성할 수 있습니다. 이러한 함수는 입력 인수 varargin을 사용할 수 있습니다. HDL 함수 checkhdl은 varargin을 사용하여 셀형 배열이 올바르게 액세스되고 초기화되었는지 확인할 수 있습니다.

참고 항목

varargout | nargin | narginchk

도움말 항목

• 가변 개수의 입력값을 받는 함수 정의하기
• 중첩 함수에서 인수의 개수 검사하기