STATFIRST

STATFIRSTファンクションは、ディメンションまたはディメンション・サロゲートの現行のステータス・リストの最初の値、あるいは値セットの最初の値を返します。

戻り値

STATFIRSTが返すデータ型は、ディメンション値またはディメンション・サロゲート値のデータ型、あるいはディメンションのデフォルトのステータス・リストでの位置を示すINTEGERです。STATFIRSTが返すディメンション値は、コンテキストに合せて数値またはテキスト値に変換されます。例8-105「STATFIRST値の別の型の変数への割当て」を参照してください。

構文

STATFIRST(dimension)

引数

dimension: 値がディメンション、ディメンション・サロゲートまたは値セットの名前であるテキスト式。

例

例8-105 STATFIRST値の別の型の変数への割当て

次の文を発行します。

DEFINE textvar TEXT
textvar = STATFIRST(month)
SHOW textvar

生成される出力は次のとおりです。

Jun95

これに対し、次の文を発行します。

DEFINE intvar INTEGER
intvar = STATFIRST(month)
SHOW INTVAR

生成される出力は次のとおりです。

例8-106 KEEPを指定したSTATFIRST

次のプログラムの行は、STATFIRSTを使用して、onemonthという変数に先に格納されている値までのステータスにあるすべての値にmonthを制限します。キーワードKEEPは、新しいステータスが常に古いステータスのサブセットであることを意味します。

LIMIT month KEEP STATFIRST(month) TO onemonth

ここでは、特定のmonthの値ではなくSTATFIRSTが使用されているため、この制限はどのステータス・リストでも機能します。