Main Content

addParamValue

(권장되지 않음) 입력값 구문 분석기 체계에 선택적 이름-값 쌍의 인수 추가

페이지 내 모두 축소

addParamValue는 권장되지 않습니다. addParameter를 대신 사용하십시오.

구문

addParamValue(p,paramName,defaultVal)
addParamValue(p,paramName,defaultVal,validationFcn)

설명

예제

addParamValue(p,paramName,defaultVal)은 선택적 이름-값 쌍 인수의 파라미터 이름을 입력값 구문 분석기 체계에 추가합니다. 함수에 대한 입력값이 선택적 이름-값 쌍을 포함하지 않으면 입력값 구문 분석기는 paramName에 값 defaultVal을 지정합니다.

addRequired 함수와 addOptional 함수를 사용하여 추가하는 위치 입력값과는 달리 addParamValue를 사용하여 추가하는 각 파라미터는 2개의 입력 인수에 해당합니다. 그중 하나는 이름이고 다른 하나는 값입니다.

addParamValue(p,paramName,defaultVal,validationFcn)은 입력 인수에 대한 유효성 검사(Validation) 함수를 지정합니다.

예제

모두 축소

디폴트 값이 1인 myParam에 대응하는 값이 0보다 큰 숫자형 스칼라인지 확인합니다.

입력값 구문 분석기 체계를 만듭니다. 유효성 검사 함수의 경우, @(x)는 입력값을 하나 받는 익명 함수에 대한 핸들을 생성합니다.

p = inputParser;
paramName = 'myParam';
defaultVal = 1;
errorMsg = 'Value must be positive, scalar, and numeric.'; 
validationFcn = @(x) assert(isnumeric(x) && isscalar(x) ...
    && (x > 0),errorMsg);
addParamValue(p,paramName,defaultVal,validationFcn)

-1과 같은 잘못된 입력 인수를 구문 분석합니다.

parse(p,'myparam',-1)
The value of 'myparam' is invalid. Value must be positive, scalar, and numeric.

입력 인수

모두 축소

입력값 구문 분석기 체계로, inputParser 객체로 지정됩니다.

입력 파라미터의 이름으로, 문자형 벡터 또는 string형 스칼라로 지정됩니다.

예: "firstName"

예: 'address'

데이터형: char | string

입력값의 디폴트 값으로, 임의의 데이터형으로 지정됩니다. parse 함수는 입력값을 구문 분석할 때 argName이 함수에 대한 입력값이 아닌 경우, argName에 값 defaultVal을 할당합니다.

인수의 유효성을 검사하는 함수로, 함수 핸들로 지정됩니다.

함수 핸들은 true 또는 false를 반환하거나 테스트를 통과하거나 오류를 발생시키는 함수와 연결되어야 합니다. 두 가지 함수 모두 단일 입력 인수를 받아야 합니다.

예: @(s)isstring(s)

예: @(x)isnumeric(x)&&isscalar(x)

예: @(n)validateattributes(n,{'numeric'},{'nonnegative'})

데이터형: function_handle

팁

  • 파라미터 이름-값 쌍은 선택적 입력값입니다. 함수를 호출할 때, 이름-값 쌍은 위치 인수 뒤에서 순서에 상관없이 나타날 수 있습니다. 이러한 쌍은 일반적인 형식 Name1,Value1,...,NameN,ValueN을 취합니다.

버전 내역

R2007a에 개발됨

참고 항목

|

도움말 항목