Main Content

cdflib.getVarReservePercent

変数の圧縮予約準備率

構文

percent = cdflib.getVarReservePercent(cdfId,varNum)

説明

percent = cdflib.getVarReservePercent(cdfId,varNum) は、CDF (Common Data Format) ファイル内の変数の圧縮予約準備率を返します。この操作は圧縮された変数にのみ適用されます。

cdfId は CDF ファイルを識別します。varNum は、変数を識別する数値です。変数番号は 0 ベースです。

例の CDF ファイルを開き、圧縮された変数の番号を取得してから、変数の予約準備率を確認します。

cdfid = cdflib.open('example.cdf');
varnum = cdflib.getVarNum(cdfid,'Temperature');
percent = cdflib.getVarReservePercent(cdfid,varnum);
cdflib.close(cdfid);

詳細

すべて折りたたむ

予約準備率

圧縮された変数に割り当てる追加の領域の量を示します。この追加の領域があると、変数に追加のレコードを書き込むときに変数を拡大できます。拡大用のこの領域を指定しないと、サイズを拡大するときにライブラリは変数をファイルの末尾に移動しなければならず、変数の元の場所の領域が無駄になってしまいます。

既定の設定では、予約準備率は 0 (追加領域の予約なし) です。1100 の任意の割合や、100 より大きい値を指定できます。値は、変数の圧縮されないサイズの割合を示します。

参照

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

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