Main Content

cdflib.setVarSparseRecords

変数によるスパースのレコードの処理方法の指定

構文

cdflib.getVarSparseRecords(cdfId,varNum,stype)

説明

cdflib.getVarSparseRecords(cdfId,varNum,stype) は、CDF (Common Data Format) ファイル内の変数のスパースのレコード タイプを指定します。

入力引数

cdfId

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

varNum

設定する変数を識別する数値。変数番号は 0 ベースです。

stype

変数によるスパース レコードの処理方法を指定する、次の文字ベクトルまたは string スカラーのいずれか、あるいはその等価な数値。

値 説明
'NO_SPARSERECORDS'スパースのレコードなし。
'PAD_SPARSERECORDS'スパースのレコードの場合、ライブラリは、欠落したレコードから値を読み取るときに変数の pad 値を使用します。
'PREV_SPARSERECORDS'スパースのレコードの場合、ライブラリは、欠落したレコードから値を読み取るときに前の既存のレコードの値を使用します。前の既存のレコードが存在しない場合、ライブラリは変数の pad 値を使用します。

これらの値に等価な数値を取得するには、関数 cdflib.getConstantValue を使用します。

例

マルチファイル CDF を開き、変数を閉じます。

CDF を作成し、変数を作成したら、変数のスパースのレコード タイプを設定します。この例を実行するためには、書き込み可能なフォルダーに移動します。

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

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

% Check the sparse records type of the variable
stype = cdflib.getVarSparseRecords(cdfId,varNum)
stype =

    'NO_SPARSERECORDS'
% Set the sparse records type of the variable
cdflib.setVarSparseRecords(cdfId,varNum,"PAD_SPARSERECORDS")

% Check the new sparse records type of the variable
stype = cdflib.getVarSparseRecords(cdfId,varNum)
stype =

    'PAD_SPARSERECORDS'
%Clean up
cdflib.delete(cdfId)
clear cdfId

参照

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

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

参考

|

トピック