Main Content

cdflib.setVarsCacheSize

すべての変数に使用されるキャッシュ バッファーの数の指定

構文

cdflib.setVarsCacheSize(cdfId,varNum,numBuffers)

説明

cdflib.setVarsCacheSize(cdfId,varNum,numBuffers) は、CDF ライブラリがマルチファイル形式の CDF (Common Data Format) ファイル内のすべての変数に使用するキャッシュ バッファーの数を指定します。

この関数は、シングルファイル形式の CDF には適用できません。キャッシュの詳細は、『CDF ユーザー ガイド』を参照してください。

入力引数

cdfId

関数 cdflib.create または関数 cdflib.open の呼び出しによって返される、CDF ファイル識別子。

varNum

ファイルでの変数を識別する数値。変数識別子 (変数番号) は 0 ベースです。

numBuffers

キャッシュ バッファーを指定する数値。

マルチファイルの CDF を作成し、すべての変数に使用するバッファーの数を指定します。この例を実行するためには、書き込み可能なフォルダーに移動します。

cdfId = cdflib.create("your_file.cdf");

% Set the format of the file to be multi-file
cdflib.setFormat(cdfId,"MULTI_FILE")

% Create a variable in the file
varNum = cdflib.createVar(cdfId,"Time","cdf_int1",1,[],true,[]);

% Note how the library creates a separate file for the variable
ls your_file.*
your_file.cdf  your_file.z0   
% Determine the number of cache buffers used with the variable
numBuf = cdflib.getVarCacheSize(cdfId,varNum)
numBuf =

     1
% Specify the number of cache buffers used by all variables in CDF
cdflib.setVarsCacheSize(cdfId,6)

% Check the number of cache buffers used with the variable
numBuf = cdflib.getVarCacheSize(cdfId,varNum)
numBuf =

     6
% Clean up
cdflib.delete(cdfId)
clear cdfId

参照

この関数は、CDF ライブラリ C API のルーチン CDFsetzVarsCacheSize に相当します。

この関数を使用するには、CDF C インターフェイスに関する知識を必要とします。CDF のドキュメンテーションは CDF の Web サイトで参照できます。