matlab.perftest.TestCase クラス

名前空間: matlab.perftest
スーパークラス: matlab.unittest.TestCase

matlab.perftest パフォーマンステストクラスのスーパークラス

説明

測定境界の定義が可能なクラスベースのパフォーマンステストを作成するには、matlab.perftest.TestCase クラスを使用します。既定では、フレームワークはテストメソッドの境界の周囲でパフォーマンスを測定します。しかし、matlab.perftest.TestCase から継承するテストクラスは startMeasuring メソッドおよび stopMeasuring メソッドを使用して境界を定義し、特定のコードセグメントを測定できます。

matlab.perftest.TestCase は matlab.unittest.TestCase クラスから派生します。

構築

テストフレームワークは matlab.perftest.TestCase インスタンスを作成します。

メソッド

keepMeasuring	自動ループによるコードの測定
startMeasuring	測定境界の開始を指定
stopMeasuring	測定境界の終了を指定

継承メソッド

addTeardown	破棄コードをテストケースに動的に追加
applyFixture	テストケースでフィクスチャを使用
createTemporaryFolder	Create temporary folder
forInteractiveUse	対話型で使用するテストケースを作成
getSharedTestFixtures	共有テストフィクスチャへのアクセスの提供
log	テスト実行中の診断情報の記録
onFailure	テスト失敗の診断情報を動的に追加
run	テストケースに対応するテストを実行

また、TestCase クラスは以下のクラスからメソッドを継承します。

`matlab.unittest.qualifications.Assertable`	テストの前提条件を検証する検定
`matlab.unittest.qualifications.Assumable`	テストの内容をフィルター処理する検定
`matlab.unittest.qualifications.FatalAssertable`	テストの実行を中断する検定
`matlab.unittest.qualifications.Verifiable`	ソフトエラー条件を生成する検定

コピーのセマンティクス

ハンドル。コピー操作に対するハンドルクラスの影響については、オブジェクトのコピーを参照してください。

例

すべて折りたたむ

パフォーマンステストクラスを作成

パフォーマンステストクラス preallocationTest を作成します。パフォーマンステストフレームワークは 4 つのテストメソッドのそれぞれについて時間を測定します。

classdef preallocationTest < matlab.perftest.TestCase
    methods(Test)
        function testOnes(testCase)
            x = ones(1,1e7);
        end
        
        function testIndexingWithVariable(testCase)
            id = 1:1e7;
            x(id) = 1;
        end
        
        function testIndexingOnLHS(testCase)
            x(1:1e7) = 1;
        end
        
        function testForLoop(testCase)
            for i=1:1e7
                x(i) = 1;
            end
        end
        
    end
end

パフォーマンステストクラスの境界を指定

パフォーマンステストクラス fprintfTest を作成します。パフォーマンステストフレームワークは startMeasuring メソッドの呼び出しと stopMeasuring メソッドの呼び出しの間にあるコードを測定します。この境界は、パフォーマンステストフレームワークが関数 fprintf の呼び出しのみを測定するように制限します。セットアップ動作、破棄動作および検定テストを除外します。

classdef fprintfTest < matlab.perftest.TestCase
    methods(Test)
        function testPrintingToFile(testCase)
            file = tempname;
            fid = fopen(file, 'w');
            testCase.assertNotEqual(fid, -1, 'IO Problem');
            
            stringToWrite = repmat('abcdef', 1, 1000000);
            
            testCase.startMeasuring();
            fprintf(fid, '%s', stringToWrite);
            testCase.stopMeasuring();
            
            testCase.verifyEqual(fileread(file), stringToWrite);
            fclose(fid);
        end
    end
end