Main Content

cdflib.setVarBlockingFactor

変数のブロッキング ファクターの指定

構文

cdflib.setVarBlockingFactor(cdfId,varNum,blockingFactor)

説明

cdflib.setVarBlockingFactor(cdfId,varNum,blockingFactor) は、CDF (Common Data Format) ファイル内の変数のブロッキング ファクターを指定します。

入力引数

cdfId

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

varNum

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

blockingFactor

割り当てられていないレコードに書き込むときに割り当てるレコードの数を指定する数値。

CDF を作成し、CDF に変数を作成したら、変数で使用するブロッキング ファクターを設定します。この例を実行するためには、書き込み可能なフォルダーに移動します。

cdfid = cdflib.create('your_file.cdf');

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

% Get the current blocking factor used with the variable 
bFactor = cdflib.getVarBlockingFactor(cdfid,varNum)

bFactor =

    0

% Change the blocking factor for the variable
cdflib.setVarBlockingFactor(cdfid,varNum,10);

% Check the new blocking factor .
bFactor = cdflib.getVarBlockingFactor(cdfid,varNum)

bFactor =

    10

%  Clean up
cdflib.delete(cdfid)

clear cdfid

詳細

すべて折りたたむ

ブロッキング ファクター

変数の "ブロッキング ファクター" は、割り当てられていないレコードに書き込むときにライブラリが割り当てるレコードの最小数を指定します。小数のブロッキング ファクターを指定すると、その値は切り捨てられます。

参照

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

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