mustBeUnderlyingType
説明
例
引数に基となる型が指定されていることを検証
mustBeUnderlyingType
を使用して、入力が基となる型 double
をもっていることを検証します。
distributed
配列を作成してから (Parallel Computing Toolbox™ が必要)、基となるデータ型が double
であることを検証します。
x = distributed(single(1:10));
mustBeUnderlyingType(x,"double")
Starting parallel pool (parpool) using the 'local' profile ... Connected to the parallel pool (number of workers: 6).
Value must have underlying type 'double'.
分散配列の基となる型が single
であるため、mustBeUnderlyingType
はエラーをスローします。
関数の引数値の制限
mustBeUnderlyingType
を使用して、関数によって受け入れられる入力引数値を制限します。これを行うには、入力引数を検証する関数に arguments
ブロックを追加します。
この関数は 1 つの入力引数を宣言します。arguments
ブロックでは、入力は基となるデータ型 single
をもたなければなりません。
function y = mbSingle(input) arguments input {mustBeUnderlyingType(input,"single")} end disp("Input is class " + class(input) + ... " with underlying type " + underlyingType(input) + ".") end
基となるデータ型 single
をもつ distributed
ベクトル (Parallel Computing Toolbox が必要) を使用して関数を呼び出します。入力が引数の検証に渡されるため、関数 mbSingle
はクラスおよび基となる型に関する情報を出力します。
x = distributed(single(1:10)); mbSingle(x)
Starting parallel pool (parpool) using the 'local' profile ... Connected to the parallel pool (number of workers: 6). Input is class distributed with underlying type single.
入力引数
value
— 検証する値
スカラー | 配列 | オブジェクト
検証する値。スカラー、配列、またはオブジェクトとして指定します。
例: mustBeUnderlyingType(magic(4),"single")
typename
— テストするデータ型の名前
文字ベクトル | string スカラー
テストするデータ型の名前。文字ベクトルまたは string スカラーとして指定します。
例: mustBeUnderlyingType(X,"double")
は、X
が基となる型 double
をもたない場合にエラーをスローします。
データ型: char
| string
ヒント
mustBeUnderlyingType
は、プロパティと関数の引数の検証で使用されるように設計されています。
拡張機能
GPU 配列
Parallel Computing Toolbox™ を使用してグラフィックス処理装置 (GPU) 上で実行することにより、コードを高速化します。
この関数は GPU 配列を完全にサポートしています。詳細については、GPU での MATLAB 関数の実行 (Parallel Computing Toolbox)を参照してください。
分散配列
Parallel Computing Toolbox™ を使用して、クラスターの結合メモリ上で大きなアレイを分割します。
この関数は分散配列を完全にサポートしています。詳細については、分散配列を使用した MATLAB 関数の実行 (Parallel Computing Toolbox)を参照してください。
バージョン履歴
R2020b で導入
MATLAB コマンド
次の MATLAB コマンドに対応するリンクがクリックされました。
コマンドを MATLAB コマンド ウィンドウに入力して実行してください。Web ブラウザーは MATLAB コマンドをサポートしていません。
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)