addParamValue

(非推奨) オプションの名前と値のペア引数を入力パーサー スキームに追加

ページ内をすべて折りたたむ

addParamValue は推奨されません。代わりに addParameter を使用してください。

構文

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

説明

addParamValue(p,paramName,defaultVal) はオプションの名前と値のペア引数のパラメーター名を、入力パーサー スキームに追加します。関数の入力にこのオプションの名前と値のペアが含まれない場合、入力パーサーは paramName に値 defaultVal を割り当てます。

関数 addRequired および addOptional で追加される位置引数の入力とは異なり、addParamValue で追加される各パラメーターは 2 つの入力引数に対応します。1 つはパラメーター名、もう 1 つはパラメーター値です。

例

addParamValue(p,paramName,defaultVal,validationFcn) は入力引数の検証関数を指定します。

例

すべて折りたたむ

myParam に対応する値 (既定値 1) がゼロより大きい数値スカラーであることを検証します。

入力パーサー スキームを作成します。その検証関数について、@(x) は 1 つの入力を受け入れる無名関数のハンドルを作成します。

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

入力の既定値。任意のデータ型で指定します。argName が関数への入力ではない場合、関数 parse は入力を解析するときに、argName に値 defaultVal を割り当てます。

引数を検証する関数。関数ハンドルとして指定します。

関数ハンドルは、true または false を返す、テストをパスする、あるいはエラーをスローする、のいずれかを行う関数に関連付けなければなりません。いずれのタイプの関数も、単一の入力引数を受け入れなければなりません。

例: @(s)isstring(s)

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

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

データ型: function_handle

ヒント

  • パラメーターの名前と値のペアはオプションの入力です。関数の呼び出しでは、名前と値のペアは位置引数の後に任意の順序で指定できます。これらは一般的な Name1,Value1,...,NameN,ValueN の形式を取ります。

バージョン履歴

R2007a で導入

参考

|

トピック