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

함수 래퍼 만들기

라이브 스크립트 열기

작업 폴더에 있는 파일에서 빨간색 선을 플로팅하는 plot 함수에 대한 래퍼를 만듭니다. redplot 함수는 가변 길이 입력 인수 목록을 받아서 가변 길이 출력 인수 목록을 반환합니다. 이것은 선 색을 빨간색으로 설정하고 기타 입력값을 plot 함수에 전달합니다. 이 함수 래퍼를 사용하여 redplot에 plot과 동일한 입력값을 전달하고 선 색이 빨간색임을 지정해 주지 않을 수 있습니다.

type redplot.m

function varargout = redplot(varargin)
    [varargout{1:nargout}] = plot(varargin{:},'Color',[1,0,0]);
end

redplot을 사용하여 선 플롯을 생성합니다.

x = 0:pi/100:2*pi;
y = sin(x);
redplot(x,y)

Figure contains an axes object. The axes object contains an object of type line.

redplot을 다시 호출하고 plot 함수에 전달할 입력 인수와 출력 인수를 지정합니다.

h = redplot(x,y,'Marker','o','MarkerEdgeColor','green');

Figure contains an axes object. The axes object contains an object of type line.

확장 기능

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

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

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

HDL 코드 생성
HDL Coder™를 사용하여 FPGA나 ASIC 설계용의 Verilog 코드나 VHDL 코드를 생성할 수 있습니다.

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

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