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 サイトで参照できます。

参考

cdflib.getVarSparseRecords | cdflib.getConstantValue

トピック

• 低水準関数による CDF ファイルのインポート
• CDF ファイルへのエクスポート