toc は、関数 tic によってストップウォッチタイマーが開始されてからの経過時間を読み取ります。MATLAB^® は関数 toc 実行時の内部時間を読み取り、出力を指定しない関数 tic の最後の呼び出しから経過した時間を表示します。経過時間は秒単位で表現されます。

toc(timerVal) は timerVal に対応する関数 tic の呼び出しからの経過時間を表示します。

elapsedTime = toc は、関数 tic の最後の呼び出しからの経過時間を返します。

例

elapsedTime = toc(timerVal) は timerVal に対応する関数 tic の呼び出しからの経過時間を返します。

例

すべて折りたたむ

時間の測定による乱数行列の作成

ライブスクリプトを開く

2 つの乱数行列を作成するために必要な時間を測定します。

tic
A = rand(12000,4400);
B = rand(12000,4400);
toc

Elapsed time is 1.482072 seconds.

1 つの tic 呼び出しから複数の間隔を測定

ライブスクリプトを開く

プログラムの複数の異なるポイントで、関数 tic の呼び出しからの経過時間を測定します。

tic
A = rand(12000,4400);
B = rand(12000,4400);
toc

Elapsed time is 1.214253 seconds.

C = A.*B;
toc

Elapsed time is 1.406756 seconds.

複数の tic 呼び出しを使用した測定

ライブスクリプトを開く

tic および toc 呼び出しの 1 つのペアを使用して、要素単位の行列乗算に必要な合計時間をレポートします。もう 1 つのペアを使用して、プログラムの合計実行時間をレポートします。

tStart = tic;           % pair 2: tic
n = 10;
T = zeros(1,n);
for i = 1:n
    A = rand(12000,4400);
    B = rand(12000,4400);
    tic         % pair 1: tic
    C = A.*B;
    T(i)= toc;  % pair 1: toc
end
tMul = sum(T)

tMul = 0.6832

tEnd = toc(tStart)      % pair 2: toc

tEnd = 13.7944

変数 tMul には乗算にかかった合計時間が含まれます。tEnd はプログラム開始時に関数 tic 呼び出してからの経過時間を指定します。

入力引数

すべて折りたたむ

`timerVal` — 内部タイマーの値
8 バイト (64 ビット) 符号なし整数

関数 tic の以前の呼び出しで保存された内部タイマーの値。uint64 型のスカラーとして指定します。

ヒント

入力を指定せずに関数 toc を連続して呼び出すと、最後の tic 呼び出しからの経過時間を返します。このプロパティにより、ある時点からの複数の測定値を取得することができます。
同じ timerVal 入力を指定して関数 toc を連続して呼び出すと、timerVal に対応する関数 tic の呼び出しからの経過時間を返します。
場合によっては、プログラムの実行が速すぎて tic と toc では有効なデータを取得できない場合があります。コードの実行が 1/10 秒より速い場合は、コードをループ内で実行して測定し、次に平均を算出して 1 回の実行時間を求めることを検討してください。詳細については、コードのパフォーマンスの測定を参照してください。
次の操作を実行すると、予期せぬ出力が発生します。
- tic および toc を使用した timeit の時間測定
- timeit によって時間測定される関数内での tic と toc の使用

拡張機能

C/C++ コード生成
MATLAB® Coder™ を使用して C および C++ コードを生成します。

使用上の注意事項および制限事項:

toc から返されるデータ型は MATLAB と生成コードで異なります。エラーを避けるため、MEX 関数の toc の出力値を MATLAB で使用したり、MATLAB の toc の出力値を MEX 関数で使用したりしないでください。
tic を MATLAB セッションで呼び出して toc を MEX 関数で呼び出した場合 (逆の場合も同様)、タイミング結果は調整されません。
生成されたコード内の toc の C/C++ 実装は、コード生成構成オブジェクトに格納されているハードウェア設定によって異なります。既定でハードウェア設定はホストプラットフォーム用に構成され、MATLAB Coder™ アプリで Hardware Board は MATLAB Host Computer に設定されます。
- Windows^® 互換ハードウェア設定を使用した Windows でコードを生成すると、生成された C/C++ 実装は Windows API 関数 QueryPerformanceFrequency および QueryPerformanceCounter を使用します。
- それ以外の場合、実装は POSIX API clock_gettime を使用します。POSIX API を使用するコードをコンパイルする場合、プリプロセッサマクロ _POSIX_C_SOURCE を 199309L 以上の整数に設定しなければなりません。コードジェネレーターはコンパイルのためにこのマクロを 199309L に設定します。