STATMAX

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

戻り値

STATMAXが返すデータ型は、ディメンション値またはディメンション・サロゲート値のデータ型、あるいはディメンションまたはサロゲートのデフォルトのステータス・リストでの位置を示すINTEGERです。「STATMAXで返されるディメンション値の自動変換」を参照してください。

構文

STATMAX(dimension)

パラメータ

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

使用上の注意

STATMAXで返されるディメンション値の自動変換

STATMAXが返す値は、コンテキストに合せて数値またはテキスト値に変換されます。たとえば、monthのステータスがJun95からDec95に制限されており、Dec95がデフォルトのステータス・リストの12番目だとします。STATMAX(month)の値は、テキスト変数または数値変数に代入できます。

次の文

DEFINE textvar TEXT
textvar = STATMAX(month)
SHOW textvar

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

Dec95

これに対し、次の文

DEFINE intvar INTEGER
intvar = STATMAX(month)
SHOW intvar

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

例

例8-113 タイトルに使用するSTATMAX

次のプログラムの文は、STATMAXを使用して売上総額の上位10か月の中で一番最近の月を判別します。

LIMIT month TO BOTTOM 10 BASEDON TOTAL(sales, month)
SHOW JOINCHARS(STATMAX(month) ' is the latest month -
  of the ten months with the lowest sales.')
SHOW JOINCHARS('the months range from ' STATMIN(month) ' to '-  
  STATMAX(month))

この文によって生成される売上レポートは、次のとおりです。

Dec96 is the latest month of the ten months with the lowest sales.
The months range from Jan95 to Dec96

LIMITコマンドによってmonthの値が時間順ではなく売上の昇順に並べられているため、STATMAXのかわりにSTATLASTを使用した場合は別の値が生成されます。