---

STATFIRST

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

戻り値

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

構文

STATFIRST(dimension)

パラメータ

dimension

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

例

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

次の文

DEFINE textvar TEXT
textvar = STATFIRST(month)
SHOW textvar

によって、次の出力が生成されます。

Jun95

これに対し、次の文

DEFINE intvar INTEGER
intvar = STATFIRST(month)
SHOW INTVAR

によって、次の出力が生成されます。

6

例8-108 KEEPが指定されたSTATFIRST

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

LIMIT month KEEP STATFIRST(month) TO onemonth

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