このページの翻訳は最新ではありません。ここをクリックして、英語の最新版を参照してください。

persistent

永続変数の定義

構文

persistent var1 ... varN

説明

persistent var1 ... varN は、変数 var1 ... varN が永続変数であることを宣言します。永続変数は、宣言される関数のローカル変数ですが、それらの値は関数の呼び出し間でメモリに保持されます。MATLAB^® コマンド ラインのコードや他の関数内のコードは永続変数を変更できません。

MATLAB が特定の persistent ステートメントを最初に検出すると、永続変数は空の行列 ([]) に初期化されます。

メモリ内の関数がクリアされるか変更されると、MATLAB は永続変数をクリアします。関数をメモリ内に維持するには、mlock を使用します。

例

関数の呼び出しのカウント

現在の作業フォルダー内に関数 myFun を作成します。関数を呼び出すたびに、n の値が増加します。

function myFun()
    persistent n
    if isempty(n)
        n = 0;
    end
    n = n+1
end

コマンド プロンプトで、myFun を 3 回呼び出します。

myFun
myFun
myFun

n =

     1


n =

     2


n =

     3

myFun をクリアしてから、さらに 2 回呼び出します。関数をクリアすると永続変数もクリアされます。

clear myFun
myFun
myFun

n =

     1


n =

     2

指定した時間間隔でのデータのログ

最後のログ入力から 3 秒以上経過しているとデータのログを取る関数を作成します。logTime を、logData が最後にファイルに書き込みを行った時刻を格納する永続変数として定義します。

現在の作業フォルダー内のファイルで、関数 logData を定義します。

function logData(fname,n)
    persistent logTime
    currTime = datetime;
    
    if isempty(logTime)
        logTime = currTime;
        disp('Logging initial value.')
        dlmwrite(fname,n)
        return
    end
    
    dt = currTime - logTime;
    if dt > seconds(3)
        disp('Logging.')
        dlmwrite(fname,n,'-append')
        logTime = currTime;
    else
      disp(['Not logging. ' num2str(seconds(dt)) ' sec since last log.'])
    end
end

コマンド プロンプトで、logData をループで呼び出します。このループには 10 回の反復があり、各反復にかかる時間は約 1 秒です。したがって、MATLAB は 4 つの値を myLog.txt に書き込みます (約 0 秒後、約 3 秒後、約 6 秒後、約 9 秒後)。

for n = 1:10
    pause(1)
    logData('myLog.txt',rand)
end

Logging initial value.
Not logging. 1.005 sec since last log.
Not logging. 2.009 sec since last log.
Logging.
Not logging. 1.007 sec since last log.
Not logging. 2.013 sec since last log.
Logging.
Not logging. 1.005 sec since last log.
Not logging. 2.007 sec since last log.
Logging.

関数 logData をもう一度呼び出し、別の値を追加します。

logData('myLog.txt',rand)

Logging.

関数 logData をクリアして、永続変数を再初期化します。関数 logData をもう一度呼び出します。今回は、この関数は値を追加せず、代わりに myLog.txt を上書きします。

clear logData
logData('myLog.txt',rand)

Logging initial value.

ヒント

• 永続変数とグローバル変数は、MATLAB がいずれに対しても永久記録媒体を作成するという点で類似しています。永続変数がグローバル変数と異なるのは、永続変数を宣言している関数のみで前者が認識されるという点です。そのため、MATLAB コマンド ラインのコードや他の関数で永続変数を変更することはできません。

• MATLAB は永続変数を空の行列 ([]) へと初期化するため、通常は関数により永続変数が空であるかどうか確認され、空であれば初期化されます。

  function myFun()
      persistent n
      if isempty(n)
          n = 0;
      end
      n = n+1;
  end

• 永続変数としての変数の宣言は、その変数に対する他の参照 (入力引数や出力引数を含む) より前に行わなければなりません。たとえば、次の関数における persistent 宣言は無効です。

  function myfunA(x)
      persistent x
  end
  
  function myfunB
      x = 0;
      persistent x
  end

• 永続変数をクリアするには、その変数を宣言している関数の名前を指定して clear を使用します。たとえば、clear myFun のようになります。

拡張機能

C/C++ コード生成

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

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

• 生成されたコード内の永続変数は、値を MATLAB と共有しません。

• 生成されたすべての MEX 関数は永続データの独自のコピーをもちます。特定の MEX 関数の各呼び出しは、以前の呼び出しの値を再利用します。

• Simulink^® モデルでは、各 MATLAB Function (Simulink) ブロックは永続データの独自のコピーを含んでいます。永続変数を含む MATLAB 関数が 2 つの異なるブロックから呼び出された場合、モデルは 2 つの永続変数をもちます。また、シミュレーションを実行するたびに、永続データの新しいコピーが作成されます。

• コード生成用の MATLAB コードでは、永続変数 p は、p を使用する前に代入されなければなりません。唯一の例外は isempty(p) を使用したチェックで、これは代入前に実行できます。このチェックを使用して、MATLAB コード内で p が使用される前に、代入されていることを確認できます。

• 親関数で永続変数を宣言する場合、その永続変数を使用する入れ子関数を呼び出す前に変数に代入しなければなりません。

• 生成されたコード内で永続変数の名前を変更することはできません。同じ変数を異なるプロパティで再利用する (MATLAB Coder)を参照してください。

• parfor (MATLAB Coder) ループの本体に永続変数の宣言を含めることはできません。

• 生成されたコードは、式の評価順序を適用しません。ほとんどの式において、評価順序は重要な意味をもちません。ただし、副作用を含む式では、生成コードと元の MATLAB コードとで副作用が異なる順序で生成される場合があります。副作用を伴う式には、永続変数を変更する式などがあります。生成されたコードと MATLAB コードの相違点 (MATLAB Coder)を参照してください。

• 永続変数が参照するハンドル オブジェクトはシングルトン オブジェクトでなければなりません。コード生成におけるハンドル オブジェクトの制限事項 (MATLAB Coder)を参照してください。

• コード ジェネレーターは、クラスの読み込み時にクラスの初期値を計算してからコード生成を行います。MATLAB クラス プロパティの初期化で永続変数を使用する場合、クラスの読み込み時に計算される永続変数の値は MATLAB に属します。この値はコード生成時に使用されません。

  特に、coder.target (MATLAB Coder) を MATLAB クラス プロパティの初期化で使用する場合、coder.target('MATLAB') は true を返します。

  コード生成のための MATLAB クラスの定義 (MATLAB Coder)を参照してください。

参考

clear | global | isempty | mislocked | mlock | munlock

R2006a より前に導入