このページの内容は最新ではありません。最新版の英語を参照するには、ここをクリックします。
matlab.unittest.TestSuite.fromName
クラス: matlab.unittest.TestSuite
名前空間: matlab.unittest
単一のテスト名からテスト スイートを作成する
構文
説明
suite = matlab.unittest.TestSuite.fromName(
は、1 つ以上の名前と値の引数を使用してオプションを指定します。たとえば、testName
,Name,Value
)suite = matlab.unittest.TestSuite.fromName(testName,"ExternalParameters",param)
は指定した外部パラメーターを使用して、スカラーのテスト スイートを作成します。
入力引数
testName
— テスト名
string スカラー | 文字ベクトル
テスト名。string スカラーまたは文字ベクトルとして指定します。特定のテスト ファイルにおいて、テストの名前はテスト内容のうち実行可能な最小部分を一意に識別します。テストの名前には、パッケージ名、ファイル名 (拡張子は除く)、プロシージャ名、およびパラメーター化に関する情報が含まれます。
testName
引数は、Test
オブジェクトの Name
プロパティに対応します。
名前と値の引数
引数のオプションのペアを Name1=Value1,...,NameN=ValueN
として指定します。ここで Name
は引数名で、Value
は対応する値です。名前と値の引数は他の引数の後になければなりませんが、ペアの順序は重要ではありません。
例: suite = matlab.unittest.TestSuite.fromName(testName,ExternalParameters=param)
R2021a より前では、コンマを使用してそれぞれの名前と値を区切り、Name
を引用符で囲みます。
例: suite = matlab.unittest.TestSuite.fromName(testName,"ExternalParameters",param)
ExternalParameters
— テストで使用する外部パラメーター
matlab.unittest.parameters.Parameter
オブジェクトの配列
テストで使用する外部パラメーター。matlab.unittest.parameters.Parameter
オブジェクトの配列として指定します。この引数を使用して、パラメーター化されたテスト内の既存のパラメーターの代わりに外部パラメーターを指定します。詳細については、パラメーター化されたテストでの外部パラメーターの使用を参照してください。
DependsOn
— ソース ファイルおよびフォルダーの名前
string ベクトル | 文字ベクトル | 文字ベクトルの cell ベクトル
テストに必要なソース ファイルおよびフォルダーの名前。string ベクトル、文字ベクトル、または文字ベクトルの cell ベクトルとして指定します。この引数を使用する場合、テストを定義しているファイルが、指定したソース コードに依存している必要があります。そうでない場合、メソッドは空のテスト スイートを返します。
指定するソース コードは、拡張子が .m
、.p
、.mlx
、.mlapp
、.mat
、または .slx
である 1 つ以上の既存のファイルを表している必要があります。サポートされていない拡張子をもつファイル名を指定することはできません。フォルダー名を指定した場合、フレームワークは、そのフォルダー内のサポートされるファイルのパスを抽出して展開します。
DependsOn
を使用するには、MATLAB® Test™ のライセンスが必要です。ソース コードの依存関係によるテストの選択の詳細については、matlabtest.selectors.DependsOn
(MATLAB Test) を参照してください。
例: ["myFile.m" "myFolder"]
例: ["folderA" "C:\work\folderB"]
例
テスト名からのテスト スイートの作成
静的メソッド fromName
を使用して、テスト名からスカラーのテスト スイートを作成します。
現在のフォルダー内のファイルに、関数 add5
を作成します。この関数は、数値入力を受け入れて 5 だけインクリメントします。非数値入力を指定して呼び出すと、関数はエラーをスローします。
function y = add5(x) % add5 - Increment input by 5 if ~isa(x,"numeric") error("add5:InputMustBeNumeric","Input must be numeric.") end y = x + 5; end
関数 add5
をテストするには、現在のフォルダー内の Add5Test.m
という名前のファイルで Add5Test
クラスを作成します。このクラスは、数値入力および非数値入力について関数をテストします。
classdef Add5Test < matlab.unittest.TestCase properties (TestParameter) type = {'double','single','int8','int32'}; end methods (Test) function numericInput(testCase,type) actual = add5(cast(1,type)); testCase.verifyClass(actual,type) end function nonnumericInput(testCase) testCase.verifyError(@() add5("0"),"add5:InputMustBeNumeric") end end end
TestSuite
クラスをインポートします。
import matlab.unittest.TestSuite
Add5Test
クラスからテスト スイートを作成し、テスト名を表示します。
suite = testsuite("Add5Test");
disp({suite.Name}')
{'Add5Test/numericInput(type=double)'} {'Add5Test/numericInput(type=single)'} {'Add5Test/numericInput(type=int8)' } {'Add5Test/numericInput(type=int32)' } {'Add5Test/nonnumericInput' }
nonnumericInput
メソッドに対応しているテストの名前からテスト スイートを作成します。結果として得られたテスト スイートには単一の Test
オブジェクトが含まれています。次に、テストを実行します。
suite1 = TestSuite.fromName("Add5Test/nonnumericInput");
result1 = run(suite1);
Running Add5Test . Done Add5Test __________
パラメーター化されたテストの名前からスカラーのテスト スイートを作成し、テストを実行します。
suite2 = TestSuite.fromName("Add5Test/numericInput(type=single)");
result2 = run(suite2);
Running Add5Test . Done Add5Test __________
バージョン履歴
R2014a で導入R2023a: ソース コードの依存関係によるテスト スイートのフィルター処理
テスト名からテスト スイートを作成すると、指定したソース コードへのテスト ファイルの依存関係でテスト スイートをフィルター処理できます。名前と値の引数 DependsOn
(MATLAB Test が必要) を使用してソース ファイルおよびフォルダーを指定します。
R2022b: cell 配列からよりわかりやすいパラメーター名を生成
空でない cell 配列をパラメーター化プロパティに代入すると、テスト フレームワークは cell 配列の要素の値、型、および次元を考慮して、それらの要素からパラメーター名を生成します。以前のリリースでは、プロパティ値が文字ベクトルの cell 配列である場合、フレームワークは cell 配列の値からパラメーター名を生成します。それ以外の場合、フレームワークはパラメーター名を value1
、value2
、…、valueN
として指定します。
コードでパラメーター名を使用してテスト スイートを作成したり、フィルター処理したりする場合は、古いパラメーター名をわかりやすいパラメーター名に置き換えてください。たとえば、suite = testsuite(pwd,"ParameterName","value1")
の value1
をわかりやすいパラメーター名に置き換えて更新します。
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)