arguments

입력값의 크기를 임의 길이의 행 벡터로 제한하는 함수를 작성합니다. 유효성 검사 함수를 사용하여 해당 벡터의 요소를 숫자형 값으로 제한합니다.

function [m,s] = twoStats(x)
    arguments
        x (1,:) {mustBeNumeric}
    end
    m = mean(x,"all");
    s = std(x,1,"all");
end

요소를 3개 가진 행 벡터에 대해 함수를 호출합니다.

a = [1 3 5];
[m,s] = twoStats(a)

m =

     3


s =

    1.6330

행 벡터와 열 벡터는 호환되기 때문에 열 벡터를 사용하여 함수를 호출하는 것도 유효합니다.

a = [1 3 5]';
[m,s] = twoStats(a)

m =

     3


s =

    1.6330

숫자가 아닌 값을 포함하는 벡터를 사용하여 함수를 호출할 경우 mustBeNumeric 유효성 검사 함수가 오류를 발생시킵니다.

a = ["1" "3" "5"];
[m,s] = twoStats(a)

Error using twoStats
Invalid argument at position 1. Value must be numeric.

함수에 대해 선택적인 이름-값 인수를 선언하려면 함수 선언에 구조체 이름을 포함하고, arguments 블록 내에서 인수 이름을 해당 구조체의 필드로 정의하십시오.

options를 구조체 이름으로 사용하여 myRectangle 함수를 선언합니다. options의 두 필드인 LineStyle과 LineWidth는 함수의 이름-값 인수의 이름입니다.

function myRectangle(X,Y,options)
    arguments
       X double
       Y double
       options.LineStyle (1,1) string = "-" 
       options.LineWidth (1,1) {mustBeNumeric} = 1
    end
    % Function code
    ...
end

두 인수 이름 모두 정의된 디폴트 값을 가지므로 둘 다 선택 사항입니다. 다음 구문은 모두 이 함수를 호출할 수 있는 유효한 방법입니다.

myRectangle(4,5)
myRectangle(4,5,LineStyle=":",LineWidth=2)
myRectangle(4,5,LineWidth=2,LineStyle=":")
myRectangle(4,5,LineStyle=":")
myRectangle(4,5,LineWidth=2)

R2021a 이전 릴리스에서는 이름을 string형 또는 문자형 벡터로 전달하고 이름과 값을 쉼표로 구분해야 합니다. 두 구문 모두 이후 릴리스에서 유효합니다.

반복 인수란 함수 호출에서 0번 이상 반복될 수 있는 단일 인수 또는 인수 그룹입니다. fRepeat 함수는 인수 x, y, style의 반복되는 그룹을 받습니다. 입력 인수 x와 y를 double형 값으로 구성된 벡터 또는 double형으로 변환할 수 있는 값으로 구성된 벡터로 제한합니다. style을 문자열 "--" 및 ":"으로 제한합니다.

function fRepeat(x,y,style)
    arguments (Repeating)
        x (1,:) double
        y (1,:) double
        style {mustBeMember(style,["--",":"])}       
    end
    
    % Reshape the cell arrays of inputs and call plot function
    z = reshape([x;y;style],1,[]);
    if ~isempty(z)
        plot(z{:});
    end
end

fRepeat를 입력값 2개 그룹을 사용하여 호출합니다. MATLAB은 x에 대해 전달된 모든 값을 포함하는 셀형 배열, y의 값에 대한 또 다른 배열, 그리고 style의 값에 대한 세 번째 배열을 만듭니다. 그런 다음 함수는 이 배열들을 1×6 셀형 배열 z로 형태 변경하여 plot으로 전달합니다.

x1 = 1:10;
y1 = 1:10; 
s1 = ":"; 
x2 = 1:7;
y2 = 1:1.5:10;
s2 = "--";
fRepeat(x1,y1,s1,x2,y2,s2)

점 (0.4, 0.4)를 기준으로 사용자가 지정한 각도만큼 2차원 정사각형 패치를 회전하는 함수를 작성합니다. 최종 이미지의 x 좌표와 y 좌표를 출력 인수로 반환하고 이러한 값을 양수로 제한합니다. 즉, 함수는 회전의 최종 결과가 완전히 첫 번째 사분면에 있을 때만 좌표를 반환해야 합니다.

function [xfinal,yfinal] = rotatePatch(angle)
    arguments (Output)
        xfinal {mustBePositive}
        yfinal {mustBePositive}
    end
    x = [0.1 0.1 0.7 0.7];
    y = [0.1 0.7 0.7 0.1];
    p = patch(x,y,"red");
    rotate(p,[0 0 1],angle,[0.4 0.4 0])
    xfinal = p.Vertices(:,1);
    yfinal = p.Vertices(:,2);
end

15도 각도를 사용하여 함수를 호출합니다. 이 회전은 꼭짓점을 첫 번째 사분면 바깥으로 이동시키지 않으므로 함수는 오류 없이 값을 반환합니다.

[x1,y1] = rotatePatch(15)

x1 =

    0.1879
    0.0326
    0.6121
    0.7674


y1 =

    0.0326
    0.6121
    0.7674
    0.1879

35도 각도를 사용하여 함수를 호출합니다. 이 경우 왼쪽 아래 꼭짓점이 첫 번째 사분면 바깥으로 이동합니다. 음의 x 좌표는 출력 인수 유효성 검사를 충족하지 않으므로 함수는 오류를 반환합니다.

[x2,y2] = rotatePatch(35)

Invalid output 'xfinal'. Value must be positive.

Error in rotatePatch (line 12)
end

반복 벡터 쌍을 수락하고 각 쌍의 합을 반환하는 함수를 작성합니다. 입력값과 출력값을 행 벡터로 제한합니다.

function vectorSum = repeatSum(a,b)
  arguments (Input,Repeating)
    a (1,:)
    b (1,:)
  end
  arguments (Output,Repeating)
    vectorSum (1,:)
  end

  n = numel(a);
  vectorSum{n} = a{n} + b{n};
  for i = 1:n-1
    vectorSum{i} = a{i} + b{i};
  end
end

for 루프 전에 최종 출력값을 계산하고 이 값을 vectorSum{n}에 할당하면 셀형 배열을 위한 공간이 사전할당됩니다. 사전할당 없이 루프에서 셀형 배열을 확장하면 성능에 부정적인 영향을 미칠 수 있습니다.

두 쌍의 벡터를 정의합니다. 두 쌍을 입력값으로 하여 repeatSum을 호출합니다. 열 벡터와 행 벡터의 크기가 서로 호환되므로 입력 인수 블록 유효성 검사에서 열 벡터를 행 벡터로 변환합니다.

x1 = [1 2];
y1 = [3 4];
x2 = [1; 0];
y2 = [0; 1];
[sum1,sum2] = repeatSum(x1,y1,x2,y2)

sum1 =

     4     6


sum2 =

     1     1

입력값은 행 벡터로 제한되기 때문에 각 벡터 쌍의 합은 항상 행 벡터입니다. 하지만 출력 유효성 검사는 함수가 나중에 수정되더라도 해당 함수가 행 벡터를 생성하도록 지원합니다. 예를 들어, 입력 유효성 검사를 mustBeVector 함수로 변경한 경우 변환 없이 행 벡터 1개와 열 벡터 1개로 쌍을 구성할 수 있습니다. 이런 경우 x1과 y2의 합은 행렬입니다.

x1 + y2

ans =

     1     2
     2     3

행렬이 출력 유효성 검사를 통과하지 못하기 때문에 수정된 repeatSum 출력에 오류가 발생합니다.